Databases - Force Link To Replication Group
지정된 클러스터에서 기존 데이터베이스를 강제로 다시 만들고 기존 복제 그룹에 다시 조인합니다. 중요 사항: 이 데이터베이스의 모든 데이터가 삭제되고 복제 그룹에 다시 가입하는 동안 데이터베이스를 일시적으로 사용할 수 없게 됩니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/forceLinkToReplicationGroup?api-version=2024-10-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
cluster
|
path | True |
string |
Redis Enterprise 클러스터의 이름입니다. 이름은 1~60자여야 합니다. 허용되는 문자(A-Z, a-z, 0-9) 및 하이픈(-)입니다. 선행 또는 후행 또는 연속 하이픈이 있을 수 없습니다. regex 패턴: |
database
|
path | True |
string |
Redis Enterprise 데이터베이스의 이름입니다. regex 패턴: |
resource
|
path | True |
string |
리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다. |
subscription
|
path | True |
string |
대상 구독의 ID입니다. |
api-version
|
query | True |
string |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
geoReplication | True |
이 데이터베이스에 대한 지역 복제를 구성하는 속성입니다. |
응답
Name | 형식 | Description |
---|---|---|
202 Accepted |
강제 연결 작업이 성공적으로 큐에 추가되었습니다. Azure-AsyncOperation 헤더를 따라 최종 결과를 폴링합니다. 헤더
|
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
How to relink a database after a regional outage
샘플 요청
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"
}
]
}
}
샘플 응답
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationStatus...
정의
Name | Description |
---|---|
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Force |
복제 그룹에서 이전에 연결되지 않은 기존 데이터베이스의 활성 지역 복제를 다시 구성하기 위한 매개 변수입니다. |
Geo |
이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다. |
Linked |
연결된 데이터베이스 |
Link |
데이터베이스 리소스 간의 링크 상태입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
ForceLinkParameters
복제 그룹에서 이전에 연결되지 않은 기존 데이터베이스의 활성 지역 복제를 다시 구성하기 위한 매개 변수입니다.
Name | 형식 | Description |
---|---|---|
geoReplication |
이 데이터베이스에 대한 지역 복제를 구성하는 속성입니다. |
GeoReplication
이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.
Name | 형식 | Description |
---|---|---|
groupNickname |
string |
연결된 데이터베이스 리소스 그룹의 이름 |
linkedDatabases |
이 데이터베이스와 연결할 데이터베이스 리소스 목록 |
LinkedDatabase
연결된 데이터베이스
Name | 형식 | Description |
---|---|---|
id |
string |
이 데이터베이스와 연결할 데이터베이스 리소스의 리소스 ID입니다. |
state |
데이터베이스 리소스 간의 링크 상태입니다. |
LinkState
데이터베이스 리소스 간의 링크 상태입니다.
Name | 형식 | Description |
---|---|---|
LinkFailed |
string |
|
Linked |
string |
|
Linking |
string |
|
UnlinkFailed |
string |
|
Unlinking |
string |