Sdílet prostřednictvím

Databases - Failover

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

Převzetí služeb při selhání databáze.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
S volitelnými parametry: 
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 identifikátoru URI

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

string

Název databáze 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.
serverName
 path True

string

Název serveru.
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í databáze bylo úspěšně dokončeno.
202 Accepted

Probíhá převzetí služeb při selhání databáze.

Hlavičky

Location: string
Other Status Codes

ErrorResponse

Chybové odpovědi: ***

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

  • 400 DatabaseFailoverThrottled – V databázi nebo fondu došlo k nedávnému převzetí služeb při selhání, pokud databáze patří do elastického fondu.

  • 400 ManagementServiceFeatureDisabled – Uživatel se pokusil použít funkci, která je zakázaná.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 409 DatabaseNotInStateToFailover – Databáze je aktuálně ve stavu, kdy nelze vydat převzetí služeb při selhání.

  • 409 ManagementServiceDatabaseBusy – Databáze{0}je zaneprázdněna jinou operací. Zkuste operaci provést později.

  • 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 an database

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200
Stavový kód:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

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