Managed Instances - Failover

サービス:

SQL Database

API バージョン:

2023-08-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2023-08-01

省略可能なパラメーターを含む:

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

URI パラメーター

名前	/	必須	型	説明
managedInstanceName	path	True	string	フェールオーバーするマネージド インスタンスの名前。
resourceGroupName	path	True	string	リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求に使用する API バージョン。
replicaType	query		ReplicaType	フェールオーバーするレプリカの種類。

応答

名前	型	説明
200 OK		マネージド インスタンスのフェールオーバーが正常に完了しました。
202 Accepted		マネージド インスタンスのフェールオーバーが進行中です。 ヘッダー Location: string
Other Status Codes	ErrorResponse	エラー応答: *** 400 ManagedInstanceFailoverNotSupportedOnSKU - この種類の顧客が開始したフェールオーバーは、特定の SKU ではサポートされていません。 400 ManagedInstanceFailoverThrottled - マネージド インスタンスで最近のフェールオーバーが発生しました。 400 ManagedInstanceStoppingOrStopped - インスタンスが停止/停止状態にある間に送信された操作の競合 400 ManagedInstanceStarting - インスタンスが開始状態の間に送信された操作の競合 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 OperationIdNotFound - Id を持つ操作が存在しません。 409 ManagedInstanceFailoverFullBackupMissing - 自動バックアップでは、新しいデータベースの最初の完全バックアップを完了する必要があります。 409 ManagedInstanceNotInStateToFailover - マネージド インスタンスは現在、フェールオーバーを発行できない状態です。 409 CannotCancelOperation - 管理操作が取り消すことができない状態です。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。 操作を再試行してください。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

例

Failover a managed instance.

要求のサンプル

HTTP

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

応答のサンプル

状態コード:

200

状態コード:

202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/managedInstanceOperationResults/00000000-1111-2222-3333-444444444444?api-version=2019-06-01-preview

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ReplicaType	フェールオーバーするレプリカの種類。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラー メッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラー オブジェクト。

ReplicaType

列挙

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

値	説明
Primary
ReadableSecondary