Replication Links - Failover

Service:

SQL Database

API Version:

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

Planned failover of a replication link

Sample Request

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=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for ReplicationLinks Failover. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailover.json
     */
    /**
     * Sample code: Planned failover of a replication link.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failover("Default", "sourcesvr", "gamma-db",
            "4891ca10-ebd0-47d7-9182-c722651780fb", 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

{
  "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"
}

Status code:

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

ReplicationLink

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