Replication Links - Failover Allow Data Loss

Esegue il failover dal server primario corrente al server che consente la perdita di dati.

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

Failover completato.

202 Accepted

L'operazione di failover è in corso.

Other Status Codes

Risposte di errore:

  • 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 digest libro mastro abilitati. Disabilitare caricamenti digest libro mastro e ripetere l'operazione.

  • 400 CannotUseTrailingWhitespacesInDatabaseName : convalida del nome del database non riuscita.

  • 400 GeoReplicationDatabaseNotSecondary: l'operazione prevede che il database sia una destinazione di replica.

  • 400 CannotUseReservedDatabaseName- Impossibile utilizzare il nome del database riservato in questa operazione.

  • 400 InvalidServerName - Nome server non valido specificato.

  • 400 PlannedFailoverTimedOut : l'utente ha richiamato failover pianificato e si è timeout durante il tentativo di 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- È stata eseguita un'operazione di seeding della replica in un database già presente in una relazione di replica.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - L'utente ha tentato di eseguire il failover o di terminare un collegamento geografico mentre il database secondario si trova in uno stato in cui potrebbe non essere fisicamente coerente e quindi non può immettere il ruolo primario.

  • 409 DuplicateGeoDrRelation: i database si trovano già in una relazione di replica. Si tratta di una richiesta duplicata.

  • 409 UpdateSloInProgress - L'utente ha tentato di avviare un'operazione incompatibile mentre era in corso un aggiornamento SLO.

  • 409 ManagementServiceDatabaseBusy - Il database '{0}' è occupato con un'altra operazione. Provare l'operazione in un secondo momento.

  • 409 ConflictingSystemOperationInProgress - È in corso un'operazione di manutenzione del sistema nel database e altre operazioni devono attendere il completamento.

  • 409 FailoverGroupAlreadySetup: l'operazione non può essere eseguita perché il collegamento di replica geografica fa parte di un gruppo di failover. È necessario rimuovere il database dal gruppo per terminare singolarmente o eseguire il failover.

  • 429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.

  • 503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Esempio di richiesta

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/forceFailoverAllowDataLoss?api-version=2021-11-01

Risposta di esempio

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

Definizioni

Nome Descrizione
ReplicationLink

Collegamento di replica.

ReplicationLinkType

Tipo di collegamento (GEO, NAMED, STANDBY).

ReplicationRole

Ruolo di replica locale.

ReplicationState

Stato della replica (IN SOSPESO, SEEDING, CATCHUP, SUSPENDED).

Collegamento di replica.

Nome Tipo Descrizione
id

string

ID risorsa.

name

string

Nome risorsa.

properties.isTerminationAllowed

boolean

Indica se l'utente è attualmente autorizzato a terminare il collegamento.

properties.linkType

ReplicationLinkType

Tipo di collegamento (GEO, NAMED, STANDBY).

properties.partnerDatabase

string

Database partner risorse.

properties.partnerLocation

string

Località partner risorse.

properties.partnerRole

ReplicationRole

Ruolo di replica del 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 della replica (IN SOSPESO, SEEDING, CATCHUP, SUSPENDED).

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 della replica (IN SOSPESO, SEEDING, CATCHUP, SUSPENDED).

Nome Tipo Descrizione
CATCH_UP

string

PENDING

string

SEEDING

string

SUSPENDED

string