Distributed Availability Groups - List By Instance
Obtiene una lista de grupos de disponibilidad distribuidos en la instancia de .
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups?api-version=2025-01-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
managed
|
path | True |
string |
Nombre de la instancia administrada. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de API que se usará para esta operación. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La solicitud se ha realizado correctamente. |
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Lists all distributed availability groups in instance.
Solicitud de ejemplo
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups?api-version=2025-01-01
Respuesta de muestra
{
"value": [
{
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"properties": {
"databases": [
{
"connectedState": "CONNECTED",
"databaseName": "testdb",
"instanceRedoReplicationLagSeconds": 1,
"instanceReplicaId": "4713ed91-1e8c-497d-9bd4-d8a3935ae49a",
"instanceSendReplicationLagSeconds": 1,
"lastBackupLsn": "71000009405700001",
"lastBackupTime": "2023-08-01T00:00:00Z",
"lastCommitLsn": "71000009407900004",
"lastCommitTime": "2023-08-01T00:00:00Z",
"lastHardenedLsn": "71000009408100001",
"lastHardenedTime": "2023-08-01T00:00:00Z",
"lastReceivedLsn": "71000009407900001",
"lastReceivedTime": "2023-08-01T00:00:00Z",
"partnerReplicaId": "8ffa9723-a1ec-4323-b929-c4aedee3894b",
"replicaState": "Catchup",
"synchronizationHealth": "HEALTHY"
}
],
"distributedAvailabilityGroupId": "c856cff5-a6fe-418e-8894-17799cc20f5d",
"distributedAvailabilityGroupName": "dag",
"failoverMode": "None",
"instanceAvailabilityGroupName": "testcl",
"instanceLinkRole": "Primary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"partnerLinkRole": "Secondary",
"replicationMode": "Async",
"seedingMode": "Automatic"
}
},
{
"name": "dag2",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag2",
"properties": {
"databases": [
{
"connectedState": "CONNECTED",
"databaseName": "testdb2",
"instanceReplicaId": "81608df4-0840-4219-b3ae-9cc46be9dae9",
"lastBackupLsn": "71000009405700001",
"lastBackupTime": "2023-08-01T00:00:00Z",
"lastCommitLsn": "71000009407900004",
"lastCommitTime": "2023-08-01T00:00:00Z",
"lastHardenedLsn": "71000009408100001",
"lastHardenedTime": "2023-08-01T00:00:00Z",
"lastReceivedLsn": "71000009407900001",
"lastReceivedTime": "2023-08-01T00:00:00Z",
"partnerReplicaId": "57bc3421-e77a-4fdc-8a62-af105c4b1e38",
"replicaState": "Seeding",
"seedingProgress": "80%",
"synchronizationHealth": "HEALTHY"
}
],
"distributedAvailabilityGroupId": "8a52d869-c17e-4546-ab03-e038569e672a",
"distributedAvailabilityGroupName": "dag2",
"instanceAvailabilityGroupName": "testcl2",
"instanceLinkRole": "Secondary",
"partnerAvailabilityGroupName": "BoxLocalAg2",
"partnerEndpoint": "TCP://SERVER:7022",
"partnerLinkRole": "Primary",
"replicationMode": "Async"
}
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Certificate |
Información del certificado |
|
created |
Tipo de identidad que creó el recurso. |
|
Distributed |
Grupo de disponibilidad distribuido entre la caja y la Instancia Instancia administrada de Sql. |
|
Distributed |
Información específica de la base de datos |
|
Distributed |
Lista de grupos de disponibilidad distribuidos en la instancia de . |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
|
Failover |
El modo de conmutación por error de enlace puede ser manual si está pensado para conmutación por error bidireccional con un SQL Server compatible, o Ninguno para conmutación por error unidireccional a Azure. |
|
Link |
Rol de vínculo del lado de SQL Server |
|
Replica |
Estado conectado del vínculo |
|
Replica |
Estado de mantenimiento del vínculo |
|
Replication |
Modo de replicación del vínculo |
|
Seeding |
Modo de propagación de base de datos: puede ser Automático (valor predeterminado) o Manual para escenarios admitidos. |
|
system |
Metadatos relativos a la creación y última modificación del recurso. |
CertificateInfo
Información del certificado
| Nombre | Tipo | Description |
|---|---|---|
| certificateName |
string |
Nombre del certificado |
| expiryDate |
string (date-time) |
Fecha de expiración del certificado |
createdByType
Tipo de identidad que creó el recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DistributedAvailabilityGroup
Grupo de disponibilidad distribuido entre la caja y la Instancia Instancia administrada de Sql.
| Nombre | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nombre del recurso |
| properties.databases |
Bases de datos del grupo de disponibilidad distribuido |
|
| properties.distributedAvailabilityGroupId |
string (uuid) |
Identificador del grupo de disponibilidad distribuido |
| properties.distributedAvailabilityGroupName |
string |
Nombre del grupo de disponibilidad distribuido |
| properties.failoverMode |
El modo de conmutación por error de enlace puede ser manual si está pensado para conmutación por error bidireccional con un SQL Server compatible, o Ninguno para conmutación por error unidireccional a Azure. |
|
| properties.instanceAvailabilityGroupName |
string |
Nombre del grupo de disponibilidad del lado de instancia administrada |
| properties.instanceLinkRole |
Rol de vínculo lateral de instancia administrada |
|
| properties.partnerAvailabilityGroupName |
string |
Nombre del grupo de disponibilidad del lado de SQL Server |
| properties.partnerEndpoint |
string |
Punto de conexión del lado servidor SQL: nombre que se puede resolver con IP o DNS |
| properties.partnerLinkRole |
Rol de vínculo del lado de SQL Server |
|
| properties.replicationMode |
Modo de replicación del vínculo |
|
| properties.seedingMode |
Modo de propagación de base de datos: puede ser Automático (valor predeterminado) o Manual para escenarios admitidos. |
|
| systemData |
Azure Resource Manager metadatos que contienen información createdBy y modifiedBy. |
|
| type |
string |
Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento" |
DistributedAvailabilityGroupDatabase
Información específica de la base de datos
| Nombre | Tipo | Description |
|---|---|---|
| connectedState |
Estado conectado del vínculo |
|
| databaseName |
string |
Nombre de la base de datos en el vínculo |
| instanceRedoReplicationLagSeconds |
integer (int32) |
Retardo de rehacer cuando el lado del enlace de la Instancia administrada es principal |
| instanceReplicaId |
string (uuid) |
Identificador de réplica de instancia administrada |
| instanceSendReplicationLagSeconds |
integer (int32) |
Retraso en la replicación cuando el lado principal del enlace de la Instancia administrada es |
| lastBackupLsn |
string |
Último LSN de copia de seguridad |
| lastBackupTime |
string (date-time) |
Hora del último LSN de copia de seguridad |
| lastCommitLsn |
string |
Último LSN de confirmación |
| lastCommitTime |
string (date-time) |
Hora del último LSN de confirmación |
| lastHardenedLsn |
string |
Último LSN protegido |
| lastHardenedTime |
string (date-time) |
Última hora de LSN protegida |
| lastReceivedLsn |
string |
LSN recibido por última vez |
| lastReceivedTime |
string (date-time) |
Hora de LSN recibida por última vez |
| lastSentLsn |
string |
LSN enviado por última vez |
| lastSentTime |
string (date-time) |
Hora de LSN enviada por última vez |
| mostRecentLinkError |
string |
Descripción del error de conexión de vínculo más reciente |
| partnerAuthCertValidity |
Validez del certificado de SQL Server |
|
| partnerReplicaId |
string (uuid) |
Identificador de réplica de SQL Server |
| replicaState |
string |
Estado actual del vínculo |
| seedingProgress |
string |
Progreso de propagación |
| synchronizationHealth |
Estado de mantenimiento del vínculo |
DistributedAvailabilityGroupsListResult
Lista de grupos de disponibilidad distribuidos en la instancia de .
| Nombre | Tipo | Description |
|---|---|---|
| nextLink |
string |
Vínculo para recuperar la siguiente página de resultados. |
| value |
Matriz de resultados. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
| Nombre | Tipo | Description |
|---|---|---|
| info |
object |
Información adicional. |
| type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
Objeto de error. |
FailoverModeType
El modo de conmutación por error de enlace puede ser manual si está pensado para conmutación por error bidireccional con un SQL Server compatible, o Ninguno para conmutación por error unidireccional a Azure.
| Valor | Description |
|---|---|
| None |
Ninguno |
| Manual |
Manual |
LinkRole
Rol de vínculo del lado de SQL Server
| Valor | Description |
|---|---|
| Primary |
Primary |
| Secondary |
Secundario |
ReplicaConnectedState
Estado conectado del vínculo
| Valor | Description |
|---|---|
| DISCONNECTED |
DESCONECTADO |
| CONNECTED |
CONNECTED |
ReplicaSynchronizationHealth
Estado de mantenimiento del vínculo
| Valor | Description |
|---|---|
| NOT_HEALTHY |
NOT_HEALTHY |
| PARTIALLY_HEALTHY |
PARTIALLY_HEALTHY |
| HEALTHY |
SANA |
ReplicationModeType
Modo de replicación del vínculo
| Valor | Description |
|---|---|
| Async |
Async |
| Sync |
Sincronización |
SeedingModeType
Modo de propagación de base de datos: puede ser Automático (valor predeterminado) o Manual para escenarios admitidos.
| Valor | Description |
|---|---|
| Automatic |
Automático |
| Manual |
Manual |
systemData
Metadatos relativos a la creación y última modificación del recurso.
| Nombre | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
| createdBy |
string |
Identidad que creó el recurso. |
| createdByType |
Tipo de identidad que creó el recurso. |
|
| lastModifiedAt |
string (date-time) |
La marca de tiempo de la última modificación del recurso (UTC) |
| lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
| lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |