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

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	要故障转移的副本 (replica) 的类型。

响应

名称	类型	说明
200 OK		成功完成数据库故障转移。
202 Accepted		数据库故障转移正在进行中。
Other Status Codes		错误响应：*** 400 ManagementServiceFeatureDisabled - 用户尝试使用禁用的功能。 400 DatabaseFailoverThrottled - 如果数据库属于弹性池，则数据库或池最近进行了故障转移。 400 DatabaseFailoverNotSupportedOnSKU - 给定 SKU 不支持这种类型的客户发起的故障转移。 409 ManagementServiceDatabaseBusy - 数据库“”{0}正忙于另一个操作。请稍后尝试操作。 409 DatabaseNotInStateToFailover - 数据库当前处于无法发出故障转移的状态。

名称

类型

说明

200 OK

成功完成数据库故障转移。

202 Accepted

数据库故障转移正在进行中。

Other Status Codes

错误响应：***

400 ManagementServiceFeatureDisabled - 用户尝试使用禁用的功能。
400 DatabaseFailoverThrottled - 如果数据库属于弹性池，则数据库或池最近进行了故障转移。
400 DatabaseFailoverNotSupportedOnSKU - 给定 SKU 不支持这种类型的客户发起的故障转移。
409 ManagementServiceDatabaseBusy - 数据库“”{0}正忙于另一个操作。请稍后尝试操作。
409 DatabaseNotInStateToFailover - 数据库当前处于无法发出故障转移的状态。

示例

Failover an database

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


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

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

名称	类型	说明
Primary	string
ReadableSecondary	string

通过