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 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
managed
|
path | True |
string |
托管实例的名称。 |
|
resource
|
path | True |
string |
包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。 |
|
subscription
|
path | True |
string |
标识 Azure 订阅的订阅 ID。 |
|
api-version
|
query | True |
string |
要用于请求的 API 版本。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
已成功检索分布式可用性组的列表。 |
|
| Other Status Codes |
错误响应: ***
|
示例
Lists all distributed availability groups in instance.
示例请求
示例响应
{
"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"
}
]
}
定义
| 名称 | 说明 |
|---|---|
|
Certificate |
证书信息 |
|
Distributed |
Box 和 Sql 托管实例之间的分布式可用性组。 |
|
Distributed |
数据库特定信息 |
|
Distributed |
实例中分布式可用性组的列表。 |
|
Error |
资源管理错误附加信息。 |
|
Error |
错误详细信息。 |
|
Error |
错误响应 |
|
Failover |
链接故障转移模式 - 如果打算用于支持 SQL Server 的双向故障转移,则为“无”,用于单向故障转移到 Azure。 |
|
Link |
SQL 服务器端链接角色 |
|
Replica |
链接连接状态 |
|
Replica |
链接运行状况状态 |
|
Replication |
链接的复制模式 |
|
Seeding |
数据库种子设定模式 – 可以是“自动”(默认值),也可以是“手动”(对于受支持的方案)。 |
CertificateInfo
证书信息
| 名称 | 类型 | 说明 |
|---|---|---|
| certificateName |
string |
证书名称 |
| expiryDate |
string (date-time) |
证书到期日期 |
DistributedAvailabilityGroup
Box 和 Sql 托管实例之间的分布式可用性组。
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string |
资源 ID。 |
| name |
string |
资源名称。 |
| properties.databases |
分布式可用性组中的数据库 |
|
| properties.distributedAvailabilityGroupId |
string (uuid) |
分布式可用性组的 ID |
| properties.distributedAvailabilityGroupName |
string |
分布式可用性组的名称 |
| properties.failoverMode |
链接故障转移模式 - 如果打算用于支持 SQL Server 的双向故障转移,则为“无”,用于单向故障转移到 Azure。 |
|
| properties.instanceAvailabilityGroupName |
string |
托管实例端可用性组名称 |
| properties.instanceLinkRole |
托管实例端链接角色 |
|
| properties.partnerAvailabilityGroupName |
string |
SQL 服务器端可用性组名称 |
| properties.partnerEndpoint |
string |
SQL 服务器端终结点 - IP 或 DNS 可解析名称 |
| properties.partnerLinkRole |
SQL 服务器端链接角色 |
|
| properties.replicationMode |
链接的复制模式 |
|
| properties.seedingMode |
数据库种子设定模式 – 可以是“自动”(默认值),也可以是“手动”(对于受支持的方案)。 |
|
| type |
string |
资源类型。 |
DistributedAvailabilityGroupDatabase
数据库特定信息
| 名称 | 类型 | 说明 |
|---|---|---|
| connectedState |
链接连接状态 |
|
| databaseName |
string |
链接中数据库的名称 |
| instanceRedoReplicationLagSeconds |
integer (int32) |
托管实例链接端为主时重做延迟 |
| instanceReplicaId |
string (uuid) |
托管实例副本 ID |
| instanceSendReplicationLagSeconds |
integer (int32) |
托管实例链接端为主节点时复制滞后时间 |
| 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
实例中分布式可用性组的列表。
| 名称 | 类型 | 说明 |
|---|---|---|
| nextLink |
string |
用于检索下一页结果的链接。 |
| value |
结果数组。 |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
错误详细信息。 |
|
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
FailoverModeType
链接故障转移模式 - 如果打算用于支持 SQL Server 的双向故障转移,则为“无”,用于单向故障转移到 Azure。
| 值 | 说明 |
|---|---|
| None | |
| Manual |
LinkRole
SQL 服务器端链接角色
| 值 | 说明 |
|---|---|
| Primary | |
| Secondary |
ReplicaConnectedState
链接连接状态
| 值 | 说明 |
|---|---|
| DISCONNECTED | |
| CONNECTED |
ReplicaSynchronizationHealth
链接运行状况状态
| 值 | 说明 |
|---|---|
| NOT_HEALTHY | |
| PARTIALLY_HEALTHY | |
| HEALTHY |
ReplicationModeType
链接的复制模式
| 值 | 说明 |
|---|---|
| Async | |
| Sync |
SeedingModeType
数据库种子设定模式 – 可以是“自动”(默认值),也可以是“手动”(对于受支持的方案)。
| 值 | 说明 |
|---|---|
| Automatic | |
| Manual |