Replication Links - Update

Service:

SQL Database

API Version:

2023-08-01-preview

Updates den Replikationslinktyp.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
linkId	path	True	string
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.linkType	ReplicationLinkType	Linktyp (GEO, NAMED, STANDBY). Der Updatevorgang unterstützt NAMED nicht.

Antworten

Name	Typ	Beschreibung
200 OK	ReplicationLink	Der Replikationslink wurde erfolgreich aktualisiert.
202 Accepted		Der Aktualisierungsvorgang wird ausgeführt.
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 ReplicationLinksReplicationLinkNameIsInvalid: Der Name des Replikationslinks sollte eine gültige GUID sein. 400 GeoReplicationDatabaseNotSecondary: Der Vorgang erwartet, dass die Datenbank ein Replikationsziel ist. 400 ReplicationLinkLinkTypeIsInvalid: Der LinkType ist ungültig. Gültige Werte sind STANDBY und GEO. 400 ReplicationLinksCreateIsNotSupported: Das Erstellen von Replikationslinks wird nicht unterstützt. 400 LedgerNoDropLink: Die Georeplikation kann nicht beendet werden, da für die Datenbank Ledger Digest Uploads aktiviert ist. Deaktivieren Sie Ledger Digest Uploads, und wiederholen Sie den Vorgang. 400 CannotUseTrailingWhitespacesInDatabaseName: Fehler bei der Überprüfung des Datenbanknamens. 400 GeoReplicationDatabaseNotSecondary: Der Vorgang erwartet, dass die Datenbank ein Replikationsziel ist. 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave: Das Konfigurieren der Georeplikation wird für Datenbanken, die unterschiedliche Werte der bevorzugtenEnclaveType-Eigenschaft verwenden, nicht unterstützt. Die primäre "{0}" Datenbank auf dem "{1}"-Server verwendet den{2} bevorzugtenEnclaveType, während der angegebene bevorzugteEnclaveType für die sekundäre "{3}" Datenbank auf dem "{4}" Server "" ""{5} ist. 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes: Geplantes Failover zwischen der primären und sekundären Datenbank mit unterschiedlichen bevorzugten EnclaveType wird für VBS-Enclaves (Virtualization-Based Security) nicht unterstützt. 400 CannotUseReservedDatabaseName: Der name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden. 400 InvalidServerName: Ungültiger Servername angegeben. 400 PlannedFailoverTimedOut: Der Benutzer hat geplanter Failover aufgerufen und beim Versuch, den Partnerverwaltungsdienst zu kontaktieren, ein Timeout ausgelöst. 400 InvalidIdentifier: Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen. 400 IncorrectReplicationLinkState: Der Vorgang erwartet, dass sich die Datenbank im Replikationslink in einem erwarteten Zustand befindet. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist. 409 CannotCancelOperation: Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 409 InvalidOperationForDatabaseNotInReplicationRelationship: Ein Replikationsvorgang wurde für eine Datenbank ausgeführt, die sich nicht in einer Replikationsbeziehung befindet. 409 GeoReplicationCannotBecomePrimaryDuringUndo: Der Benutzer hat versucht, ein Failover oder das Beenden eines Geolinks zu erzwingen, während sich die sekundäre Verbindung in einem Zustand befindet, in dem sie möglicherweise nicht physisch konsistent ist und daher nicht in die primäre Rolle eintreten kann. 409 DuplicateGeoDrRelation: Die Datenbanken befinden sich bereits in einer Replikationsbeziehung. Dies ist eine doppelte Anforderung. 409 UpdateSloInProgress: Der Benutzer hat versucht, einen inkompatiblen Vorgang zu initiieren, während ein SLO-Update ausgeführt wurde. 409 ManagementServiceDatabaseBusy : Datenbank "{0}" ist mit einem anderen Vorgang beschäftigt. Versuchen Sie ihren Vorgang später. 409 ConflictingSystemOperationInProgress: Ein Systemwartungsvorgang für die Datenbank wird ausgeführt, und weitere Vorgänge müssen warten, bis er abgeschlossen ist. 409 FailoverGroupAlreadySetup: Der Vorgang kann nicht ausgeführt werden, da der Georeplikationslink Teil einer Failovergruppe ist. Sie müssen die Datenbank aus der Gruppe entfernen, um einzeln zu beenden oder ein Failover durchzuführen. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

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

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
ReplicationLink	Ein Replikationslink.
ReplicationLinkType	Linktyp (GEO, NAMED, STANDBY). Der Updatevorgang unterstützt NAMED nicht.
ReplicationLinkUpdate	Eine Aktualisierungsanforderung für Replikationslinks.
ReplicationRole	Lokale Replikationsrolle.
ReplicationState	Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ReplicationLink

Ein Replikationslink.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.isTerminationAllowed	boolean	Gibt an, ob der Benutzer derzeit berechtigt ist, den Link zu beenden.
properties.linkType	ReplicationLinkType	Linktyp (GEO, NAMED, STANDBY). Der Updatevorgang unterstützt NAMED nicht.
properties.partnerDatabase	string	Ressourcenpartnerdatenbank.
properties.partnerDatabaseId	string	Ressourcenpartnerdatenbank-ID.
properties.partnerLocation	string	Standort des Ressourcenpartners.
properties.partnerRole	ReplicationRole	Partnerreplikationsrolle.
properties.partnerServer	string	Ressourcenpartnerserver.
properties.percentComplete	integer	Prozentsatz der Seeding-Vervollständigung für den Link.
properties.replicationMode	string	Replikationsmodus.
properties.replicationState	ReplicationState	Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Lokale Replikationsrolle.
properties.startTime	string	Zeitpunkt, zu dem der Link erstellt wurde.
type	string	Der Ressourcentyp.

ReplicationLinkType

Linktyp (GEO, NAMED, STANDBY). Der Updatevorgang unterstützt NAMED nicht.

Name	Typ	Beschreibung
GEO	string
NAMED	string
STANDBY	string

ReplicationLinkUpdate

Eine Aktualisierungsanforderung für Replikationslinks.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.linkType	ReplicationLinkType	Linktyp (GEO, NAMED, STANDBY). Der Updatevorgang unterstützt NAMED nicht.
type	string	Der Ressourcentyp.

ReplicationRole

Lokale Replikationsrolle.

Name	Typ	Beschreibung
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).

Name	Typ	Beschreibung
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string