Replication Links - Failover

Referência

Serviço:: SQL Database

Versão da API:: 2023-08-01

Faz failover 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=2023-08-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 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.

Respostas

Nome	Tipo	Description
200 OK	ReplicationLink	Falha com êxito.
202 Accepted		A operação de failover está em andamento. Cabeçalhos Location: string
Other Status Codes	ErrorResponse	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 ReplicationLinksReplicationLinkTypeIsInvalid – o LinkType é inválido. Os valores válidos são STANDBY e GEO. 400 ReplicationLinksCreateIsNotSupported – Não há suporte para a criação do Link 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 InvalidServerName – Nome do servidor inválido especificado. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 400 TokenTooLong – O token fornecido é muito longo. 400 ManagedInstanceStoppingOrStopped – Operação conflitante enviada enquanto a instância está no estado de parada/parada 400 ManagedInstanceStarting – Operação conflitante enviada enquanto a instância está no estado inicial 400 InvalidServerName – Nome do servidor inválido especificado. 400 GeoReplicationDatabaseNotSecondary - A operação espera que o banco de dados seja um destino de replicação. 400 CannotUseTrailingWhitespacesInDatabaseName – Falha na validação do nome do banco de dados. 400 IncorrectReplicationLinkState - A operação espera que o banco de dados esteja em um estado esperado no link de replicação. 400 PlannedFailoverTimedOut – O usuário invocou o failover planejado e atingiu o tempo limite ao tentar entrar em contato com o serviço de gerenciamento de parceiros. 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave – Não há suporte para configurar a replicação geográfica para bancos de dados usando valores diferentes da propriedade PreferredEnclaveType. O banco de dados '{0}' primário no servidor '{1}' usa o '{2}' preferredEnclaveType, enquanto o PreferencialEnclaveType especificado para o banco de dados secundário '{3}' no servidor '{4}' é '{5}'. 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes – Não há suporte para failover planejado entre o banco de dados primário e secundário com diferentes preferenciaisEnclaveType para enclaves de VBS (segurança baseada em virtualização). 400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 404 OperationIdNotFound – A operação com id não existe. 404 ResourceNotFound – O recurso solicitado não foi encontrado. 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 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 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. 409 UpdateSloInProgress – O usuário tentou iniciar uma operação incompatível enquanto uma atualização slo estava em andamento. 409 InvalidOperationForDatabaseNotInReplicationRelationship – Uma operação de replicação foi executada em um banco de dados que não está em uma relação de replicação. 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 DuplicateGeoDrRelation – Os bancos de dados já estão em uma relação de replicação. Essa é uma solicitação duplicada. 409 GeoReplicationCannotBecomePrimaryDuringUndo – O usuário tentou fazer failover ou forçar o término de um vínculo geográfico enquanto o secundário está em um estado em que ele pode não ser fisicamente consistente e, portanto, não pode entrar na função primária. 409 ManagementServiceDatabaseBusy – O banco de dados '{0}' está ocupado com outra operação. Tente sua operação mais tarde. 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 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.

Nome

Tipo

Description

200 OK

ReplicationLink

Falha com êxito.

202 Accepted

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

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

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 ReplicationLinksReplicationLinkTypeIsInvalid – o LinkType é inválido. Os valores válidos são STANDBY e GEO.
400 ReplicationLinksCreateIsNotSupported – Não há suporte para a criação do Link 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 InvalidServerName – Nome do servidor inválido especificado.
400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.
400 TokenTooLong – O token fornecido é muito longo.
400 ManagedInstanceStoppingOrStopped – Operação conflitante enviada enquanto a instância está no estado de parada/parada
400 ManagedInstanceStarting – Operação conflitante enviada enquanto a instância está no estado inicial
400 InvalidServerName – Nome do servidor inválido especificado.
400 GeoReplicationDatabaseNotSecondary - A operação espera que o banco de dados seja um destino de replicação.
400 CannotUseTrailingWhitespacesInDatabaseName – Falha na validação do nome do banco de dados.
400 IncorrectReplicationLinkState - A operação espera que o banco de dados esteja em um estado esperado no link de replicação.
400 PlannedFailoverTimedOut – O usuário invocou o failover planejado e atingiu o tempo limite ao tentar entrar em contato com o serviço de gerenciamento de parceiros.
400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave – Não há suporte para configurar a replicação geográfica para bancos de dados usando valores diferentes da propriedade PreferredEnclaveType. O banco de dados '{0}' primário no servidor '{1}' usa o '{2}' preferredEnclaveType, enquanto o PreferencialEnclaveType especificado para o banco de dados secundário '{3}' no servidor '{4}' é '{5}'.
400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes – Não há suporte para failover planejado entre o banco de dados primário e secundário com diferentes preferenciaisEnclaveType para enclaves de VBS (segurança baseada em virtualização).
400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação.
400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.
404 OperationIdNotFound – A operação com id não existe.
404 ResourceNotFound – O recurso solicitado não foi encontrado.
404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.
404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado
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 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.
409 UpdateSloInProgress – O usuário tentou iniciar uma operação incompatível enquanto uma atualização slo estava em andamento.
409 InvalidOperationForDatabaseNotInReplicationRelationship – Uma operação de replicação foi executada em um banco de dados que não está em uma relação de replicação.
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 DuplicateGeoDrRelation – Os bancos de dados já estão em uma relação de replicação. Essa é uma solicitação duplicada.
409 GeoReplicationCannotBecomePrimaryDuringUndo – O usuário tentou fazer failover ou forçar o término de um vínculo geográfico enquanto o secundário está em um estado em que ele pode não ser fisicamente consistente e, portanto, não pode entrar na função primária.
409 ManagementServiceDatabaseBusy – O banco de dados '{0}' está ocupado com outra operação. Tente sua operação mais tarde.
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 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

Planned failover of a replication link

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/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

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/replicationLinksOperationResults/replicationlink-group-test-3?api-version=2022-05-01-preview

Definições

Nome	Description
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ReplicationLink	Um link de replicação.
ReplicationLinkType	Tipo de link (GEO, NAMED, STANDBY). A operação de atualização não dá suporte a NAMED.
ReplicationRole	Função de replicação local.
ReplicationState	Estado de replicação (PENDENTE, PROPAGAÇÃO, CATCHUP, SUSPENSO).

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.

ReplicationLink

Objeto

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). A operação de atualização não dá suporte a NAMED.
properties.partnerDatabase	string	Banco de dados do parceiro de recurso.
properties.partnerDatabaseId	string	ID do 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 do parceiro de recurso.
properties.percentComplete	integer (int32)	Percentual de conclusão da 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 (date-time)	Hora em que o link foi criado.
type	string	Tipo de recurso.

ReplicationLinkType

Enumeração

Tipo de link (GEO, NAMED, STANDBY). A operação de atualização não dá suporte a NAMED.

Valor	Description
GEO
NAMED
STANDBY

ReplicationRole

Enumeração

Função de replicação local.

Valor	Description
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

Enumeração

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

Valor	Description
CATCH_UP
PENDING
SEEDING
SUSPENDED

Compartilhar via

Replication Links - Failover

Parâmetros de URI

Respostas

Exemplos

Planned failover of a replication link

Solicitação de exemplo

Resposta de exemplo

Definições

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

Recursos adicionais