Conmuta por error una instancia administrada.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
Con parámetros opcionales:
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01
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.
404 OperationIdNotFound: la operación con id. no existe.
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.
409 OperationCancelled: el usuario ha cancelado la operación.
409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.
429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y,
503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
|
Ejemplos
Failover a managed instance.
Solicitud de ejemplo
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
import com.azure.resourcemanager.sql.models.ReplicaType;
/**
* Samples for ManagedInstances Failover.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverManagedInstance.json
*/
/**
* Sample code: Failover a managed instance.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void failoverAManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
azure.sqlServers().manager().serviceClient().getManagedInstances().failover("group1", "instanceName",
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
Definiciones
ReplicaType
Tipo de réplica que se va a conmutar por error.
| Nombre |
Tipo |
Description |
|
Primary
|
string
|
|
|
ReadableSecondary
|
string
|
|