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

Replication Links - Failover

把故障从当前的主服务器转移到该服务器。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2021-11-01

URI 参数

Name In Required Type Description
databaseName
path True
  • string

数据库的名称。

linkId
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 版本。

响应

Name Type Description
200 OK

已成功故障转移。

202 Accepted

正在执行故障转移操作。

Other Status Codes

错误响应: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid - 复制链接名称应为有效的 guid。

  • 400 GeoReplicationDatabaseNotSecondary - 该操作要求数据库是复制目标。

  • 400 LedgerNoDropLink - 无法停止异地复制,因为数据库启用了账本摘要上传。 禁用账本摘要上传并重试操作。

  • 400 CannotUseTrailingWhitespacesInDatabaseName - 数据库名称验证失败。

  • 400 GeoReplicationDatabaseNotSecondary - 该操作要求数据库是复制目标。

  • 400 CannotUseReservedDatabaseName - 不能在此操作中使用保留的数据库名称。

  • 400 InvalidServerName - 指定的服务器名称无效。

  • 400 PlannedFailoverTimedOut - 用户调用了计划的故障转移,在尝试联系合作伙伴管理服务时超时。

  • 400 InvalidIdentifier - 标识符包含 NULL 或无效 unicode 字符。

  • 400 错误ReplicationLinkState - 该操作要求数据库在复制链接上处于预期状态。

  • 404 OperationIdNotFound - ID 操作不存在。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。

  • 404 OperationIdNotFound - ID 操作不存在。

  • 404 DatabaseDoesNotExist - 用户已指定此服务器实例上不存在的数据库名称。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定操作。

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - 用户尝试故障转移或强制终止异地链接,而辅助副本处于物理上不一致的状态,因此无法进入主要角色。

  • 409 DuplicateGeoDrRelation - 数据库已处于复制关系中。 这是重复的请求。

  • 409 UpdateSloInProgress - 用户在进行 SLO 更新时尝试启动不兼容的操作。

  • 409 ManagementServiceDatabaseBusy - 数据库“”{0}正忙于另一个操作。 请稍后尝试你的操作。

  • 409 ConflictingSystemOperationInProgress - 数据库上正在进行系统维护操作,后续操作需要等待,直到完成。

  • 409 FailoverGroupAlreadySetup - 无法执行该操作,因为异地复制链接是故障转移组的一部分。 必须从组中删除数据库才能单独终止或故障转移。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 503 TooManyRequests - 请求超出可用资源可处理的最大请求数。

示例

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2021-11-01

Sample Response

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}

定义

ReplicationLink

复制链接。

ReplicationLinkType

链接类型 (GEO、NAMED、STANDBY) 。

ReplicationRole

本地复制角色。

ReplicationState

复制状态 (挂起、种子设定、CATCHUP、挂起) 。

复制链接。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.isTerminationAllowed
  • boolean

用户当前是否允许终止链接。

properties.linkType

链接类型 (GEO、NAMED、STANDBY) 。

properties.partnerDatabase
  • string

资源伙伴数据库。

properties.partnerLocation
  • string

资源合作伙伴位置。

properties.partnerRole

合作伙伴复制角色。

properties.partnerServer
  • string

资源合作伙伴服务器。

properties.percentComplete
  • integer

链接的种子设定完成百分比。

properties.replicationMode
  • string

复制模式。

properties.replicationState

复制状态 (挂起、种子设定、CATCHUP、挂起) 。

properties.role

本地复制角色。

properties.startTime
  • string

创建链接的时间。

type
  • string

资源类型。

ReplicationLinkType

链接类型 (GEO、NAMED、STANDBY) 。

Name Type Description
GEO
  • string
NAMED
  • string
STANDBY
  • string

ReplicationRole

本地复制角色。

Name Type Description
Copy
  • string
NonReadableSecondary
  • string
Primary
  • string
Secondary
  • string
Source
  • string

ReplicationState

复制状态 (挂起、种子设定、CATCHUP、挂起) 。

Name Type Description
CATCH_UP
  • string
PENDING
  • string
SEEDING
  • string
SUSPENDED
  • string