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

Managed Instances - Failover

故障转移托管实例。

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

示例

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

示例响应

定义

ReplicaType

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

名称 类型 说明
Primary

string

ReadableSecondary

string