Freigeben über

Replication Links - Failover Allow Data Loss

  • Referenz
Dienst:
SQL Database
API-Version:
2023-08-01

Schlägt vom aktuellen primären Server auf diesen Server fehl, sodass Datenverlust möglich ist.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
 path True

string

Der Name der Datenbank.
linkId
 path True

string

Der Name der Replikationsverbindung.
resourceGroupName
 path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName
 path True

string

Der Name des Servers.
subscriptionId
 path True

string

Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version
 query True

string

Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

ReplicationLink

Fehler beim Überschreiben.
202 Accepted

Failovervorgang wird ausgeführt.

Header

Location: string
Other Status Codes

ErrorResponse

Fehlerantworten: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid – Name des Replikationslinks sollte eine gültige GUID sein.

  • 400 GeoReplicationDatabaseNotSecondary – Der Vorgang erwartet, dass die Datenbank ein Replikationsziel ist.

  • 400 ReplicationLinksReplicationLinkTypeIsInvalid – Der LinkType ist ungültig. Gültige Werte sind STANDBY und GEO.

  • 400 ReplicationLinksCreateIsNotSupported – Erstellung der Replikationsverknüpfung wird nicht unterstützt.

  • 400 LedgerNoDropLink - Georeplikation kann nicht beendet werden, da die Datenbank Ledger Digest Uploads aktiviert hat. Deaktivieren Sie Ledger Digest Uploads, und wiederholen Sie den Vorgang.

  • 400 InvalidServerName – Ungültiger Servername angegeben.

  • 400 InvalidIdentifier – Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen.

  • 400 TokenTooLong – Das bereitgestellte Token ist zu lang.

  • 400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird

  • 400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt

  • 400 InvalidServerName – Ungültiger Servername angegeben.

  • 400 GeoReplicationDatabaseNotSecondary – Der Vorgang erwartet, dass die Datenbank ein Replikationsziel ist.

  • 400 CannotUseTrailingWhitespacesInDatabaseName – Fehler bei der Überprüfung des Datenbanknamens.

  • 400 IncorrectReplicationLinkState – Der Vorgang erwartet, dass sich die Datenbank in einem erwarteten Zustand auf der Replikationsverknüpfung befindet.

  • 400 PlannedFailoverTimedOut – Der Benutzer hat ein geplantes Failover aufgerufen, und es wurde beim Versuch, sich an den Partnerverwaltungsdienst zu wenden, timeout.

  • 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave – Das Konfigurieren der Georeplikation wird für Datenbanken mit unterschiedlichen Werten der bevorzugtenEnclaveType-Eigenschaft nicht unterstützt. Die primäre '{0}' Datenbank auf dem '{1}' Server verwendet den '{2}' preferredEnclaveType, während der angegebene bevorzugteEnclaveType für die sekundäre '{3}' Datenbank auf dem '{4}' Server ' ist '{5}'.

  • 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes – Geplantes Failover zwischen primärer und sekundärer Datenbank mit verschiedenen bevorzugtenEnclaveType wird für Virtualisierungsbasierte Sicherheit (VBS) Enklaven nicht unterstützt.

  • 400 CannotUseReservedDatabaseName – In diesem Vorgang kann kein reservierter Datenbankname verwendet werden.

  • 400 InvalidIdentifier – Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen.

  • 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.

  • 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz 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, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde.

  • 409 UpdateSloInProgress – Der Benutzer hat versucht, einen inkompatiblen Vorgang zu initiieren, während ein SLO-Update ausgeführt wurde.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Ein Replikationsvorgang wurde für eine Datenbank ausgeführt, die sich nicht in einer Replikationsbeziehung befindet.

  • 409 ConflictingSystemOperationInProgress – Ein Systemwartungsvorgang wird für die Datenbank ausgeführt, und weitere Vorgänge müssen warten, bis sie abgeschlossen ist.

  • 409 DuplicateGeoDrRelation - Die Datenbanken befinden sich bereits in einer Replikationsbeziehung. Dies ist eine doppelte Anforderung.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – Der Benutzer hat versucht, eine Geoverknüpfung zu failovern oder 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 ManagementServiceDatabaseBusy - Datenbank '{0}' ist mit einem anderen Vorgang beschäftigt. Versuchen Sie es bitte später.

  • 409 FailoverGroupAlreadySetup – Der Vorgang kann nicht ausgeführt werden, da die Georeplikationsverknüpfung Teil einer Failovergruppe ist. Sie müssen die Datenbank aus der Gruppe entfernen, um die Datenbank einzeln zu beenden oder failovern zu können.

  • 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut.

  • 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Beispielanforderung

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=2023-08-01

Beispiel für eine Antwort

Statuscode:
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": "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 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/replicationLinksOperationResults/replicationlink-group-test-3?api-version=2022-05-01-preview

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort
ReplicationLink

Eine Replikationsverbindung.
ReplicationLinkType

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

Lokale Replikationsrolle.
ReplicationState

Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.
Objekt

Eine Replikationsverbindung.

Name Typ Beschreibung
id

string

Ressourcen-ID.
name

string

Ressourcenname.
properties.isTerminationAllowed

boolean

Gibt an, ob der Benutzer den Link zurzeit beenden darf.
properties.linkType

ReplicationLinkType

Linktyp (GEO, NAMED, STANDBY). Der Aktualisierungsvorgang 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 (int32)

Prozentsatz der Seeding-Fertigstellung für den Link.
properties.replicationMode

string

Replikationsmodus.
properties.replicationState

ReplicationState

Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).
properties.role

ReplicationRole

Lokale Replikationsrolle.
properties.startTime

string (date-time)

Zeitpunkt, zu dem der Link erstellt wurde.
type

string

Ressourcentyp.

ReplicationLinkType

Enumeration

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

Wert Beschreibung
GEO
NAMED
STANDBY

ReplicationRole

Enumeration

Lokale Replikationsrolle.

Wert Beschreibung
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

Enumeration

Replikationsstatus (AUSSTEHEND, SEEDING, CATCHUP, SUSPENDED).

Wert Beschreibung
CATCH_UP
PENDING
SEEDING
SUSPENDED