Distributed Availability Groups - Update
Actualiza un modo de replicación de grupo de disponibilidad distribuido.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups/{distributedAvailabilityGroupName}?api-version=2025-01-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
distributed
|
path | True |
string |
Nombre del grupo de disponibilidad distribuido. |
|
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. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| properties.databases |
Bases de datos 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.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. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Operación de Azure completada con éxito. |
|
| 202 Accepted |
Solicitud de actualización de recursos aceptada. Encabezados
|
|
| 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
Update the distributed availability group replication mode before deleting it.
Solicitud de ejemplo
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag?api-version=2025-01-01
{
"properties": {
"replicationMode": "Sync"
}
}
Respuesta de muestra
{
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"properties": {
"distributedAvailabilityGroupName": "dag",
"replicationMode": "Sync"
}
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/distributedAvailabilityGroupsOperationResults/1f2b3c4d-5f6g-7h8i-9j0k-1l2m3n4o5p6q?api-version=2023-02-01-preview
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 |
|
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 |
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. |