Failover Groups - Failover
현재 주 서버에서 이 서버로 장애 조치(fails over)합니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/failover?api-version=2023-08-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
failover
|
path | True |
string |
장애 조치(failover) 그룹의 이름입니다. |
resource
|
path | True |
string |
리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다. |
server
|
path | True |
string |
장애 조치(failover) 그룹을 포함하는 서버의 이름입니다. |
subscription
|
path | True |
string |
Azure 구독을 식별하는 구독 ID입니다. |
api-version
|
query | True |
string |
요청에 사용할 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
장애 조치(failover)가 완료되었습니다. |
|
202 Accepted |
허용 헤더 Location: string |
|
Other Status Codes |
오류 응답: ***
|
예제
Planned failover of a failover group
샘플 요청
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3/failover?api-version=2023-08-01
샘플 응답
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan West",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 120
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server",
"location": "Japan East",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-2"
]
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japanwest/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
정의
Name | Description |
---|---|
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Failover |
장애 조치(failover) 그룹입니다. |
Failover |
파트너 서버의 데이터베이스 보조 형식입니다. |
Failover |
장애 조치(failover) 그룹 인스턴스의 읽기 전용 엔드포인트입니다. |
Failover |
장애 조치(failover) 그룹 인스턴스의 읽기-쓰기 엔드포인트입니다. |
Failover |
장애 조치(failover) 그룹 인스턴스의 로컬 복제 역할입니다. |
Partner |
장애 조치(failover) 그룹에 대한 파트너 서버 정보입니다. |
Read |
장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다. |
Read |
장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
FailoverGroup
장애 조치(failover) 그룹입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
location |
string |
리소스 위치입니다. |
name |
string |
리소스 이름입니다. |
properties.databases |
string[] (arm-id) |
장애 조치(failover) 그룹의 데이터베이스 목록입니다. |
properties.partnerServers |
장애 조치(failover) 그룹에 대한 파트너 서버 정보 목록입니다. |
|
properties.readOnlyEndpoint |
장애 조치(failover) 그룹 인스턴스의 읽기 전용 엔드포인트입니다. |
|
properties.readWriteEndpoint |
장애 조치(failover) 그룹 인스턴스의 읽기-쓰기 엔드포인트입니다. |
|
properties.replicationRole |
장애 조치(failover) 그룹 인스턴스의 로컬 복제 역할입니다. |
|
properties.replicationState |
string |
장애 조치(failover) 그룹 인스턴스의 복제 상태입니다. |
properties.secondaryType |
파트너 서버의 데이터베이스 보조 형식입니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 종류입니다. |
FailoverGroupDatabasesSecondaryType
파트너 서버의 데이터베이스 보조 형식입니다.
값 | Description |
---|---|
Geo | |
Standby |
FailoverGroupReadOnlyEndpoint
장애 조치(failover) 그룹 인스턴스의 읽기 전용 엔드포인트입니다.
Name | 형식 | Description |
---|---|---|
failoverPolicy |
장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다. |
|
targetServer |
string (arm-id) |
읽기 전용 엔드포인트가 가리키는 대상 파트너 서버입니다. |
FailoverGroupReadWriteEndpoint
장애 조치(failover) 그룹 인스턴스의 읽기-쓰기 엔드포인트입니다.
Name | 형식 | Description |
---|---|---|
failoverPolicy |
장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다. |
|
failoverWithDataLossGracePeriodMinutes |
integer (int32) |
읽기/쓰기 엔드포인트에 대해 데이터 손실이 있는 장애 조치(failover) 전 유예 기간이 시도됩니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다. |
FailoverGroupReplicationRole
장애 조치(failover) 그룹 인스턴스의 로컬 복제 역할입니다.
값 | Description |
---|---|
Primary | |
Secondary |
PartnerInfo
장애 조치(failover) 그룹에 대한 파트너 서버 정보입니다.
Name | 형식 | Description |
---|---|---|
id |
string (arm-id) |
파트너 서버의 리소스 식별자입니다. |
location |
string |
파트너 서버의 지리적 위치입니다. |
replicationRole |
파트너 서버의 복제 역할입니다. |
ReadOnlyEndpointFailoverPolicy
장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다.
값 | Description |
---|---|
Disabled | |
Enabled |
ReadWriteEndpointFailoverPolicy
장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다.
값 | Description |
---|---|
Automatic | |
Manual |