Udostępnij za pośrednictwem


Replication Links - Failover

W trybie failover z bieżącego serwera podstawowego do tego serwera.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
databaseName
path True

string

Nazwa bazy danych.

linkId
path True

string

Nazwa łącza replikacji.

resourceGroupName
path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True

string

Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Nazwa Typ Opis
200 OK

ReplicationLink

Pomyślnie przełączono w tryb failover.

202 Accepted

Operacja trybu failover jest w toku.

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid — nazwa łącza replikacji powinna być prawidłowym identyfikatorem GUID.

  • 400 GeoReplicationDatabaseNotSecondary — operacja oczekuje, że baza danych będzie obiektem docelowym replikacji.

  • 400 LedgerNoDropLink — nie można zatrzymać replikacji geograficznej, ponieważ baza danych ma włączone przekazywanie skrótów rejestru. Wyłącz przekazywanie skrótów rejestru i spróbuj ponownie wykonać operację.

  • 400 CannotUseTrailingWhitespacesInDatabaseName — sprawdzanie poprawności nazwy bazy danych nie powiodło się.

  • 400 GeoReplicationDatabaseNotSecondary — operacja oczekuje, że baza danych będzie obiektem docelowym replikacji.

  • 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji.

  • 400 InvalidServerName — podano nieprawidłową nazwę serwera.

  • 400 PlannedFailoverTimedOut — użytkownik wywołał planowane przełączanie awaryjne i upłynął limit czasu podczas próby skontaktowania się z usługą zarządzania partnerem.

  • 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode.

  • 400 IncorrectReplicationLinkState — operacja oczekuje, że baza danych będzie w oczekiwanym stanie linku replikacji.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship — operacja rozmieszczania replikacji została wykonana w bazie danych, która jest już w relacji replikacji.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo — użytkownik próbował przejść w tryb failover lub wymusić przerwanie łącza geograficznego, gdy pomocnicza jest w stanie, w którym może nie być fizycznie spójna i dlatego nie może wprowadzić roli głównej.

  • 409 DuplicateGeoDrRelation — bazy danych są już w relacji replikacji. Jest to zduplikowane żądanie.

  • 409 UpdateSloInProgress — użytkownik próbował zainicjować niezgodną operację, gdy aktualizacja SLO była w toku.

  • 409 ManagementServiceDatabaseBusy — baza danych "{0}" jest zajęta inną operacją. Spróbuj wykonać operację później.

  • 409 ConflictingSystemOperationInProgress — trwa operacja konserwacji systemu w bazie danych i dalsze operacje muszą czekać, aż zostanie ukończona.

  • 409 FailoverGroupAlreadySetup — nie można wykonać operacji, ponieważ link replikacji geograficznej jest częścią grupy trybu failover. Należy usunąć bazę danych z grupy, aby pojedynczo zakończyć działanie lub przejść w tryb failover.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.

  • 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ReplicationLink

Link replikacji.

ReplicationLinkType

Typ łącza (GEO, NAMED, STANDBY).

ReplicationRole

Rola replikacji lokalnej.

ReplicationState

Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).

Link replikacji.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.isTerminationAllowed

boolean

Czy użytkownik może obecnie przerwać łącze.

properties.linkType

ReplicationLinkType

Typ łącza (GEO, NAMED, STANDBY).

properties.partnerDatabase

string

Baza danych partnera zasobów.

properties.partnerLocation

string

Lokalizacja partnera zasobów.

properties.partnerRole

ReplicationRole

Rola replikacji partnera.

properties.partnerServer

string

Serwer partnera zasobów.

properties.percentComplete

integer

Procent ukończenia rozmieszczania dla łącza.

properties.replicationMode

string

Tryb replikacji.

properties.replicationState

ReplicationState

Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).

properties.role

ReplicationRole

Rola replikacji lokalnej.

properties.startTime

string

Godzina utworzenia łącza.

type

string

Typ zasobu.

ReplicationLinkType

Typ łącza (GEO, NAMED, STANDBY).

Nazwa Typ Opis
GEO

string

NAMED

string

STANDBY

string

ReplicationRole

Rola replikacji lokalnej.

Nazwa Typ Opis
Copy

string

NonReadableSecondary

string

Primary

string

Secondary

string

Source

string

ReplicationState

Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).

Nazwa Typ Opis
CATCH_UP

string

PENDING

string

SEEDING

string

SUSPENDED

string