Replication Links - Failover

Service:

SQL Database

API Version:

2021-11-01

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

Planned failover of a replication link

Sample Request

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

import com.azure.core.util.Context;

/** 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", 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

Sample Response

Status code:

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

Status code:

202

Definicje

Nazwa	Opis
ReplicationLink	Link replikacji.
ReplicationLinkType	Typ łącza (GEO, NAMED, STANDBY).
ReplicationRole	Rola replikacji lokalnej.
ReplicationState	Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).

ReplicationLink

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