Failover Groups - Failover
現在のプライマリ サーバーからこのサーバーにフェールオーバーします。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/failover?api-version=2023-08-01
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
failover
|
path | True |
string |
フェールオーバー グループの名前。 |
|
resource
|
path | True |
string |
リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。 |
|
server
|
path | True |
string |
フェールオーバー グループを含むサーバーの名前。 |
|
subscription
|
path | True |
string |
Azure サブスクリプションを識別するサブスクリプション ID。 |
|
api-version
|
query | True |
string |
要求に使用する API バージョン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
正常にフェールオーバーされました。 |
|
| 202 Accepted |
受け入れ られる ヘッダー Location: string |
|
| Other Status Codes |
エラー応答: ***
|
例
Planned failover of a failover group
要求のサンプル
応答のサンプル
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"___location": "Japan West",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 120
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server",
"___location": "Japan East",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-2"
]
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japanwest/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
定義
| 名前 | 説明 |
|---|---|
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Failover |
フェールオーバー グループ。 |
|
Failover |
パートナー サーバー上のデータベースのセカンダリの種類。 |
|
Failover |
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。 |
|
Failover |
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。 |
|
Failover |
フェールオーバー グループ インスタンスのローカル レプリケーション ロール。 |
|
Partner |
フェールオーバー グループのパートナー サーバー情報。 |
|
Read |
フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。 |
|
Read |
フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
FailoverGroup
フェールオーバー グループ。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string |
リソース ID。 |
| ___location |
string |
リソースの場所。 |
| name |
string |
リソース名。 |
| properties.databases |
string[] (arm-id) |
フェールオーバー グループ内のデータベースの一覧。 |
| properties.partnerServers |
フェールオーバー グループのパートナー サーバー情報の一覧。 |
|
| properties.readOnlyEndpoint |
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。 |
|
| properties.readWriteEndpoint |
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。 |
|
| properties.replicationRole |
フェールオーバー グループ インスタンスのローカル レプリケーション ロール。 |
|
| properties.replicationState |
string |
フェールオーバー グループ インスタンスのレプリケーション状態。 |
| properties.secondaryType |
パートナー サーバー上のデータベースのセカンダリの種類。 |
|
| tags |
object |
リソース タグ。 |
| type |
string |
リソースの種類。 |
FailoverGroupDatabasesSecondaryType
パートナー サーバー上のデータベースのセカンダリの種類。
| 値 | 説明 |
|---|---|
| Geo | |
| Standby |
FailoverGroupReadOnlyEndpoint
フェールオーバー グループ インスタンスの読み取り専用エンドポイント。
| 名前 | 型 | 説明 |
|---|---|---|
| failoverPolicy |
フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。 |
|
| targetServer |
string (arm-id) |
読み取り専用エンドポイントが指すターゲット パートナー サーバー。 |
FailoverGroupReadWriteEndpoint
フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。
| 名前 | 型 | 説明 |
|---|---|---|
| failoverPolicy |
フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。 |
|
| failoverWithDataLossGracePeriodMinutes |
integer (int32) |
読み取り/書き込みエンドポイントに対して、データ損失によるフェールオーバー前の猶予期間が試行されます。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。 |
FailoverGroupReplicationRole
フェールオーバー グループ インスタンスのローカル レプリケーション ロール。
| 値 | 説明 |
|---|---|
| Primary | |
| Secondary |
PartnerInfo
フェールオーバー グループのパートナー サーバー情報。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (arm-id) |
パートナー サーバーのリソース識別子。 |
| ___location |
string |
パートナー サーバーの地理的な場所。 |
| replicationRole |
パートナー サーバーのレプリケーション ロール。 |
ReadOnlyEndpointFailoverPolicy
フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。
| 値 | 説明 |
|---|---|
| Disabled | |
| Enabled |
ReadWriteEndpointFailoverPolicy
フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。
| 値 | 説明 |
|---|---|
| Manual | |
| Automatic |