Replication Links - Failover

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

Efetua a ativação pós-falha do servidor primário 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 do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome da base de dados.
linkId
 path True

string

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

Respostas

Name Tipo Description
200 OK

ReplicationLink

Ativação pós-falha com êxito.
202 Accepted

A operação de ativação pós-falha está em curso.
Other Status Codes

Respostas de Erro: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid - O nome da ligação de replicação deve ser um guid válido.

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

  • 400 LedgerNoDropLink - Não é possível parar a georreplicação porque a base de dados tem Carregamentos de Resumo do Ledger ativados. Desative Carregamentos de Resumo do Livro Razão e repita a operação.

  • 400 CannotUseTrailingWhitespacesInDatabaseName – A validação do nome da base de dados falhou.

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

  • 400 CannotUseReservedDatabaseName – não é possível utilizar o nome da base de dados reservada nesta operação.

  • 400 InvalidServerName – nome de servidor inválido especificado.

  • 400 PlannedFailoverTimedOut – o utilizador invocou failover planeado e excedeu o limite de tempo ao tentar contactar o serviço de gestão de parceiros.

  • 400 InvalidIdentifier – o identificador contém NULL ou um caráter unicode inválido.

  • 400 IncorrectReplicationLinkState – a operação espera que a base de dados esteja num estado esperado na ligação de replicação.

  • 404 OperationIdNotFound – a operação com o ID não existe.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

  • 404 OperationIdNotFound – a operação com o ID não existe.

  • 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor.

  • 409 OperationCancelled - A operação foi cancelada pelo utilizador.

  • 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – foi executada uma operação de propagação de replicação numa base de dados que já se encontra numa relação de replicação.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – o utilizador tentou efetuar a ativação pós-falha ou forçar o encerramento de uma ligação geográfica enquanto a secundária se encontra num estado em que pode não ser fisicamente consistente e, por isso, não pode introduzir a função primária.

  • 409 DuplicateGeoDrRelation – as bases de dados já estão numa relação de replicação. Este é um pedido duplicado.

  • 409 UpdateSloInProgress – o utilizador tentou iniciar uma operação incompatível enquanto uma atualização do SLO estava em curso.

  • 409 ManagementServiceDatabaseBusy – A base de dados "{0}" está ocupada com outra operação. Tente a operação mais tarde.

  • 409 ConflictingSystemOperationInProgress – uma operação de manutenção do sistema está em curso na base de dados e as operações adicionais têm de aguardar até que seja concluída.

  • 409 FailoverGroupAlreadySetup – não é possível executar a operação porque a ligação de georreplicação faz parte de um Grupo de Ativação Pós-falha. Tem de remover a base de dados do grupo para terminar individualmente ou efetuar a ativação pós-falha.

  • 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.

  • 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Pedido de amostra

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 da amostra

Código de estado:
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 estado:
202

Definições

Name Description
ReplicationLink

Uma ligação de replicação.
ReplicationLinkType

Tipo de ligação (GEO, COM NOME, STANDBY).
ReplicationRole

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

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

Uma ligação de replicação.

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.isTerminationAllowed

boolean

Se o utilizador está atualmente autorizado a terminar a ligação.
properties.linkType

ReplicationLinkType

Tipo de ligação (GEO, COM NOME, STANDBY).
properties.partnerDatabase

string

Base de dados de parceiros de recursos.
properties.partnerLocation

string

Localização do parceiro de recursos.
properties.partnerRole

ReplicationRole

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

string

Servidor de parceiro de recursos.
properties.percentComplete

integer

Percentagem de conclusão da propagação da ligação.
properties.replicationMode

string

Modo de replicação.
properties.replicationState

ReplicationState

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

ReplicationRole

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

string

Hora em que a ligação foi criada.
type

string

Tipo de recurso.

ReplicationLinkType

Tipo de ligação (GEO, COM NOME, STANDBY).

Name Tipo Description
GEO

string

NAMED

string

STANDBY

string

ReplicationRole

Função de replicação local.

Name Tipo Description
Copy

string

NonReadableSecondary

string

Primary

string

Secondary

string

Source

string

ReplicationState

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

Name Tipo Description
CATCH_UP

string

PENDING

string

SEEDING

string

SUSPENDED

string