Distributed Availability Groups - List By Instance
예를 들어 분산 가용성 그룹의 목록을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups?api-version=2023-08-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
managed
|
path | True |
string |
관리되는 인스턴스의 이름입니다. |
|
resource
|
path | True |
string |
리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다. |
|
subscription
|
path | True |
string |
Azure 구독을 식별하는 구독 ID입니다. |
|
api-version
|
query | True |
string |
요청에 사용할 API 버전입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
분산 가용성 그룹 목록을 성공적으로 검색했습니다. |
|
| Other Status Codes |
오류 응답: ***
|
예제
Lists all distributed availability groups in instance.
샘플 요청
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups?api-version=2023-08-01
샘플 응답
{
"value": [
{
"properties": {
"distributedAvailabilityGroupName": "dag",
"distributedAvailabilityGroupId": "c856cff5-a6fe-418e-8894-17799cc20f5d",
"replicationMode": "Async",
"partnerLinkRole": "Secondary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"instanceLinkRole": "Primary",
"instanceAvailabilityGroupName": "testcl",
"failoverMode": "None",
"seedingMode": "Automatic",
"databases": [
{
"databaseName": "testdb",
"instanceReplicaId": "4713ed91-1e8c-497d-9bd4-d8a3935ae49a",
"partnerReplicaId": "8ffa9723-a1ec-4323-b929-c4aedee3894b",
"replicaState": "Catchup",
"synchronizationHealth": "HEALTHY",
"connectedState": "CONNECTED",
"lastReceivedLsn": "71000009407900001",
"lastReceivedTime": "2023-08-01T00:00:00Z",
"lastCommitLsn": "71000009407900004",
"lastCommitTime": "2023-08-01T00:00:00Z",
"lastHardenedLsn": "71000009408100001",
"lastHardenedTime": "2023-08-01T00:00:00Z",
"lastBackupLsn": "71000009405700001",
"lastBackupTime": "2023-08-01T00:00:00Z",
"instanceSendReplicationLagSeconds": 1,
"instanceRedoReplicationLagSeconds": 1
}
]
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
},
{
"properties": {
"distributedAvailabilityGroupName": "dag2",
"distributedAvailabilityGroupId": "8a52d869-c17e-4546-ab03-e038569e672a",
"replicationMode": "Async",
"partnerLinkRole": "Primary",
"partnerAvailabilityGroupName": "BoxLocalAg2",
"partnerEndpoint": "TCP://SERVER:7022",
"instanceLinkRole": "Secondary",
"instanceAvailabilityGroupName": "testcl2",
"databases": [
{
"databaseName": "testdb2",
"instanceReplicaId": "81608df4-0840-4219-b3ae-9cc46be9dae9",
"partnerReplicaId": "57bc3421-e77a-4fdc-8a62-af105c4b1e38",
"replicaState": "Seeding",
"seedingProgress": "80%",
"synchronizationHealth": "HEALTHY",
"connectedState": "CONNECTED",
"lastReceivedLsn": "71000009407900001",
"lastReceivedTime": "2023-08-01T00:00:00Z",
"lastCommitLsn": "71000009407900004",
"lastCommitTime": "2023-08-01T00:00:00Z",
"lastHardenedLsn": "71000009408100001",
"lastHardenedTime": "2023-08-01T00:00:00Z",
"lastBackupLsn": "71000009405700001",
"lastBackupTime": "2023-08-01T00:00:00Z"
}
]
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag2",
"name": "dag2",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
}
]
}
정의
| Name | Description |
|---|---|
|
Certificate |
인증서 정보 |
|
Distributed |
box와 Sql Managed Instance 간의 분산 가용성 그룹입니다. |
|
Distributed |
데이터베이스 관련 정보 |
|
Distributed |
예를 들어 분산 가용성 그룹의 목록입니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Failover |
링크 장애 조치(failover) 모드는 지원되는 SQL Server에서 양방향 장애 조치(failover)에 사용하려는 경우 수동이거나, Azure로의 단방향 장애 조치(failover)에 대해서는 None일 수 있습니다. |
|
Link |
SQL Server 쪽 링크 역할 |
|
Replica |
연결된 상태 연결 |
|
Replica |
링크 상태 |
|
Replication |
링크의 복제 모드 |
|
Seeding |
데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다. |
CertificateInfo
인증서 정보
| Name | 형식 | Description |
|---|---|---|
| certificateName |
string |
인증서 이름 |
| expiryDate |
string (date-time) |
인증서 만료 날짜 |
DistributedAvailabilityGroup
box와 Sql Managed Instance 간의 분산 가용성 그룹입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스 ID입니다. |
| name |
string |
리소스 이름입니다. |
| properties.databases |
분산 가용성 그룹의 데이터베이스 |
|
| properties.distributedAvailabilityGroupId |
string (uuid) |
분산 가용성 그룹의 ID |
| properties.distributedAvailabilityGroupName |
string |
분산 가용성 그룹의 이름 |
| properties.failoverMode |
링크 장애 조치(failover) 모드는 지원되는 SQL Server에서 양방향 장애 조치(failover)에 사용하려는 경우 수동이거나, Azure로의 단방향 장애 조치(failover)에 대해서는 None일 수 있습니다. |
|
| properties.instanceAvailabilityGroupName |
string |
관리되는 인스턴스 쪽 가용성 그룹 이름 |
| properties.instanceLinkRole |
관리되는 인스턴스 쪽 링크 역할 |
|
| properties.partnerAvailabilityGroupName |
string |
SQL Server 쪽 가용성 그룹 이름 |
| properties.partnerEndpoint |
string |
SQL Server 쪽 엔드포인트 - IP 또는 DNS 확인 가능한 이름 |
| properties.partnerLinkRole |
SQL Server 쪽 링크 역할 |
|
| properties.replicationMode |
링크의 복제 모드 |
|
| properties.seedingMode |
데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다. |
|
| type |
string |
리소스 종류입니다. |
DistributedAvailabilityGroupDatabase
데이터베이스 관련 정보
| Name | 형식 | Description |
|---|---|---|
| connectedState |
연결된 상태 연결 |
|
| databaseName |
string |
링크에 있는 데이터베이스의 이름 |
| instanceRedoReplicationLagSeconds |
integer (int32) |
Managed Instance 링크 쪽이 기본인 경우 다시 실행 지연 |
| instanceReplicaId |
string (uuid) |
관리되는 인스턴스 복제본 ID |
| instanceSendReplicationLagSeconds |
integer (int32) |
Managed Instance 링크 쪽이 기본인 경우 복제 지연 |
| lastBackupLsn |
string |
마지막 백업 LSN |
| lastBackupTime |
string (date-time) |
마지막 백업 LSN 시간 |
| lastCommitLsn |
string |
마지막 커밋 LSN |
| lastCommitTime |
string (date-time) |
마지막 커밋 LSN 시간 |
| lastHardenedLsn |
string |
마지막으로 강화된 LSN |
| lastHardenedTime |
string (date-time) |
마지막으로 강화된 LSN 시간 |
| lastReceivedLsn |
string |
마지막으로 받은 LSN |
| lastReceivedTime |
string (date-time) |
마지막으로 받은 LSN 시간 |
| lastSentLsn |
string |
마지막으로 보낸 LSN |
| lastSentTime |
string (date-time) |
마지막으로 보낸 LSN 시간 |
| mostRecentLinkError |
string |
가장 최근의 링크 연결 오류 설명 |
| partnerAuthCertValidity |
SQL Server 인증서 유효성 |
|
| partnerReplicaId |
string (uuid) |
SQL Server 복제본 ID |
| replicaState |
string |
현재 링크 상태 |
| seedingProgress |
string |
시드 진행률 |
| synchronizationHealth |
링크 상태 |
DistributedAvailabilityGroupsListResult
예를 들어 분산 가용성 그룹의 목록입니다.
| Name | 형식 | Description |
|---|---|---|
| nextLink |
string |
결과의 다음 페이지를 검색하는 링크입니다. |
| value |
결과 배열입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
FailoverModeType
링크 장애 조치(failover) 모드는 지원되는 SQL Server에서 양방향 장애 조치(failover)에 사용하려는 경우 수동이거나, Azure로의 단방향 장애 조치(failover)에 대해서는 None일 수 있습니다.
| 값 | Description |
|---|---|
| None | |
| Manual |
LinkRole
SQL Server 쪽 링크 역할
| 값 | Description |
|---|---|
| Primary | |
| Secondary |
ReplicaConnectedState
연결된 상태 연결
| 값 | Description |
|---|---|
| DISCONNECTED | |
| CONNECTED |
ReplicaSynchronizationHealth
링크 상태
| 값 | Description |
|---|---|
| NOT_HEALTHY | |
| PARTIALLY_HEALTHY | |
| HEALTHY |
ReplicationModeType
링크의 복제 모드
| 값 | Description |
|---|---|
| Async | |
| Sync |
SeedingModeType
데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다.
| 값 | Description |
|---|---|
| Automatic | |
| Manual |