Sdílet prostřednictvím

Managed Instances - Failover

Služba:
SQL Database
Verze rozhraní API:
2023-08-01

Převzetí služeb při selhání spravované instance.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2023-08-01
S volitelnými parametry: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2023-08-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
managedInstanceName
 path True

string

Název spravované instance pro převzetí služeb při selhání.
resourceGroupName
 path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
subscriptionId
 path True

string

ID předplatného, které identifikuje předplatné Azure.
api-version
 query True

string

Verze rozhraní API, která se má použít pro požadavek.
replicaType
 query

ReplicaType

Typ repliky, která se má převzít při selhání.

Odpovědi

Name Typ Description
200 OK

Převzetí služeb při selhání spravované instance bylo úspěšně dokončeno.
202 Accepted

Probíhá převzetí služeb při selhání spravované instance.

Hlavičky

Location: string
Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 ManagedInstanceFailoverNotSupportedOnSKU – Tento typ převzetí služeb při selhání iniciovaného zákazníkem není u dané skladové položky podporovaný.

  • 400 ManagedInstanceFailoverThrottled – u spravované instance došlo k nedávnému převzetí služeb při selhání.

  • 400 ManagedInstanceStoppingOrStopped – Konfliktní operace odeslaná, když je instance v zastaveném nebo zastaveném stavu

  • 400 ManagedInstanceStarting – Konfliktní operace odeslaná při spuštění instance

  • 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 409 ManagedInstanceFailoverFullBackupMissing – Automatizované zálohování musí dokončit první úplné zálohování nové databáze.

  • 409 ManagedInstanceNotInStateToFailover – spravovaná instance je momentálně ve stavu, kdy nelze vydat převzetí služeb při selhání.

  • 409 CannotCancelOperation – Operace správy je ve stavu, který nelze zrušit.

  • 409 OperationCancelled - Operace byla zrušena uživatelem.

  • 409 OperationInterrupted – operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací na stejném prostředku.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Failover a managed instance.

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200
Stavový kód:
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

Definice

Name Description
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Chybová odpověď
ReplicaType

Typ repliky, která se má převzít při selhání.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.
code

string

Kód chyby.
details

ErrorDetail[]

Podrobnosti o chybě.
message

string

Chybová zpráva.
target

string

Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ReplicaType

Výčet

Typ repliky, která se má převzít při selhání.

Hodnota Description
Primary
ReadableSecondary