다음을 통해 공유


Replication Links - Failover

현재 주 서버에서 이 서버로 장애 조치(failover)합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2021-11-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
databaseName
path True

string

데이터베이스의 이름입니다.

linkId
path True

string

복제 링크의 이름입니다.

resourceGroupName
path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True

string

요청에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

ReplicationLink

성공적으로 장애 조치(failover)했습니다.

202 Accepted

장애 조치(failover) 작업이 진행 중입니다.

Other Status Codes

오류 응답: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid - 복제 링크 이름은 유효한 GUID여야 합니다.

  • 400 GeoReplicationDatabaseNotSecondary - 이 작업은 데이터베이스가 복제 대상이 될 것으로 예상합니다.

  • 400 LedgerNoDropLink - 데이터베이스에 원장 다이제스트 업로드를 사용하도록 설정했기 때문에 지역 복제를 중지할 수 없습니다. 원장 다이제스트 업로드를 사용하지 않도록 설정하고 작업을 다시 시도합니다.

  • 400 CannotUseTrailingWhitespacesInDatabaseName - 데이터베이스 이름 유효성 검사에 실패했습니다.

  • 400 GeoReplicationDatabaseNotSecondary - 이 작업은 데이터베이스가 복제 대상이 될 것으로 예상합니다.

  • 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.

  • 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.

  • 400 PlannedFailoverTimedOut - 사용자가 계획된 장애조치 호출했으며 파트너 관리 서비스에 문의하는 동안 시간이 초과되었습니다.

  • 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.

  • 400 IncorrectReplicationLinkState - 작업에서는 데이터베이스가 복제 링크에서 예상되는 상태일 것으로 예상합니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

  • 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 404 DatabaseDoesNotExist - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - 복제 관계에 이미 있는 데이터베이스에서 복제 시드 작업이 수행되었습니다.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - 보조 데이터베이스가 물리적으로 일관되지 않아 주 역할을 입력할 수 없는 상태에 있는 동안 사용자가 지역 링크를 장애 조치(failover)하거나 강제로 종료하려고 했습니다.

  • 409 DuplicateGeoDrRelation - 데이터베이스가 이미 복제 관계에 있습니다. 중복된 요청입니다.

  • 409 UpdateSloInProgress - 사용자가 SLO 업데이트가 진행되는 동안 호환되지 않는 작업을 시작하려고 했습니다.

  • 409 ManagementServiceDatabaseBusy - 데이터베이스 '{0}'가 다른 작업으로 사용 중입니다. 나중에 작업을 시도하세요.

  • 409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다.

  • 409 FailoverGroupAlreadySetup - 지역 복제 링크가 장애 조치(failover) 그룹의 일부이므로 작업을 수행할 수 없습니다. 개별적으로 종료하거나 장애 조치(failover)하려면 그룹에서 데이터베이스를 제거해야 합니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

샘플 요청

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2021-11-01

샘플 응답

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}

정의

Name Description
ReplicationLink

복제 링크입니다.

ReplicationLinkType

링크 유형(GEO, NAMED, STANDBY).

ReplicationRole

로컬 복제 역할.

ReplicationState

복제 상태(보류 중, 시드, CATCHUP, 일시 중단됨).

복제 링크입니다.

Name 형식 Description
id

string

리소스 ID입니다.

name

string

리소스 이름입니다.

properties.isTerminationAllowed

boolean

사용자가 현재 링크를 종료할 수 있는지 여부입니다.

properties.linkType

ReplicationLinkType

링크 유형(GEO, NAMED, STANDBY).

properties.partnerDatabase

string

리소스 파트너 데이터베이스.

properties.partnerLocation

string

리소스 파트너 위치입니다.

properties.partnerRole

ReplicationRole

파트너 복제 역할.

properties.partnerServer

string

리소스 파트너 서버.

properties.percentComplete

integer

링크의 시드 완료율입니다.

properties.replicationMode

string

복제 모드.

properties.replicationState

ReplicationState

복제 상태(보류 중, 시드, CATCHUP, 일시 중단됨).

properties.role

ReplicationRole

로컬 복제 역할.

properties.startTime

string

링크를 만든 시간입니다.

type

string

리소스 종류.

ReplicationLinkType

링크 유형(GEO, NAMED, STANDBY).

Name 형식 Description
GEO

string

NAMED

string

STANDBY

string

ReplicationRole

로컬 복제 역할.

Name 형식 Description
Copy

string

NonReadableSecondary

string

Primary

string

Secondary

string

Source

string

ReplicationState

복제 상태(보류 중, 시드, CATCHUP, 일시 중단됨).

Name 형식 Description
CATCH_UP

string

PENDING

string

SEEDING

string

SUSPENDED

string