マネージド インスタンスをフェールオーバーします。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
省略可能なパラメーターを含む:
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.
要求のサンプル
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
import com.azure.resourcemanager.sql.models.ReplicaType;
/**
* Samples for ManagedInstances Failover.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverManagedInstance.json
*/
/**
* Sample code: Failover a managed instance.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void failoverAManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
azure.sqlServers().manager().serviceClient().getManagedInstances().failover("group1", "instanceName",
ReplicaType.PRIMARY, com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
定義
ReplicaType
フェールオーバーするレプリカの種類。
| 名前 |
型 |
説明 |
|
Primary
|
string
|
|
|
ReadableSecondary
|
string
|
|