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 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	要故障轉移的資料庫名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。
replicaType	query		ReplicaType	要故障轉移的複本類型。

回應

名稱	類型	Description
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

Enumeration

要故障轉移的複本類型。

值	Description
Primary
ReadableSecondary