Managed Instances - Failover

  • リファレンス
Service:
SQL Database
API Version:
2021-11-01

マネージド インスタンスをフェールオーバーします。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
With optional parameters: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01

URI パラメーター

名前 / 必須 型 説明
managedInstanceName
 path True

string

フェールオーバーするマネージド インスタンスの名前。
resourceGroupName
 path True

string

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。
subscriptionId
 path True

string

Azure サブスクリプションを識別するサブスクリプション ID。
api-version
 query True

string

要求で使用する API のバージョン。
replicaType
 query

ReplicaType

フェールオーバーするレプリカの種類。

応答

名前 型 説明
200 OK

マネージド インスタンスのフェールオーバーが正常に完了しました。
202 Accepted

マネージド インスタンスのフェールオーバーが進行中です。
Other Status Codes

エラー応答: ***

  • 400 ManagedInstanceFailoverThrottled - マネージド インスタンスで最近フェールオーバーが発生しました。

  • 400 ManagedInstanceFailoverNotSupportedOnSKU - この種類の顧客が開始したフェールオーバーは、特定の SKU ではサポートされていません。

  • 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした

  • 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

  • 404 OperationIdNotFound - Id を持つ操作が存在しません。

  • 409 ManagedInstanceFailoverFullBackupMissing - 自動バックアップでは、新しいデータベースの最初の完全バックアップを完了する必要があります。

  • 409 ManagedInstanceNotInStateToFailover - マネージド インスタンスは現在、フェールオーバーを発行できない状態です。

  • 409 OperationCancelled - 操作がユーザーによって取り消されました。

  • 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。

  • 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。

  • 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

  • 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。 操作をやり直してください。

  • 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

例

Failover a managed instance.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2021-11-01

Sample Response

Status code:
200
Status code:
202

定義

ReplicaType

フェールオーバーするレプリカの種類。

名前 型 説明
Primary

string

ReadableSecondary

string