Replication Links - Failover Allow Data Loss

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Przełączenie w tryb failover z bieżącego serwera podstawowego do tego serwera umożliwiającego utratę danych.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/forceFailoverAllowDataLoss?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 linku replikacji.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure 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 celem 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 — walidacja nazwy bazy danych nie powiodła się. 400 GeoReplicationDatabaseNotSecondary — operacja oczekuje, że baza danych będzie celem replikacji. 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji. 400 InvalidServerName — określona nieprawidłowa nazwa 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 w 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 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 409 InvalidOperationForDatabaseNotInReplicationRelationRelationShip — 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 podstawowej. 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 — operacja konserwacji systemu jest w toku w bazie danych, a dalsze operacje muszą czekać, aż zostanie ukończone. 409 FailoverGroupAlreadySetup — nie można wykonać operacji, ponieważ link replikacji geograficznej jest częścią grupy trybu failover. Należy usunąć bazę danych z grupy w celu indywidualnego zakończenia lub przejścia 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 maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

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 celem 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 — walidacja nazwy bazy danych nie powiodła się.
400 GeoReplicationDatabaseNotSecondary — operacja oczekuje, że baza danych będzie celem replikacji.
400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji.
400 InvalidServerName — określona nieprawidłowa nazwa 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 w 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 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.
409 InvalidOperationForDatabaseNotInReplicationRelationRelationShip — 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 podstawowej.
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 — operacja konserwacji systemu jest w toku w bazie danych, a dalsze operacje muszą czekać, aż zostanie ukończone.
409 FailoverGroupAlreadySetup — nie można wykonać operacji, ponieważ link replikacji geograficznej jest częścią grupy trybu failover. Należy usunąć bazę danych z grupy w celu indywidualnego zakończenia lub przejścia 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 maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.
500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. 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

Forced failover of a replication link

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=2021-11-01


/**
 * Samples for ReplicationLinks FailoverAllowDataLoss.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailoverAllowDataLoss.
     * json
     */
    /**
     * Sample code: Forced failover of a replication link.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void forcedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failoverAllowDataLoss("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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Kod stanu:: 202

Definicje

Nazwa	Opis
ReplicationLink	Łącze replikacji.
ReplicationLinkType	Typ łącza (GEO, NAZWANY, STANDBY).
ReplicationRole	Rola replikacji lokalnej.
ReplicationState	Stan replikacji (OCZEKUJĄCE, INICJUJĄCE, CATCHUP, ZAWIESZONE).

ReplicationLink

Łącze replikacji.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.isTerminationAllowed	boolean	Czy użytkownik może obecnie zakończyć łącze.
properties.linkType	ReplicationLinkType	Typ łącza (GEO, NAZWANY, 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 uzupełniania rozmieszczania dla linku.
properties.replicationMode	string	Tryb replikacji.
properties.replicationState	ReplicationState	Stan replikacji (OCZEKUJĄCE, INICJUJĄCE, CATCHUP, ZAWIESZONE).
properties.role	ReplicationRole	Rola replikacji lokalnej.
properties.startTime	string	Godzina utworzenia linku.
type	string	Typ zasobu.

ReplicationLinkType

Typ łącza (GEO, NAZWANY, 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 (OCZEKUJĄCE, INICJUJĄCE, CATCHUP, ZAWIESZONE).

Nazwa	Typ	Opis
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string

Udostępnij za pośrednictwem

Replication Links - Failover Allow Data Loss

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Forced failover of a replication link

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

Dodatkowe zasoby