Replication Links - Update

Service:

SQL Database

API Version:

2023-08-01-preview

Aggiornamenti il tipo di collegamento di replica.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}?api-version=2023-08-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
linkId	path	True	string
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.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.linkType	ReplicationLinkType	Tipo di collegamento (GEO, NAMED, STANDBY). L'operazione di aggiornamento non supporta NAMED.

Risposte

Nome	Tipo	Descrizione
200 OK	ReplicationLink	Aggiornamento corretto del collegamento di replica.
202 Accepted		L'operazione di aggiornamento è in corso.
Other Status Codes	ErrorResponse	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 ReplicationLinksReplicationLinkTypeIsInvalid- LinkType non valido. I valori validi sono STANDBY e GEO. 400 ReplicationLinksCreateIsNotSupported: la creazione del collegamento di replica non è supportata. 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 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave: la configurazione della replica geografica non è supportata per i database che usano valori diversi della proprietà preferredEnclaveType. Il database primario '{0}' nel server '{1}' utilizza il valore preferredEnclaveType{2}, mentre il valore preferredEnclaveType specificato per il database secondario '{3}' nel server '{4}' è '{5}'. 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes- Failover pianificato tra database primario e secondario con un valore preferredEnclaveType diverso non è supportato per le enclave di sicurezza basata su virtualizzazione (VBS). 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 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 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato. 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 replica è stata eseguita su un database che non si trova 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

Update Replication Link

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/00000000-1111-2222-3333-666666666666?api-version=2023-08-01-preview

{
  "properties": {
    "linkType": "STANDBY"
  }
}

Sample Response

Status code:

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": "STANDBY"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "00000000-1111-2222-3333-666666666666"
}

Status code:

202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/replicationLinksOperationResults/11111111-1111-1111-1111-111111111111

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ReplicationLink	Collegamento di replica.
ReplicationLinkType	Tipo di collegamento (GEO, NAMED, STANDBY). L'operazione di aggiornamento non supporta NAMED.
ReplicationLinkUpdate	Richiesta di aggiornamento dei collegamenti di replica.
ReplicationRole	Ruolo di replica locale.
ReplicationState	Stato della replica (IN SOSPESO, SEEDING, CATCHUP, SUSPENDED).

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ReplicationLink

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). L'operazione di aggiornamento non supporta NAMED.
properties.partnerDatabase	string	Database partner risorse.
properties.partnerDatabaseId	string	ID 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). L'operazione di aggiornamento non supporta NAMED.

Nome	Tipo	Descrizione
GEO	string
NAMED	string
STANDBY	string

ReplicationLinkUpdate

Richiesta di aggiornamento dei collegamenti di replica.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.linkType	ReplicationLinkType	Tipo di collegamento (GEO, NAMED, STANDBY). L'operazione di aggiornamento non supporta NAMED.
type	string	Tipo di risorsa.

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