次の方法で共有

Databases - Failover

  • リファレンス
サービス:
SQL Database
API バージョン:
2023-08-01

データベースをフェールオーバーします。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
省略可能なパラメーターを含む: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01

URI パラメーター

名前 / 必須 型 説明
databaseName
 path True

string

フェールオーバーするデータベースの名前。
resourceGroupName
 path True

string

リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。
serverName
 path True

string

サーバーの名前。
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 DatabaseFailoverNotSupportedOnSKU - この種類の顧客が開始したフェールオーバーは、特定の SKU ではサポートされていません。

  • 400 DatabaseFailoverThrottled - データベースがエラスティック プールに属している場合、データベースまたはプールで最近フェールオーバーが発生しました。

  • 400 ManagementServiceFeatureDisabled - ユーザーが無効になっている機能を使用しようとしました。

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

  • 409 DatabaseNotInStateToFailover - データベースは現在、フェールオーバーを発行できない状態です。

  • 409 ManagementServiceDatabaseBusy - データベース '{0}' は別の操作でビジー状態です。 後で操作を試してください。

  • 409 CannotCancelOperation - 管理操作が取り消すことができない状態です。

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

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

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

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

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

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

例

Failover an database

要求のサンプル

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

応答のサンプル

状態コード:
200
状態コード:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

定義

名前 説明
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