Replication Links - Failover

參考

服務:: SQL Database

API 版本:: 2023-08-01

從目前的主伺服器故障轉移至此伺服器。

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

URI 參數

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

回應

名稱	類型	Description
200 OK	ReplicationLink	已成功故障轉移。
202 Accepted		故障轉移作業正在進行中。標題 Location: string
Other Status Codes	ErrorResponse	錯誤回應： *** 400 ReplicationLinksReplicationLinkNameIsInvalid - 複寫連結名稱應該是有效的 guid。 400 GeoReplicationDatabaseNotSecondary - 此作業預期資料庫必須是復寫目標。 400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType 無效。有效值為 STANDBY 和 GEO。 400 ReplicationLinksCreateIsNotSupported - 不支援建立復寫連結。 400 LedgerNoDropLink - 無法停止異地復寫，因為資料庫已啟用總賬摘要上傳。停用總帳摘要上傳，然後重試作業。 400 InvalidServerName - 指定的伺服器名稱無效。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 400 TokenTooLong - 提供的令牌太長。 400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業 400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業 400 InvalidServerName - 指定的伺服器名稱無效。 400 GeoReplicationDatabaseNotSecondary - 此作業預期資料庫必須是復寫目標。 400 CannotUseTrailingWhitespacesInDatabaseName - 資料庫名稱驗證失敗。 400 IncorrectReplicationLinkState - 作業預期資料庫在復寫連結上處於預期狀態。 400 PlannedFailoverTimedOut - 使用者叫用計劃性故障轉移，嘗試連絡合作夥伴管理服務時逾時。 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - 不支援使用 preferredEnclaveType 属性的不同值設定異地復寫的資料庫。 '{1}' 伺服器上的主要 '{0}' 資料庫會使用 '{2}' preferredEnclaveType，而 '{4}' 伺服器上次要 '{3}' 資料庫的指定 preferredEnclaveType 是 '{5}'。 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - 虛擬式安全性（VBS）記憶體保護區不支援主要和輔助資料庫之間的計劃性故障轉移。 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 404 OperationIdNotFound - 標識符為的作業不存在。 404 ResourceNotFound - 找不到要求的資源。 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 OperationIdNotFound - 標識符為的作業不存在。 404 DatabaseDoesNotExist - 使用者已指定此伺服器實例上不存在的資料庫名稱。 409 CannotCancelOperation - 管理作業處於無法取消的狀態。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。 409 UpdateSloInProgress - 用戶嘗試在 SLO 更新進行時起始不相容的作業。 409 InvalidOperationForDatabaseNotInReplicationRelationship - 在不在復寫關聯性的資料庫中執行複寫作業。 409 ConflictingSystemOperationInProgress - 資料庫上的系統維護作業正在進行中，而進一步的作業必須等到它完成為止。 409 DuplicateGeoDrRelation - 資料庫已經在復寫關聯中。這是重複的要求。 409 GeoReplicationCannotBecomePrimaryDuringUndo - 使用者嘗試故障轉移或強制終止異地連結，而次要複本處於實體不一致的狀態，因此無法進入主要角色。 409 ManagementServiceDatabaseBusy - 資料庫 '{0}' 正忙於另一個作業。請稍後試用您的作業。 409 FailoverGroupAlreadySetup - 無法執行作業，因為異地復寫連結是故障轉移群組的一部分。您必須從群組中移除資料庫，才能個別終止或故障轉移。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 500 OperationTimedOut - 作業逾時並自動回復。請重試作業。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

名稱

類型

Description

200 OK

ReplicationLink

已成功故障轉移。

202 Accepted

故障轉移作業正在進行中。

標題

Location: string

Other Status Codes

ErrorResponse

錯誤回應： ***

400 ReplicationLinksReplicationLinkNameIsInvalid - 複寫連結名稱應該是有效的 guid。
400 GeoReplicationDatabaseNotSecondary - 此作業預期資料庫必須是復寫目標。
400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType 無效。有效值為 STANDBY 和 GEO。
400 ReplicationLinksCreateIsNotSupported - 不支援建立復寫連結。
400 LedgerNoDropLink - 無法停止異地復寫，因為資料庫已啟用總賬摘要上傳。停用總帳摘要上傳，然後重試作業。
400 InvalidServerName - 指定的伺服器名稱無效。
400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。
400 TokenTooLong - 提供的令牌太長。
400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業
400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業
400 InvalidServerName - 指定的伺服器名稱無效。
400 GeoReplicationDatabaseNotSecondary - 此作業預期資料庫必須是復寫目標。
400 CannotUseTrailingWhitespacesInDatabaseName - 資料庫名稱驗證失敗。
400 IncorrectReplicationLinkState - 作業預期資料庫在復寫連結上處於預期狀態。
400 PlannedFailoverTimedOut - 使用者叫用計劃性故障轉移，嘗試連絡合作夥伴管理服務時逾時。
400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - 不支援使用 preferredEnclaveType 属性的不同值設定異地復寫的資料庫。 '{1}' 伺服器上的主要 '{0}' 資料庫會使用 '{2}' preferredEnclaveType，而 '{4}' 伺服器上次要 '{3}' 資料庫的指定 preferredEnclaveType 是 '{5}'。
400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - 虛擬式安全性（VBS）記憶體保護區不支援主要和輔助資料庫之間的計劃性故障轉移。
400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。
400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。
404 OperationIdNotFound - 標識符為的作業不存在。
404 ResourceNotFound - 找不到要求的資源。
404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。
404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器
404 OperationIdNotFound - 標識符為的作業不存在。
404 DatabaseDoesNotExist - 使用者已指定此伺服器實例上不存在的資料庫名稱。
409 CannotCancelOperation - 管理作業處於無法取消的狀態。
409 OperationCancelled - 使用者已取消作業。
409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。
409 UpdateSloInProgress - 用戶嘗試在 SLO 更新進行時起始不相容的作業。
409 InvalidOperationForDatabaseNotInReplicationRelationship - 在不在復寫關聯性的資料庫中執行複寫作業。
409 ConflictingSystemOperationInProgress - 資料庫上的系統維護作業正在進行中，而進一步的作業必須等到它完成為止。
409 DuplicateGeoDrRelation - 資料庫已經在復寫關聯中。這是重複的要求。
409 GeoReplicationCannotBecomePrimaryDuringUndo - 使用者嘗試故障轉移或強制終止異地連結，而次要複本處於實體不一致的狀態，因此無法進入主要角色。
409 ManagementServiceDatabaseBusy - 資料庫 '{0}' 正忙於另一個作業。請稍後試用您的作業。
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=2023-08-01

範例回覆

狀態碼:: 200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/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

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/replicationLinksOperationResults/replicationlink-group-test-3?api-version=2022-05-01-preview

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ReplicationLink	複寫連結。
ReplicationLinkType	連結類型（GEO、NAMED、STANDBY）。更新作業不支援 NAMED。
ReplicationRole	本機複寫角色。
ReplicationState	復寫狀態（PENDING、SEEDING、CATCHUP、SUSPENDED）。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ReplicationLink

Object

複寫連結。

名稱	類型	Description
id	string	資源標識碼。
name	string	資源名稱。
properties.isTerminationAllowed	boolean	使用者目前是否允許終止連結。
properties.linkType	ReplicationLinkType	連結類型（GEO、NAMED、STANDBY）。更新作業不支援 NAMED。
properties.partnerDatabase	string	資源夥伴資料庫。
properties.partnerDatabaseId	string	資源夥伴資料庫標識碼。
properties.partnerLocation	string	資源夥伴位置。
properties.partnerRole	ReplicationRole	合作夥伴複寫角色。
properties.partnerServer	string	資源夥伴伺服器。
properties.percentComplete	integer (int32)	為連結植入完成百分比。
properties.replicationMode	string	複寫模式。
properties.replicationState	ReplicationState	復寫狀態（PENDING、SEEDING、CATCHUP、SUSPENDED）。
properties.role	ReplicationRole	本機複寫角色。
properties.startTime	string (date-time)	建立連結的時間。
type	string	資源類型。

ReplicationLinkType

列舉型別

連結類型（GEO、NAMED、STANDBY）。更新作業不支援 NAMED。

值	Description
GEO
NAMED
STANDBY

ReplicationRole

列舉型別

本機複寫角色。

值	Description
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

列舉型別

復寫狀態（PENDING、SEEDING、CATCHUP、SUSPENDED）。

值	Description
CATCH_UP
PENDING
SEEDING
SUSPENDED

共用方式為

Replication Links - Failover

URI 參數

回應

範例

Planned failover of a replication link

範例要求

範例回覆

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

其他資源