Replication Links - Failover

Servizio:

SQL Database

Versione API:

2021-11-01

Viene eseguito il failover dal server primario corrente a questo server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2021-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
linkId	path	True	string	Nome del collegamento di replica.
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ReplicationLink	Impossibile eseguire correttamente il failover.
202 Accepted		L'operazione di failover è in corso.
Other Status Codes		Risposte agli errori: ** 400 ReplicationLinksReplicationLinkNameIsInvalid - Il nome del collegamento di replica deve essere un guid valido. 400 GeoReplicationDatabaseNotSecondary: l'operazione prevede che il database sia una destinazione di replica. 400 LedgerNoDropLink: non è possibile arrestare la replica geografica perché il database dispone di caricamenti del digest Ledger abilitato. Disabilitare i caricamenti del digest Ledger e riprovare l'operazione. 400 CannotUseTrailingWhitespacesInDatabaseName - La convalida del nome del database non è riuscita. 400 GeoReplicationDatabaseNotSecondary: l'operazione prevede che il database sia una destinazione di replica. 400 CannotUseReservedDatabaseName - Impossibile usare il nome del database riservato in questa operazione. 400 InvalidServerName - Nome server non valido specificato. 400 PlannedFailoverTimedOut : l'utente ha richiamato failover pianificato e ha provato a contattare il servizio di gestione dei partner. 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere unicode non valido. 400 IncorrectReplicationLinkState: l'operazione prevede che il database sia in uno stato previsto nel collegamento di replica. 404 OperationIdNotFound: l'operazione con ID non esiste. 404 ResourceNotFound : la risorsa richiesta non è stata trovata. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 OperationIdNotFound: l'operazione con ID non esiste. 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 409 OperationCancelled: l'operazione è stata annullata dall'utente. 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 409 InvalidOperationForDatabaseNotInReplicationRelationship : un'operazione di seeding della replica è stata eseguita in un database già in una relazione di replica. 409 GeoReplicationCannotBecomePrimaryDuringUndo - L'utente ha tentato di eseguire il failover o di terminare un collegamento geografico mentre il secondario è in uno stato in cui potrebbe non essere fisicamente coerente e quindi non può immettere il ruolo primario. 409 DuplicateGeoDrRelation: i database sono già in una relazione di replica. Si tratta di una richiesta duplicata. 409 UpdateSloInProgress : l'utente ha tentato di avviare un'operazione incompatibile durante l'esecuzione di un aggiornamento SLO. 409 ManagementServiceDatabaseBusy - Il database '{0}' è occupato con un'altra operazione. Provare l'operazione in un secondo momento. 409 ConflictingSystemOperationInProgress : un'operazione di manutenzione del sistema è in corso nel database e ulteriori operazioni devono attendere il completamento. 409 FailoverGroupAlreadySetup: l'operazione non può essere eseguita perché il collegamento alla replica geografica fa parte di un gruppo di failover. È necessario rimuovere il database dal gruppo per terminare o eseguire il failover singolarmente. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Planned failover of a replication link

Esempio di richiesta

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

/**
 * 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", com.azure.core.util.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

Risposta di esempio

Codice di stato:

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

Codice di stato:

202

Definizioni

Nome	Descrizione
ReplicationLink	Collegamento di replica.
ReplicationLinkType	Tipo di collegamento (GEO, NAMED, STANDBY).
ReplicationRole	Ruolo di replica locale.
ReplicationState	Stato di replica (IN SOSPESO, SEEDING, CATCHUP, SOSPESO).

ReplicationLink

Collegamento di replica.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.isTerminationAllowed	boolean	Se l'utente è attualmente autorizzato a terminare il collegamento.
properties.linkType	ReplicationLinkType	Tipo di collegamento (GEO, NAMED, STANDBY).
properties.partnerDatabase	string	Database partner delle risorse.
properties.partnerLocation	string	Posizione partner risorse.
properties.partnerRole	ReplicationRole	Ruolo di replica partner.
properties.partnerServer	string	Server partner risorse.
properties.percentComplete	integer	Percentuale di completamento del seeding per il collegamento.
properties.replicationMode	string	Modalità di replica.
properties.replicationState	ReplicationState	Stato di replica (IN SOSPESO, SEEDING, CATCHUP, SOSPESO).
properties.role	ReplicationRole	Ruolo di replica locale.
properties.startTime	string	Ora in cui è stato creato il collegamento.
type	string	Tipo di risorsa.

ReplicationLinkType

Tipo di collegamento (GEO, NAMED, STANDBY).

Nome	Tipo	Descrizione
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

Ruolo di replica locale.

Nome	Tipo	Descrizione
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Stato di replica (IN SOSPESO, SEEDING, CATCHUP, SOSPESO).

Nome	Tipo	Descrizione
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string