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

Replication Links - Failover

服务:

SQL Database

API 版本:

2021-11-01

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

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 参数

名称	在	必需	类型	说明
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 版本。

响应

名称	类型	说明
200 OK	ReplicationLink	已成功故障转移。
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 IncorrectReplicationLinkState - 操作要求数据库在复制链接上处于预期状态。 404 OperationIdNotFound - ID 为 的操作不存在。 404 ResourceNotFound - 找不到请求的资源。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 OperationIdNotFound - ID 为 的操作不存在。 404 DatabaseDoesNotExist - 用户已指定此服务器实例上不存在的数据库名称。 409 OperationCancelled - 用户已取消操作。 409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。 409 InvalidOperationForDatabaseNotInReplicationRelationship - 对已处于复制关系中的数据库执行了复制种子设定操作。 409 GeoReplicationCannotBecomePrimaryDuringUndo - 用户尝试故障转移或强制终止异地链接，而辅助数据库处于物理上不一致的状态，因此无法进入主要角色。 409 DuplicateGeoDrRelation - 数据库已处于复制关系中。 这是重复的请求。 409 UpdateSloInProgress - 用户在 SLO 更新正在进行时尝试启动不兼容的操作。 409 ManagementServiceDatabaseBusy - 数据库“”{0}正忙于另一个操作。 请稍后尝试操作。 409 ConflictingSystemOperationInProgress - 数据库上的系统维护操作正在进行中，后续操作需要等待完成。 409 FailoverGroupAlreadySetup - 无法执行操作，因为异地复制链接是故障转移组的一部分。 必须从组中删除数据库才能单独终止或故障转移。 429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。 503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。

示例

Planned failover of a replication link

示例请求

HTTP

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

Java

/**
 * Samples for ReplicationLinks Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailover.json
     */
    /**
     * Sample code: Planned failover of a replication link.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failover("Default", "sourcesvr", "gamma-db",
            "4891ca10-ebd0-47d7-9182-c722651780fb", 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

{
  "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"
}

状态代码:

202

定义

名称	说明
ReplicationLink	复制链接。
ReplicationLinkType	链接类型 (GEO、NAMED、STANDBY) 。
ReplicationRole	本地复制角色。
ReplicationState	复制状态 (挂起、种子设定、捕获、挂起) 。

ReplicationLink

复制链接。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.isTerminationAllowed	boolean	当前是否允许用户终止链接。
properties.linkType	ReplicationLinkType	链接类型 (GEO、NAMED、STANDBY) 。
properties.partnerDatabase	string	资源伙伴数据库。
properties.partnerLocation	string	资源伙伴位置。
properties.partnerRole	ReplicationRole	合作伙伴复制角色。
properties.partnerServer	string	资源伙伴服务器。
properties.percentComplete	integer	链接的种子设定完成百分比。
properties.replicationMode	string	复制模式。
properties.replicationState	ReplicationState	复制状态 (挂起、种子设定、捕获、挂起) 。
properties.role	ReplicationRole	本地复制角色。
properties.startTime	string	创建链接的时间。
type	string	资源类型。

ReplicationLinkType

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

名称	类型	说明
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

本地复制角色。

名称	类型	说明
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

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

名称	类型	说明
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string