다음을 통해 공유

Databases - Failover

  • 참조
서비스:
SQL Database
API 버전:
2023-08-01

데이터베이스를 장애 조치(failover)합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
선택적 매개 변수: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01

URI 매개 변수

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

string

장애 조치(failover)할 데이터베이스의 이름입니다.
resourceGroupName
 path True

string

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

string

서버의 이름입니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

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

ReplicaType

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

응답

Name 형식 Description
200 OK

데이터베이스 장애 조치(failover)를 완료했습니다.
202 Accepted

데이터베이스 장애 조치(failover)가 진행 중입니다.

헤더

Location: string
Other Status Codes

ErrorResponse

오류 응답: ***

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

  • 400 DatabaseFailoverThrottled - 데이터베이스가 탄력적 풀에 속하는 경우 데이터베이스 또는 풀에 최근 장애 조치(failover)가 있었습니다.

  • 400 ManagementServiceFeatureDisabled - 사용자가 사용하지 않도록 설정된 기능을 사용하려고 했습니다.

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

  • 409 DatabaseNotInStateToFailover - 현재 데이터베이스가 장애 조치(failover)를 실행할 수 없는 상태입니다.

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

  • 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.

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

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

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

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

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

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

예제

Failover an database

샘플 요청

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/testServer/databases/testDatabase/failover?replicaType=Primary&api-version=2023-08-01

샘플 응답

상태 코드:
200
상태 코드:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

정의

Name Description
ErrorAdditionalInfo

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

오류 세부 정보입니다.
ErrorResponse

오류 응답
ReplicaType

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

ErrorAdditionalInfo

Object

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

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ReplicaType

열거형

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

값 Description
Primary
ReadableSecondary