Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Efetua a ativação pós-falha de uma base 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 do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados para ativação pós-falha.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.
replicaType	query		ReplicaType	O tipo de réplica a ser efetuar a ativação pós-falha.

Respostas

Name	Tipo	Description
200 OK		Ativação pós-falha da base de dados concluída com êxito.
202 Accepted		A ativação pós-falha da base de dados está em curso.
Other Status Codes		Respostas de Erro: *** 400 ManagementServiceFeatureDisabled – o utilizador tentou utilizar uma funcionalidade que está desativada. 400 DatabaseFailoverThrottled – ocorreu uma ativação pós-falha recente na base de dados ou conjunto se a base de dados pertencer a um conjunto elástico. 400 DatabaseFailoverNotSupportedOnSKU – este tipo de ativação pós-falha iniciada pelo cliente não é suportado no SKU especificado. 409 ManagementServiceDatabaseBusy - A base de dados "{0}" está ocupada com outra operação. Tente a operação mais tarde. 409 DatabaseNotInStateToFailover – a base de dados está atualmente num estado em que não é possível emitir a ativação pós-falha.

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 a ser efetuar a ativação pós-falha.

Name	Tipo	Description
Primary	string
ReadableSecondary	string