共用方式為


Replication Links - Failover

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

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 - 超出可用資源可處理之最大要求的要求。

範例

範例要求

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

範例回覆

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

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細數據。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

複寫連結。

名稱 類型 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