你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 参数

名称 在 必需 类型 说明
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

要故障转移的副本 (replica) 的类型。

响应

名称 类型 说明
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

要故障转移的副本 (replica) 的类型。

名称 类型 说明
Primary

string

ReadableSecondary

string