Udostępnij za pośrednictwem

Databases - Failover

  • Odwołanie
Usługa:
SQL Database
Wersja interfejsu API:
2023-08-01

Przełączanie bazy danych w tryb failover.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
Z parametrami opcjonalnymi: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
databaseName
 path True

string

Nazwa bazy danych do przejścia w tryb failover.
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.
replicaType
 query

ReplicaType

Typ repliki, która ma zostać przełączona w tryb failover.

Odpowiedzi

Nazwa Typ Opis
200 OK

Pomyślnie ukończono tryb failover bazy danych.
202 Accepted

Tryb failover bazy danych jest w toku.

Nagłówki

Location: string
Other Status Codes

ErrorResponse

Odpowiedzi na błędy: ***

  • 400 DatabaseFailoverNotSupportedOnSKU — ten typ trybu failover zainicjowanego przez klienta nie jest obsługiwany w danej jednostce SKU.

  • 400 DatabaseFailoverThrottled — ostatnio przeprowadzono tryb failover w bazie danych lub puli, jeśli baza danych należy do elastycznej puli.

  • 400 ManagementServiceFeatureDisabled — użytkownik próbował użyć funkcji, która jest wyłączona.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 409 DatabaseNotInStateToFailover — baza danych jest obecnie w stanie, w którym nie można wydać trybu failover.

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

  • 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.

  • 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

Failover an database

Przykładowe żądanie

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/testServer/databases/testDatabase/failover?replicaType=Primary&api-version=2023-08-01

Przykładowa odpowiedź

Kod stanu:
200
Kod stanu:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

Definicje

Nazwa Opis
ErrorAdditionalInfo

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

Szczegóły błędu.
ErrorResponse

Odpowiedź na błąd
ReplicaType

Typ repliki, która ma zostać przełączona w tryb failover.

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.

ReplicaType

Wyliczanie

Typ repliki, która ma zostać przełączona w tryb failover.

Wartość Opis
Primary
ReadableSecondary