Udostępnij za pośrednictwem

Managed Instances - Failover

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

Przełączanie w tryb failover wystąpienia zarządzanego.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
managedInstanceName
 path True

string

Nazwa wystąpienia zarządzanego do trybu 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.
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 wystąpienia zarządzanego.
202 Accepted

Trwa przełączanie wystąpienia zarządzanego w tryb failover.

Nagłówki

Location: string
Other Status Codes

ErrorResponse

Odpowiedzi na błędy: ***

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

  • 400 ManagedInstanceFailoverThrottled — w wystąpieniu zarządzanym nastąpiło ostatnie przejście w tryb failover.

  • 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania

  • 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym

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

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 409 ManagedInstanceFailoverFullBackupMissing — automatyczna kopia zapasowa musi ukończyć pierwszą pełną kopię zapasową dla nowej bazy danych.

  • 409 ManagedInstanceNotInStateToFailover — wystąpienie zarządzane jest obecnie w stanie, w którym nie można wydać trybu failover.

  • 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 a managed instance.

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200
Kod stanu:
202 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/managedInstanceOperationResults/00000000-1111-2222-3333-444444444444?api-version=2019-06-01-preview

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