Failover Groups - Create Or Update
フェールオーバー グループを作成または更新します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
failover
|
path | True |
string |
フェールオーバー グループの名前。 |
resource
|
path | True |
string |
リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。 |
server
|
path | True |
string |
フェールオーバー グループを含むサーバーの名前。 |
subscription
|
path | True |
string |
Azure サブスクリプションを識別するサブスクリプション ID。 |
api-version
|
query | True |
string |
要求で使用する API のバージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
properties.partnerServers | True |
フェールオーバー グループのパートナー サーバー情報の一覧。 |
|
properties.readWriteEndpoint | True |
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。 |
|
properties.databases |
string[] |
フェールオーバー グループ内のデータベースの一覧。 |
|
properties.readOnlyEndpoint |
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。 |
||
tags |
object |
リソース タグ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
フェールオーバー グループが正常に更新されました。 |
|
201 Created |
フェールオーバー グループが正常に作成されました。 |
|
202 Accepted |
同意 |
|
Other Status Codes |
エラー応答: ***
|
例
Create failover group
要求のサンプル
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2021-11-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
応答のサンプル
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
定義
名前 | 説明 |
---|---|
Failover |
フェールオーバー グループ。 |
Failover |
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。 |
Failover |
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。 |
Failover |
フェールオーバー グループ インスタンスのローカル レプリケーション ロール。 |
Partner |
フェールオーバー グループのパートナー サーバー情報。 |
Read |
フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。 |
Read |
フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 failoverPolicy が [自動] の場合は、failoverWithDataLossGracePeriodMinutes が必要です。 |
FailoverGroup
フェールオーバー グループ。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの ID |
location |
string |
リソースの場所。 |
name |
string |
リソース名。 |
properties.databases |
string[] |
フェールオーバー グループ内のデータベースの一覧。 |
properties.partnerServers |
フェールオーバー グループのパートナー サーバー情報の一覧。 |
|
properties.readOnlyEndpoint |
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。 |
|
properties.readWriteEndpoint |
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。 |
|
properties.replicationRole |
フェールオーバー グループ インスタンスのローカル レプリケーション ロール。 |
|
properties.replicationState |
string |
フェールオーバー グループ インスタンスのレプリケーション状態。 |
tags |
object |
リソース タグ。 |
type |
string |
リソースの種類。 |
FailoverGroupReadOnlyEndpoint
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。
名前 | 型 | 説明 |
---|---|---|
failoverPolicy |
フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。 |
FailoverGroupReadWriteEndpoint
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。
名前 | 型 | 説明 |
---|---|---|
failoverPolicy |
フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 failoverPolicy が [自動] の場合は、failoverWithDataLossGracePeriodMinutes が必要です。 |
|
failoverWithDataLossGracePeriodMinutes |
integer |
データ損失によるフェールオーバー前の猶予期間は、読み取り/書き込みエンドポイントに対して試行されます。 failoverPolicy が [自動] の場合は、failoverWithDataLossGracePeriodMinutes が必要です。 |
FailoverGroupReplicationRole
フェールオーバー グループ インスタンスのローカル レプリケーション ロール。
名前 | 型 | 説明 |
---|---|---|
Primary |
string |
|
Secondary |
string |
PartnerInfo
フェールオーバー グループのパートナー サーバー情報。
名前 | 型 | 説明 |
---|---|---|
id |
string |
パートナー サーバーのリソース識別子。 |
location |
string |
パートナー サーバーの地理的な場所。 |
replicationRole |
パートナー サーバーのレプリケーション ロール。 |
ReadOnlyEndpointFailoverPolicy
フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。
名前 | 型 | 説明 |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ReadWriteEndpointFailoverPolicy
フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 failoverPolicy が [自動] の場合は、failoverWithDataLossGracePeriodMinutes が必要です。
名前 | 型 | 説明 |
---|---|---|
Automatic |
string |
|
Manual |
string |