다음을 통해 공유


Managed Instances - Failover

관리되는 instance 장애 조치(failover)합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01

URI 매개 변수

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

string

장애 조치(failover)에 대한 관리되는 instance 이름입니다.

resourceGroupName
path True

string

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

subscriptionId
path True

string

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

api-version
query True

string

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

replicaType
query

ReplicaType

장애 조치(failover)할 복제본(replica) 유형입니다.

응답

Name 형식 Description
200 OK

관리되는 instance 장애 조치(failover)를 완료했습니다.

202 Accepted

관리되는 instance 장애 조치(failover)가 진행 중입니다.

Other Status Codes

오류 응답: ***

  • 400 ManagedInstanceFailoverThrottled - 관리되는 instance 최근 장애 조치(failover)가 있었습니다.

  • 400 ManagedInstanceFailoverNotSupportedOnSKU - 이 유형의 고객이 시작한 장애 조치(failover)는 지정된 SKU에서 지원되지 않습니다.

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

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

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

  • 409 ManagedInstanceFailoverFullBackupMissing - 자동화된 백업은 새 데이터베이스에 대한 첫 번째 전체 백업을 완료해야 합니다.

  • 409 ManagedInstanceNotInStateToFailover - 관리되는 instance 현재 장애 조치(failover)를 실행할 수 없는 상태입니다.

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

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

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

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

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

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

예제

Failover a managed instance.

샘플 요청

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2021-11-01

샘플 응답

정의

ReplicaType

장애 조치(failover)할 복제본(replica) 유형입니다.

Name 형식 Description
Primary

string

ReadableSecondary

string