Replication Links - Failover

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Failover do servidor principal atual para este servidor.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/failover?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.
linkId
 path True

string

O nome do link de replicação.
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.

Respostas

Nome Tipo Description
200 OK

ReplicationLink

Failover com êxito.
202 Accepted

A operação de failover está em andamento.
Other Status Codes

Respostas de erro: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid – o nome do link de replicação deve ser um guid válido.

  • 400 GeoReplicationDatabaseNotSecondary – a operação espera que o banco de dados seja um destino de replicação.

  • 400 LedgerNoDropLink – A replicação geográfica não pode ser interrompida porque o banco de dados tem uploads do Ledger Digest habilitados. Desabilite uploads do Ledger Digest e repita a operação.

  • 400 CannotUseTrailingWhitespacesInDatabaseName – Falha na validação do nome do banco de dados.

  • 400 GeoReplicationDatabaseNotSecondary – a operação espera que o banco de dados seja um destino de replicação.

  • 400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação.

  • 400 InvalidServerName - Nome do servidor inválido especificado.

  • 400 PlannedFailoverTimedOut - O usuário invocou recuperação panejada e atingiu o tempo limite ao tentar entrar em contato com o serviço de gerenciamento de parceiros.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.

  • 400 IncorrectReplicationLinkState - A operação espera que o banco de dados esteja em um estado esperado no link de replicação.

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

  • 404 ResourceNotFound – O recurso solicitado não foi encontrado.

  • 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.

  • 404 DatabaseDoesNotExist – o usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

  • 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.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Uma operação de propagação de replicação foi executada em um banco de dados que já está em uma relação de replicação.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – O usuário tentou fazer failover ou forçar o término de um link geográfico enquanto o secundário está em um estado em que pode não ser fisicamente consistente e, portanto, não pode entrar na função primária.

  • 409 DuplicateGeoDrRelation – Os bancos de dados já estão em uma relação de replicação. Essa é uma solicitação duplicada.

  • 409 UpdateSloInProgress – o usuário tentou iniciar uma operação incompatível enquanto uma atualização slo estava em andamento.

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

  • 409 ConflictingSystemOperationInProgress – Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam aguardar até que ele seja concluído.

  • 409 FailoverGroupAlreadySetup – A operação não pode ser executada porque o link de replicação geográfica faz parte de um Grupo de Failover. Você deve remover o banco de dados do grupo para terminar ou fazer failover individualmente.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas 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 executar a operação novamente.

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

Exemplos

Solicitação de exemplo

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2021-11-01

Resposta de exemplo

Código de status:
200 
{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}
Código de status:
202

Definições

Nome Description
ReplicationLink

Um link de replicação.
ReplicationLinkType

Tipo de link (GEO, NAMED, STANDBY).
ReplicationRole

Função de replicação local.
ReplicationState

Estado de replicação (PENDENTE, PROPAGAÇÃO, CATCHUP, SUSPENSO).

Um link de replicação.

Nome Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.isTerminationAllowed

boolean

Se o usuário tem permissão para encerrar o link no momento.
properties.linkType

ReplicationLinkType

Tipo de link (GEO, NAMED, STANDBY).
properties.partnerDatabase

string

Banco de dados do parceiro de recurso.
properties.partnerLocation

string

Local do parceiro de recurso.
properties.partnerRole

ReplicationRole

Função de replicação de parceiro.
properties.partnerServer

string

Servidor de parceiro de recurso.
properties.percentComplete

integer

Percentual de conclusão de propagação para o link.
properties.replicationMode

string

Modo de replicação.
properties.replicationState

ReplicationState

Estado de replicação (PENDENTE, PROPAGAÇÃO, CATCHUP, SUSPENSO).
properties.role

ReplicationRole

Função de replicação local.
properties.startTime

string

Hora em que o link foi criado.
type

string

Tipo de recurso.

ReplicationLinkType

Tipo de link (GEO, NAMED, STANDBY).

Nome Tipo Description
GEO

string

NAMED

string

STANDBY

string

ReplicationRole

Função de replicação local.

Nome Tipo Description
Copy

string

NonReadableSecondary

string

Primary

string

Secondary

string

Source

string

ReplicationState

Estado de replicação (PENDENTE, PROPAGAÇÃO, CATCHUP, SUSPENSO).

Nome Tipo Description
CATCH_UP

string

PENDING

string

SEEDING

string

SUSPENDED

string