Databases - Failover

Servicio:

SQL Database

Versión de la API:

2021-11-01

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

Con parámetros opcionales:

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

HTTP

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

Java

import com.azure.resourcemanager.sql.models.ReplicaType;

/**
 * Samples for Databases Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverDatabase.json
     */
    /**
     * Sample code: Failover an database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAnDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().failover("group1", "testServer", "testDatabase",
            ReplicaType.PRIMARY, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

status code:

202

Definiciones

ReplicaType

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

Nombre	Tipo	Description
Primary	string
ReadableSecondary	string