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

Managed Instances - Failover

参考

服务:: SQL Database

API 版本:: 2021-11-01

故障转移托管实例。

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

具有可选参数:

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

URI 参数

名称	在	必需	类型	说明
managedInstanceName	path	True	string	要故障转移的托管实例的名称。
resourceGroupName	path	True	string	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。
replicaType	query		ReplicaType	要故障转移的副本 (replica) 的类型。

响应

名称	类型	说明
200 OK		成功完成托管实例故障转移。
202 Accepted		托管实例故障转移正在进行中。
Other Status Codes		错误响应：*** 400 ManagedInstanceFailoverThrottled - 托管实例上最近进行了故障转移。 400 ManagedInstanceFailoverNotSupportedOnSKU - 给定 SKU 不支持这种类型的客户发起的故障转移。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 OperationIdNotFound - ID 为的操作不存在。 409 ManagedInstanceFailoverFullBackupMissing - 自动备份需要为新数据库完成第一个完整备份。 409 ManagedInstanceNotInStateToFailover - 托管实例当前处于无法发出故障转移的状态。 409 OperationCancelled - 用户已取消操作。 409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。 429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。 500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。 503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。

名称

类型

说明

200 OK

成功完成托管实例故障转移。

202 Accepted

托管实例故障转移正在进行中。

Other Status Codes

错误响应：***

400 ManagedInstanceFailoverThrottled - 托管实例上最近进行了故障转移。
400 ManagedInstanceFailoverNotSupportedOnSKU - 给定 SKU 不支持这种类型的客户发起的故障转移。
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。
404 OperationIdNotFound - ID 为的操作不存在。
409 ManagedInstanceFailoverFullBackupMissing - 自动备份需要为新数据库完成第一个完整备份。
409 ManagedInstanceNotInStateToFailover - 托管实例当前处于无法发出故障转移的状态。
409 OperationCancelled - 用户已取消操作。
409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。
429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。
500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。
503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。

示例

Failover a managed instance.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2021-11-01


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

/**
 * Samples for ManagedInstances Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverManagedInstance.json
     */
    /**
     * Sample code: Failover a managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().failover("group1", "instanceName",
            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

通过