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

Managed Instances - Failover

Service:

SQL Database

API Version:

2021-11-01

故障转移托管实例。

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

With optional parameters:

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 - 请求数超出可用资源可以处理的最大请求数。

示例

Failover a managed instance.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
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, 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

Sample Response

Status code:

200

Status code:

202

定义

ReplicaType

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

名称	类型	说明
Primary	string
ReadableSecondary	string