다음을 통해 공유


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
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

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
geoReplication True

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 속성입니다.

응답

Name 형식 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

범위

Name Description
user_impersonation 사용자 계정 가장

예제

샘플 요청

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
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

ForceLinkParameters

복제 그룹에서 이전에 연결되지 않은 기존 데이터베이스의 활성 지역 복제를 다시 구성하기 위한 매개 변수입니다.

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.

LinkedDatabase

연결된 데이터베이스

LinkState

데이터베이스 리소스 간의 링크 상태입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ForceLinkParameters

복제 그룹에서 이전에 연결되지 않은 기존 데이터베이스의 활성 지역 복제를 다시 구성하기 위한 매개 변수입니다.

Name 형식 Description
geoReplication

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 속성입니다.

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.

Name 형식 Description
groupNickname

string

연결된 데이터베이스 리소스 그룹의 이름

linkedDatabases

LinkedDatabase[]

이 데이터베이스와 연결할 데이터베이스 리소스 목록

LinkedDatabase

연결된 데이터베이스

Name 형식 Description
id

string

이 데이터베이스와 연결할 데이터베이스 리소스의 리소스 ID입니다.

state

LinkState

데이터베이스 리소스 간의 링크 상태입니다.

LinkState

데이터베이스 리소스 간의 링크 상태입니다.

Name 형식 Description
LinkFailed

string

Linked

string

Linking

string

UnlinkFailed

string

Unlinking

string