Compartilhar via

Databases - Failover

  • Referência
Serviço:
SQL Database
Versão da API:
2023-08-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=2023-08-01
Com parâmetros opcionais: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-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 na API do Azure Resource Manager ou no portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID da 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 a ser substituída por 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.

Cabeçalhos

Location: string
Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 DatabaseFailoverNotSupportedOnSKU – Não há suporte para esse tipo de failover iniciado pelo cliente na SKU fornecida.

  • 400 DatabaseFailoverThrottled - Houve um failover recente no banco de dados ou pool se o banco de dados pertence a um pool elástico.

  • 400 ManagementServiceFeatureDisabled – O usuário tentou usar um recurso que está desabilitado.

  • 404 OperationIdNotFound – A operação com id não existe.

  • 409 DatabaseNotInStateToFailover – O banco de dados está atualmente em um estado para que o failover não possa ser emitido.

  • 409 ManagementServiceDatabaseBusy – O banco de dados '{0}' está ocupado com outra operação. Tente sua operação mais tarde.

  • 409 CannotCancelOperation – A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 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 das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut – A operação atingiu o tempo limite e foi revertida automaticamente. Tente novamente a operação.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Failover an database

Solicitação de exemplo

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=2023-08-01

Resposta de exemplo

Código de status:
200
Código de status:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

Definições

Nome Description
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
ReplicaType

O tipo de réplica a ser substituída por failover.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ReplicaType

Enumeração

O tipo de réplica a ser substituída por failover.

Valor Description
Primary
ReadableSecondary