Databases - Failover

サービス:

SQL Database

API バージョン:

2021-11-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2021-11-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2021-11-01

URI パラメーター

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

応答

名前	型	説明
200 OK		データベース のフェールオーバーが正常に完了しました。
202 Accepted		データベースのフェールオーバーが進行中です。
Other Status Codes		エラー応答: *** 400 ManagementServiceFeatureDisabled - ユーザーが無効になっている機能を使用しようとしました。 400 DatabaseFailoverThrottled - データベースがエラスティック プールに属している場合、データベースまたはプールで最近フェールオーバーが発生しました。 400 DatabaseFailoverNotSupportedOnSKU - この種類の顧客が開始したフェールオーバーは、特定の SKU ではサポートされていません。 409 ManagementServiceDatabaseBusy - データベース '{0}' は別の操作でビジー状態です。 後で操作を試してください。 409 DatabaseNotInStateToFailover - データベースは現在、フェールオーバーを発行できない状態です。

例

Failover an database

要求のサンプル

HTTP

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=2021-11-01

Java

import com.azure.resourcemanager.sql.models.ReplicaType;

/**
 * Samples for Databases Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverDatabase.json
     */
    /**
     * Sample code: Failover an database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAnDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().failover("group1", "testServer", "testDatabase",
            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