Faz failover de uma instância gerenciada.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
Com parâmetros opcionais:
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 URI
| Nome |
Em |
Obrigatório |
Tipo |
Description |
|
managedInstanceName
|
path |
True
|
string
|
O nome da instância gerenciada para failover.
|
|
resourceGroupName
|
path |
True
|
string
|
O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
|
|
subscriptionId
|
path |
True
|
string
|
A ID de assinatura que identifica uma assinatura do Azure.
|
|
api-version
|
query |
True
|
string
|
A versão da API a ser usada para a solicitação.
|
|
replicaType
|
query |
|
ReplicaType
|
O tipo de réplica para failover.
|
Respostas
| Nome |
Tipo |
Description |
|
200 OK
|
|
Failover de instância gerenciada concluído com êxito.
|
|
202 Accepted
|
|
O failover da instância gerenciada está em andamento.
|
|
Other Status Codes
|
|
Respostas de erro: ***
400 ManagedInstanceFailoverThrottled - Houve um failover recente na instância gerenciada.
400 ManagedInstanceFailoverNotSupportedOnSKU – não há suporte para esse tipo de failover iniciado pelo cliente no SKU fornecido.
404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.
404 OperationIdNotFound - A operação com Id não existe.
409 ManagedInstanceFailoverFullBackupMissing – O backup automatizado precisa concluir o primeiro backup completo para um novo banco de dados.
409 ManagedInstanceNotInStateToFailover - A instância gerenciada está atualmente em um estado de modo que o failover não possa ser emitido.
409 OperationCancelled - A operação foi cancelada pelo usuário.
409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.
429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.
429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.
500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.
503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.
|
Exemplos
Failover a managed instance.
Solicitação de exemplo
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
Definições
ReplicaType
O tipo de réplica para failover.
| Nome |
Tipo |
Description |
|
Primary
|
string
|
|
|
ReadableSecondary
|
string
|
|