Replication Links - Create Or Update

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2023-08-01

Aktualizuje typ łącza replikacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
linkId	path	True	string
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.

Treść żądania

Nazwa	Typ	Opis
properties.linkType	ReplicationLinkType	Typ łącza (GEO, NAMED, STANDBY). Operacja aktualizacji nie obsługuje nazwy.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ReplicationLink	Pomyślnie zaktualizowano łącze replikacji.
202 Accepted		Operacja aktualizacji jest w toku. Nagłówki Location: string
Other Status Codes	ErrorResponse	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 ReplicationLinksReplicationLinkTypeIsInvalid — typ linku jest nieprawidłowy. Prawidłowe wartości to STANDBY i GEO. 400 ReplicationLinksCreateIsNotSupported — tworzenie łącza replikacji nie jest obsługiwane. 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 ponów próbę wykonania operacji. 400 InvalidServerName — określona nieprawidłowa nazwa serwera. 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode. 400 TokenTooLong — podany token jest za długi. 400 InvalidServerName — określona nieprawidłowa nazwa serwera. 400 GeoReplicationDatabaseNotSecondary — operacja oczekuje, że baza danych będzie obiektem docelowym replikacji. 400 CannotUseTrailingWhitespacesInDatabaseName — sprawdzanie poprawności nazwy bazy danych nie powiodło się. 400 IncorrectReplicationLinkState — operacja oczekuje, że baza danych będzie w oczekiwanym stanie linku replikacji. 400 PlannedFailoverTimedOut — użytkownik wywołał planowany tryb failover i upłynął limit czasu podczas próby skontaktowania się z usługą zarządzania partnerem. 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave — konfigurowanie replikacji geograficznej nie jest obsługiwane dla baz danych przy użyciu różnych wartości preferowanej właściwościEnclaveType. Podstawowa baza danych "{0}" na serwerze "{1}" używa elementu "{2}" preferredEnclaveType, natomiast określona preferowana EnklawaType dla pomocniczej bazy danych "{3}" na serwerze "{4}" jest "{5}". 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes — planowana praca w trybie failover między podstawową i pomocniczą bazą danych z inną preferowaną enklawą Enklawy nie jest obsługiwana w przypadku enklaw zabezpieczeń opartych na wirtualizacji (VBS). 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji. 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 404 ResourceNotFound — żądany zasób nie został znaleziony. 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 CannotCancelOperation — operacja zarządzania jest w stanie, którego nie można anulować. 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 UpdateSloInProgress — użytkownik próbował zainicjować niezgodną operację, gdy aktualizacja SLO była w toku. 409 InvalidOperationForDatabaseNotInReplicationRelationship — operacja replikacji została wykonana w bazie danych, która nie znajduje się w relacji replikacji. 409 ConflictingSystemOperationInProgress — trwa operacja konserwacji systemu w bazie danych, a dalsze operacje muszą czekać, aż zostanie ukończona. 409 DuplicateGeoDrRelation — bazy danych są już w relacji replikacji. Jest to zduplikowane żądanie. 409 GeoReplicationCannotBecomePrimaryDuringUndo — użytkownik próbował przejść w tryb failover lub wymusić przerwanie łącza geograficznego, gdy pomocniczy jest w stanie, w którym może nie być fizycznie spójny i dlatego nie może wprowadzić roli podstawowej. 409 ManagementServiceDatabaseBusy — baza danych "{0}" jest zajęta inną operacją. Spróbuj wykonać operację później. 409 FailoverGroupAlreadySetup — nie można wykonać operacji, ponieważ łącze replikacji geograficznej jest częścią grupy trybu failover. Musisz 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.

Nazwa

Typ

Opis

200 OK

ReplicationLink

Pomyślnie zaktualizowano łącze replikacji.

202 Accepted

Operacja aktualizacji jest w toku.

Nagłówki

Location: string

Other Status Codes

ErrorResponse

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 ReplicationLinksReplicationLinkTypeIsInvalid — typ linku jest nieprawidłowy. Prawidłowe wartości to STANDBY i GEO.
400 ReplicationLinksCreateIsNotSupported — tworzenie łącza replikacji nie jest obsługiwane.
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 ponów próbę wykonania operacji.
400 InvalidServerName — określona nieprawidłowa nazwa serwera.
400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode.
400 TokenTooLong — podany token jest za długi.
400 InvalidServerName — określona nieprawidłowa nazwa serwera.
400 GeoReplicationDatabaseNotSecondary — operacja oczekuje, że baza danych będzie obiektem docelowym replikacji.
400 CannotUseTrailingWhitespacesInDatabaseName — sprawdzanie poprawności nazwy bazy danych nie powiodło się.
400 IncorrectReplicationLinkState — operacja oczekuje, że baza danych będzie w oczekiwanym stanie linku replikacji.
400 PlannedFailoverTimedOut — użytkownik wywołał planowany tryb failover i upłynął limit czasu podczas próby skontaktowania się z usługą zarządzania partnerem.
400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave — konfigurowanie replikacji geograficznej nie jest obsługiwane dla baz danych przy użyciu różnych wartości preferowanej właściwościEnclaveType. Podstawowa baza danych "{0}" na serwerze "{1}" używa elementu "{2}" preferredEnclaveType, natomiast określona preferowana EnklawaType dla pomocniczej bazy danych "{3}" na serwerze "{4}" jest "{5}".
400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes — planowana praca w trybie failover między podstawową i pomocniczą bazą danych z inną preferowaną enklawą Enklawy nie jest obsługiwana w przypadku enklaw zabezpieczeń opartych na wirtualizacji (VBS).
400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji.
400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode.
404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.
404 ResourceNotFound — żądany zasób nie został znaleziony.
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 CannotCancelOperation — operacja zarządzania jest w stanie, którego nie można anulować.
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 UpdateSloInProgress — użytkownik próbował zainicjować niezgodną operację, gdy aktualizacja SLO była w toku.
409 InvalidOperationForDatabaseNotInReplicationRelationship — operacja replikacji została wykonana w bazie danych, która nie znajduje się w relacji replikacji.
409 ConflictingSystemOperationInProgress — trwa operacja konserwacji systemu w bazie danych, a dalsze operacje muszą czekać, aż zostanie ukończona.
409 DuplicateGeoDrRelation — bazy danych są już w relacji replikacji. Jest to zduplikowane żądanie.
409 GeoReplicationCannotBecomePrimaryDuringUndo — użytkownik próbował przejść w tryb failover lub wymusić przerwanie łącza geograficznego, gdy pomocniczy jest w stanie, w którym może nie być fizycznie spójny i dlatego nie może wprowadzić roli podstawowej.
409 ManagementServiceDatabaseBusy — baza danych "{0}" jest zajęta inną operacją. Spróbuj wykonać operację później.
409 FailoverGroupAlreadySetup — nie można wykonać operacji, ponieważ łącze replikacji geograficznej jest częścią grupy trybu failover. Musisz 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

Updates Replication Link

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/00000000-1111-2222-3333-666666666666?api-version=2023-08-01

{
  "properties": {
    "linkType": "STANDBY"
  }
}

Przykładowa odpowiedź

Kod stanu:: 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": "STANDBY"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "00000000-1111-2222-3333-666666666666"
}

Kod stanu:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/replicationLinksOperationResults/11111111-1111-1111-1111-111111111111

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ReplicationLink	Łącze replikacji.
ReplicationLinkType	Typ łącza (GEO, NAMED, STANDBY). Operacja aktualizacji nie obsługuje nazwy.
ReplicationRole	Rola replikacji lokalnej.
ReplicationState	Stan replikacji (OCZEKIWANIE, ROZMIESZCZANIE, PRZECHWYTYWANIE, ZAWIESZONE).

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ReplicationLink

Objekt

Łącze 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). Operacja aktualizacji nie obsługuje nazwy.
properties.partnerDatabase	string	Baza danych partnera zasobów.
properties.partnerDatabaseId	string	Identyfikator bazy 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 (int32)	Procent ukończenia rozmieszczania dla łącza.
properties.replicationMode	string	Tryb replikacji.
properties.replicationState	ReplicationState	Stan replikacji (OCZEKIWANIE, ROZMIESZCZANIE, PRZECHWYTYWANIE, ZAWIESZONE).
properties.role	ReplicationRole	Rola replikacji lokalnej.
properties.startTime	string (date-time)	Godzina utworzenia łącza.
type	string	Typ zasobu.

ReplicationLinkType

Wyliczanie

Typ łącza (GEO, NAMED, STANDBY). Operacja aktualizacji nie obsługuje nazwy.

Wartość	Opis
GEO
NAMED
STANDBY

ReplicationRole

Wyliczanie

Rola replikacji lokalnej.

Wartość	Opis
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

Wyliczanie

Stan replikacji (OCZEKIWANIE, ROZMIESZCZANIE, PRZECHWYTYWANIE, ZAWIESZONE).

Wartość	Opis
CATCH_UP
PENDING
SEEDING
SUSPENDED

Udostępnij za pośrednictwem

Replication Links - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Updates Replication Link

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

Dodatkowe zasoby