Replication Links - List By Database

Riferimento

Servizio:: SQL Database

Versione API:: 2023-08-01

Ottiene un elenco di collegamenti di replica nel database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager 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	ReplicationLinkListResult	È stato recuperato correttamente l'elenco dei collegamenti di replica.
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 i caricamenti del digest libro mastro e ripetere l'operazione. 400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto 400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio 404 ResourceNotFound: la risorsa richiesta non è stata trovata. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

Nome

Tipo

Descrizione

200 OK

ReplicationLinkListResult

È stato recuperato correttamente l'elenco dei collegamenti di replica.

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 i caricamenti del digest libro mastro e ripetere l'operazione.
400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto
400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio
404 ResourceNotFound: la risorsa richiesta non è stata trovata.
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

Esempio

List replication links on server on database.

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "properties": {
        "partnerServer": "testsvr",
        "partnerDatabase": "tetha-db",
        "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/tetha-db",
        "partnerLocation": "Japan East",
        "role": "Primary",
        "partnerRole": "Secondary",
        "replicationMode": "ASYNC",
        "startTime": "2018-06-21T08:11:46.907Z",
        "percentComplete": 100,
        "replicationState": "CATCH_UP",
        "isTerminationAllowed": true,
        "linkType": "GEO"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/tetha-db/replicationLinks/fb92de60-eb87-4a58-b250-3362d0cfdf26",
      "name": "fb92de60-eb87-4a58-b250-3362d0cfdf26"
    },
    {
      "properties": {
        "partnerServer": "targetsvr",
        "partnerDatabase": "tetha-db",
        "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/targetsvr/databases/tetha-db",
        "partnerLocation": "Japan East",
        "role": "Primary",
        "partnerRole": "Secondary",
        "replicationMode": "ASYNC",
        "startTime": "2018-06-21T08:11:34.423Z",
        "percentComplete": 100,
        "replicationState": "CATCH_UP",
        "isTerminationAllowed": true,
        "linkType": "GEO"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/tetha-db/replicationLinks/6ad1eefc-18a2-4fcb-94f3-4b654ba788d7",
      "name": "6ad1eefc-18a2-4fcb-94f3-4b654ba788d7"
    }
  ]
}

Definizioni

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

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ReplicationLink

Object

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 (int32)	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 (date-time)	Ora di creazione del collegamento.
type	string	Tipo di risorsa.

ReplicationLinkListResult

Object

Elenco di collegamenti di replica.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	ReplicationLink[]	Matrice di risultati.

ReplicationLinkType

Enumerazione

Tipo di collegamento (GEO, NAMED, STANDBY). L'operazione di aggiornamento non supporta NAMED.

Valore	Descrizione
GEO
NAMED
STANDBY

ReplicationRole

Enumerazione

Ruolo di replica locale.

Valore	Descrizione
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

Enumerazione

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

Valore	Descrizione
CATCH_UP
PENDING
SEEDING
SUSPENDED

Condividi tramite

Replication Links - List By Database

Parametri dell'URI

Risposte

Esempio

List replication links on server on database.

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkListResult

ReplicationLinkType

ReplicationRole

ReplicationState

Risorse aggiuntive