Databases - Failover

  • 參考
Service:
SQL Database
API Version:
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
With optional parameters: 
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

Sample Request

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

Sample Response

Status code:
200
Status code:
202

定義

ReplicaType

要故障轉移的複本類型。

名稱 類型 Description
Primary

string

ReadableSecondary

string