Leer en inglés

Compartir a través de

Managed Instances - Failover

  • Referencia
Servicio:
SQL Database
Versión de la API:
2021-11-01-preview

Conmuta por error una instancia administrada.

HTTP 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01-preview
Con parámetros opcionales:
HTTP 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01-preview

Parámetros de identificador URI

Nombre En Requerido Tipo Description
managedInstanceName
 path True

string

Nombre de la instancia administrada para la conmutación por error.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
subscriptionId
 path True

string

El id. de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

La versión de API que se usará para la solicitud.
replicaType
 query

ReplicaType

Tipo de réplica que se va a conmutar por error.

Respuestas

Nombre Tipo Description
200 OK

Se completó correctamente la conmutación por error de la instancia administrada.
202 Accepted

La conmutación por error de instancia administrada está en curso.
Other Status Codes

Respuestas de error: ***

  • 400 ManagedInstanceFailoverThrottled: hubo una conmutación por error reciente en la instancia administrada.

  • 400 ManagedInstanceFailoverNotSupportedOnSKU: este tipo de conmutación por error iniciada por el cliente no se admite en la SKU especificada.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 409 ManagedInstanceFailoverFullBackupMissing: la copia de seguridad automatizada debe completar la primera copia de seguridad completa para una nueva base de datos.

  • 409 ManagedInstanceNotInStateToFailover: la instancia administrada se encuentra actualmente en un estado de modo que no se pueda emitir la conmutación por error.

Ejemplos

Failover a managed instance.

Solicitud de ejemplo

HTTP 
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2021-11-01-preview

Respuesta de muestra

status code:
200
status code:
202

Definiciones

ReplicaType

Enumeration

Tipo de réplica que se va a conmutar por error.

Valor Description
Primary
ReadableSecondary