Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Faz failover de um banco de dados.

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

With optional parameters:

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 URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados 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.
serverName	path	True	string	O nome do servidor.
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 banco de dados concluído com êxito.
202 Accepted		O failover do banco de dados está em andamento.
Other Status Codes		Respostas de erro: *** 400 ManagementServiceFeatureDisabled - O usuário tentou usar um recurso que está desabilitado. 400 DatabaseFailoverThrottled - Houve um failover recente no banco de dados ou pool se o banco de dados pertencer a um pool elástico. 400 DatabaseFailoverNotSupportedOnSKU – não há suporte para esse tipo de failover iniciado pelo cliente no SKU fornecido. 409 ManagementServiceDatabaseBusy - O banco de dados '{0}' está ocupado com outra operação. Tente sua operação mais tarde. 409 DatabaseNotInStateToFailover - O banco de dados está atualmente em um estado de modo que o failover não possa ser emitido.

Exemplos

Failover an database

Sample Request

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.core.util.Context;
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, 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

Sample Response

Status code:

200

Status code:

202

Definições

ReplicaType

O tipo de réplica para failover.

Nome	Tipo	Description
Primary	string
ReadableSecondary	string