Compartir a través de


Databases - Failover

Conmuta por error una base de datos.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2021-11-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2021-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
path True

string

Nombre de la base de datos que se va a conmutar 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.

serverName
path True

string

El nombre del servidor.

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 base de datos.

202 Accepted

La conmutación por error de la base de datos está en curso.

Other Status Codes

Respuestas de error: ***

  • 400 ManagementServiceFeatureDisabled: el usuario intentó usar una característica que está deshabilitada.

  • 400 DatabaseFailoverThrottled: hubo una conmutación por error reciente en la base de datos o grupo si la base de datos pertenece a un grupo elástico.

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

  • 409 ManagementServiceDatabaseBusy : la base de datos '{0}' está ocupada con otra operación. Pruebe la operación más adelante.

  • 409 DatabaseNotInStateToFailover: la base de datos está actualmente en un estado de modo que no se pueda emitir la conmutación por error.

Ejemplos

Failover an database

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/testServer/databases/testDatabase/failover?replicaType=Primary&api-version=2021-11-01

Respuesta de muestra

Definiciones

ReplicaType

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

Nombre Tipo Description
Primary

string

ReadableSecondary

string