Databases - Force Link To Replication Group

服務:

Redis Cache

API 版本:

2024-10-01

強制在指定的叢集上重新建立現有的資料庫，並將它重新加入現有的復寫群組。 重要注意事項： 將會捨棄此資料庫中的所有數據，而重新加入復寫群組時，資料庫將暫時無法使用。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/forceLinkToReplicationGroup?api-version=2024-10-01

URI 參數

名稱	位於	必要	類型	Description
clusterName	path	True	string	Redis Enterprise 叢集的名稱。 名稱長度必須是 1-60 個字元。 允許的字元（A-Z、a-z、0-9）和連字元（-）。 沒有前置或尾端或連續連字元 Regex 模式: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
databaseName	path	True	string	Redis Enterprise 資料庫的名稱。 Regex 模式: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
resourceGroupName	path	True	string	資源群組的名稱。 名稱不區分大小寫。
subscriptionId	path	True	string	目標訂用帳戶的標識碼。
api-version	query	True	string	要用於這項作業的 API 版本。

要求本文

名稱	必要	類型	Description
groupNickname	True	string	連結資料庫資源群組的名稱。 這應該符合現有的復寫組名。
linkedDatabases	True	LinkedDatabase[]	預期要連結並包含在復寫群組中的資料庫資源標識符。 此參數是用來驗證連結是否為復寫群組的預期（未連結）部分，如果連結已中斷。

回應

名稱	類型	Description
202 Accepted		強制連結作業成功加入佇列;請遵循 Azure-AsyncOperation 標頭來輪詢最終結果。 標題 Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

How to relink a database after a regional outage

範例要求

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default/forceLinkToReplicationGroup?api-version=2024-10-01

{
  "groupNickname": "groupName",
  "linkedDatabases": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default"
    },
    {
      "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default"
    }
  ]
}

範例回覆

狀態碼:

202

Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationStatus...

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ForceLinkParameters	重新設定作用中異地復寫的參數，這是先前從復寫群組取消連結的現有資料庫。
LinkedDatabase	連結的資料庫
LinkState	資料庫資源之間的鏈接狀態。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

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

ErrorDetail

錯誤詳細數據。

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

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ForceLinkParameters

重新設定作用中異地復寫的參數，這是先前從復寫群組取消連結的現有資料庫。

名稱	類型	Description
groupNickname	string	連結資料庫資源群組的名稱。 這應該符合現有的復寫組名。
linkedDatabases	LinkedDatabase[]	預期要連結並包含在復寫群組中的資料庫資源標識符。 此參數是用來驗證連結是否為復寫群組的預期（未連結）部分，如果連結已中斷。

LinkedDatabase

連結的資料庫

名稱	類型	Description
id	string	要與這個資料庫連結之資料庫資源的資源標識碼。
state	LinkState	資料庫資源之間的鏈接狀態。

LinkState

資料庫資源之間的鏈接狀態。

名稱	類型	Description
LinkFailed	string
Linked	string
Linking	string
UnlinkFailed	string
Unlinking	string