你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 版本。

请求正文

名称	必需	类型	说明
geoReplication	True	GeoReplication	要为此数据库配置异地复制的属性。

响应

名称	类型	说明
202 Accepted		强制链接操作已成功排队;按照 Azure-AsyncOperation 标头轮询最终结果。 标头 Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 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

{
  "geoReplication": {
    "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	用于重新配置活动异地复制的参数，该数据库以前已从复制组取消链接的现有数据库。
GeoReplication	用于为此数据库配置异地复制的可选属性集。
LinkedDatabase	链接数据库
LinkState	数据库资源之间的链接状态。

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ForceLinkParameters

用于重新配置活动异地复制的参数，该数据库以前已从复制组取消链接的现有数据库。

名称	类型	说明
geoReplication	GeoReplication	要为此数据库配置异地复制的属性。

GeoReplication

用于为此数据库配置异地复制的可选属性集。

名称	类型	说明
groupNickname	string	链接数据库资源组的名称
linkedDatabases	LinkedDatabase[]	要链接到此数据库的数据库资源列表

LinkedDatabase

链接数据库

名称	类型	说明
id	string	要链接到此数据库的数据库资源的资源 ID。
state	LinkState	数据库资源之间的链接状态。

LinkState

数据库资源之间的链接状态。

名称	类型	说明
LinkFailed	string
Linked	string
Linking	string
UnlinkFailed	string
Unlinking	string