Replication Links - Failover

Dienst:

SQL Database

API-Version:

2021-11-01

Führt ein Failover vom aktuellen primären Server auf diesen Server durch.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
linkId	path	True	string	Der Name des Replikationslinks.
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.

Antworten

Name	Typ	Beschreibung
200 OK	ReplicationLink	Fehler beim Überlauf erfolgreich.
202 Accepted		Der Failovervorgang wird ausgeführt.
Other Status Codes		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 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 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 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 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 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: Für eine Datenbank, die sich bereits in einer Replikationsbeziehung befindet, wurde ein Replikations seeding-Vorgang ausgeführt. 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

Planned failover of a replication link

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

202

Definitionen

Name	Beschreibung
ReplicationLink	Ein Replikationslink.
ReplicationLinkType	Linktyp (GEO, NAMED, STANDBY).
ReplicationRole	Lokale Replikationsrolle.
ReplicationState	Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).

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).
properties.partnerDatabase	string	Ressourcenpartnerdatenbank.
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).

Name	Typ	Beschreibung
GEO	string
NAMED	string
STANDBY	string

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