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 パラメーター

名前	/	必須	型	説明
clusterName	path	True	string	Redis Enterprise クラスターの名前。 名前の長さは 1 ~ 60 文字にする必要があります。 使用できる文字 (A ~ Z、a ~ z、0 ~ 9) とハイフン (-)。 先頭または末尾または連続するハイフンは使用できません 正規表現パターン: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
databaseName	path	True	string	Redis Enterprise データベースの名前。 正規表現パターン: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
resourceGroupName	path	True	string	リソース グループの名前。 名前では大文字と小文字が区別されません。
subscriptionId	path	True	string	ターゲット サブスクリプションの ID。
api-version	query	True	string	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
groupNickname	True	string	リンクされたデータベース リソースのグループの名前。 これは、既存のレプリケーション グループ名と一致する必要があります。
linkedDatabases	True	LinkedDatabase[]	リンクされ、レプリケーション グループに含まれると予想されるデータベースのリソース ID。 このパラメーターは、リンクがレプリケーション グループの予期される (リンクされていない) 部分 (スプリンター化されている場合) であることを検証するために使用されます。

応答

名前	型	説明
202 Accepted		リンク操作が正常にエンキューされました。Azure-AsyncOperation ヘッダーに従って最終的な結果をポーリングします。 ヘッダー Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
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...

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ForceLinkParameters	レプリケーション グループから以前にリンクが解除された既存のデータベースのアクティブ geo レプリケーションを再構成するためのパラメーター。
LinkedDatabase	リンクされたデータベース
LinkState	データベース リソース間のリンクの状態。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラー メッセージ。
target	string	エラーターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	エラー オブジェクト。

ForceLinkParameters

レプリケーション グループから以前にリンクが解除された既存のデータベースのアクティブ geo レプリケーションを再構成するためのパラメーター。

名前	型	説明
groupNickname	string	リンクされたデータベース リソースのグループの名前。 これは、既存のレプリケーション グループ名と一致する必要があります。
linkedDatabases	LinkedDatabase[]	リンクされ、レプリケーション グループに含まれると予想されるデータベースのリソース ID。 このパラメーターは、リンクがレプリケーション グループの予期される (リンクされていない) 部分 (スプリンター化されている場合) であることを検証するために使用されます。

LinkedDatabase

リンクされたデータベース

名前	型	説明
id	string	このデータベースにリンクするデータベース リソースのリソース ID。
state	LinkState	データベース リソース間のリンクの状態。

LinkState

データベース リソース間のリンクの状態。

名前	型	説明
LinkFailed	string
Linked	string
Linking	string
UnlinkFailed	string
Unlinking	string