Managed Instances - Failover

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

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

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 - 使用可能なリソースで処理できる最大要求を超える要求。

名前

型

説明

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

応答のサンプル

状態コード:: 200

状態コード:: 202

定義

ReplicaType

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

名前	型	説明
Primary	string
ReadableSecondary	string

次の方法で共有