Replication Links - Failover

Service:

SQL Database

API Version:

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 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	資料庫的名稱。
linkId	path	True	string	複寫連結的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。

回應

名稱	類型	Description
200 OK	ReplicationLink	已成功故障轉移。
202 Accepted		故障轉移作業正在進行中。
Other Status Codes		錯誤回應： ≦ 400 ReplicationLinksReplicationLinkNameIsInvalid - 複寫連結名稱應該是有效的 guid。 400 GeoReplicationDatabaseNotSecondary - 作業預期資料庫為複寫目標。 400 LedgerNoDropLink - 無法停止異地復寫，因為資料庫已啟用總賬摘要上傳。 停用總帳摘要上傳，然後重試作業。 400 CannotUseTrailingWhitespacesInDatabaseName - 資料庫名稱驗證失敗。 400 GeoReplicationDatabaseNotSecondary - 作業預期資料庫為複寫目標。 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。 400 InvalidServerName - 指定的伺服器名稱無效。 400 PlannerFailoverTimedOut - 使用者叫用 容錯移轉，並在嘗試連絡合作夥伴管理服務時逾時。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 400 IncorrectReplicationLinkState - 作業預期資料庫在復寫連結上處於預期狀態。 404 OperationIdNotFound - 標識符為的作業不存在。 404 ResourceNotFound - 找不到所要求的資源。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 OperationIdNotFound - 標識符為的作業不存在。 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 - 超出可用資源可處理之最大要求的要求。

範例

Planned failover of a replication link

Sample Request

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

import com.azure.core.util.Context;

/** 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", 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

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

Status code:

202

定義

名稱	Description
ReplicationLink	複寫連結。
ReplicationLinkType	鏈接類型 (GEO、NAMED、STANDBY) 。
ReplicationRole	本機複寫角色。
ReplicationState	復寫狀態 (PENDING、SEEDING、CATCHUP、SUSPENDED) 。

ReplicationLink

複寫連結。

名稱	類型	Description
id	string	資源識別碼。
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	復寫狀態 (PENDING、SEEDING、CATCHUP、SUSPENDED) 。
properties.role	ReplicationRole	本機複寫角色。
properties.startTime	string	建立連結的時間。
type	string	資源類型。

ReplicationLinkType

鏈接類型 (GEO、NAMED、STANDBY) 。

名稱	類型	Description
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

本機複寫角色。

名稱	類型	Description
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

復寫狀態 (PENDING、SEEDING、CATCHUP、SUSPENDED) 。

名稱	類型	Description
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string