Replication Links - Update

參考

Service:: SQL Database

API Version:: 2023-08-01-preview

匯報復寫連結類型。

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

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
properties.linkType	ReplicationLinkType	鏈接類型 (GEO、NAMED、STANDBY) 。更新作業不支援 NAMED。

回應

名稱	類型	Description
200 OK	ReplicationLink	已成功更新復寫連結。
202 Accepted		更新作業正在進行中。
Other Status Codes	ErrorResponse	錯誤回應： ≦ 400 ReplicationLinksReplicationLinkNameIsInvalid - 複寫連結名稱應該是有效的 guid。 400 GeoReplicationDatabaseNotSecondary - 作業預期資料庫為複寫目標。 400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType 無效。有效值為 STANDBY 和 GEO。 400 ReplicationLinksCreateIsNotSupported - 不支援建立復寫連結。 400 LedgerNoDropLink - 無法停止異地復寫，因為資料庫已啟用總賬摘要上傳。停用總帳摘要上傳，然後重試作業。 400 CannotUseTrailingWhitespacesInDatabaseName - 資料庫名稱驗證失敗。 400 GeoReplicationDatabaseNotSecondary - 作業預期資料庫為複寫目標。 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - 不支援使用 preferredEnclaveType 属性的不同值設定異地復寫的資料庫。 '{1}' 伺服器上的主要 '{0}' 資料庫使用 '{2}' preferredEnclaveType，而 '' 伺服器上次要 '{3}' 資料庫的{4}指定 preferredEnclaveType 是 '{5}'。 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - 虛擬式安全性 (VBS) 記憶體保護區不支援主要和輔助資料庫之間的計劃性故障轉移。 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。 400 InvalidServerName - 指定的伺服器名稱無效。 400 PlannedFailoverTimedOut - 使用者叫用容錯移轉，並在嘗試連絡合作夥伴管理服務時逾時。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 400 IncorrectReplicationLinkState - 作業預期資料庫在復寫連結上處於預期狀態。 404 OperationIdNotFound - 標識符為的作業不存在。 404 ResourceNotFound - 找不到所要求的資源。 404 OperationIdNotFound - 標識符為的作業不存在。 404 DatabaseDoesNotExist - 使用者已指定不存在於此伺服器實例上的資料庫名稱。 409 CannotCancelOperation - 管理作業處於無法取消的狀態。 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 - 超出可用資源可處理之最大要求的要求。

名稱

類型

Description

200 OK

ReplicationLink

已成功更新復寫連結。

202 Accepted

更新作業正在進行中。

Other Status Codes

ErrorResponse

錯誤回應： ≦

400 ReplicationLinksReplicationLinkNameIsInvalid - 複寫連結名稱應該是有效的 guid。
400 GeoReplicationDatabaseNotSecondary - 作業預期資料庫為複寫目標。
400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType 無效。有效值為 STANDBY 和 GEO。
400 ReplicationLinksCreateIsNotSupported - 不支援建立復寫連結。
400 LedgerNoDropLink - 無法停止異地復寫，因為資料庫已啟用總賬摘要上傳。停用總帳摘要上傳，然後重試作業。
400 CannotUseTrailingWhitespacesInDatabaseName - 資料庫名稱驗證失敗。
400 GeoReplicationDatabaseNotSecondary - 作業預期資料庫為複寫目標。
400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - 不支援使用 preferredEnclaveType 属性的不同值設定異地復寫的資料庫。 '{1}' 伺服器上的主要 '{0}' 資料庫使用 '{2}' preferredEnclaveType，而 '' 伺服器上次要 '{3}' 資料庫的{4}指定 preferredEnclaveType 是 '{5}'。
400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - 虛擬式安全性 (VBS) 記憶體保護區不支援主要和輔助資料庫之間的計劃性故障轉移。
400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。
400 InvalidServerName - 指定的伺服器名稱無效。
400 PlannedFailoverTimedOut - 使用者叫用容錯移轉，並在嘗試連絡合作夥伴管理服務時逾時。
400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。
400 IncorrectReplicationLinkState - 作業預期資料庫在復寫連結上處於預期狀態。
404 OperationIdNotFound - 標識符為的作業不存在。
404 ResourceNotFound - 找不到所要求的資源。
404 OperationIdNotFound - 標識符為的作業不存在。
404 DatabaseDoesNotExist - 使用者已指定不存在於此伺服器實例上的資料庫名稱。
409 CannotCancelOperation - 管理作業處於無法取消的狀態。
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 - 超出可用資源可處理之最大要求的要求。

範例

Update Replication Link

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/00000000-1111-2222-3333-666666666666?api-version=2023-08-01-preview

{
  "properties": {
    "linkType": "STANDBY"
  }
}

Sample Response

Status code:: 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": "STANDBY"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "00000000-1111-2222-3333-666666666666"
}

Status code:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/replicationLinksOperationResults/11111111-1111-1111-1111-111111111111

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ReplicationLink	複寫連結。
ReplicationLinkType	鏈接類型 (GEO、NAMED、STANDBY) 。更新作業不支援 NAMED。
ReplicationLinkUpdate	復寫連結更新要求。
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	錯誤物件。

ReplicationLink

複寫連結。

名稱	類型	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	連結的植入完成百分比。
properties.replicationMode	string	複寫模式。
properties.replicationState	ReplicationState	復寫狀態 (PENDING、SEEDING、CATCHUP、SUSPENDED) 。
properties.role	ReplicationRole	本機複寫角色。
properties.startTime	string	建立連結的時間。
type	string	資源類型。

ReplicationLinkType

鏈接類型 (GEO、NAMED、STANDBY) 。更新作業不支援 NAMED。

名稱	類型	Description
GEO	string
NAMED	string
STANDBY	string

ReplicationLinkUpdate

復寫連結更新要求。

名稱	類型	Description
id	string	資源識別碼。
name	string	資源名稱。
properties.linkType	ReplicationLinkType	鏈接類型 (GEO、NAMED、STANDBY) 。更新作業不支援 NAMED。
type	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

Replication Links - Update

URI 參數

要求本文

回應

範例

Update Replication Link

Sample Request

Sample Response

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationLinkUpdate

ReplicationRole

ReplicationState

其他資源