Megosztás a következőn keresztül:

Databases - Failover

  • Referencia
Szolgáltatás:
SQL Database
API-verzió:
2023-08-01

Adatbázis feladatátvétele.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
Opcionális paraméterekkel: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01

URI-paraméterek

Name In Kötelező Típus Description
databaseName
 path True

string

A feladatátvételre kijelölt adatbázis neve.
resourceGroupName
 path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName
 path True

string

A kiszolgáló neve.
subscriptionId
 path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version
 query True

string

A kéréshez használni kívánt API-verzió.
replicaType
 query

ReplicaType

A feladatátvételre kijelölt replika típusa.

Válaszok

Name Típus Description
200 OK

Sikeresen befejeződött az adatbázis feladatátvétele.
202 Accepted

Az adatbázis feladatátvétele folyamatban van.

Fejlécek

Location: string
Other Status Codes

ErrorResponse

Hibaválaszok: ***

  • 400 DatabaseFailoverNotSupportedOnSKU – Ez az ügyfél által kezdeményezett feladatátvételi típus nem támogatott az adott termékváltozatban.

  • 400 DatabaseFailoverThrottled – Legutóbbi feladatátvétel történt az adatbázison vagy a készleten, ha az adatbázis rugalmas készletbe tartozik.

  • 400 ManagementServiceFeatureDisabled – A felhasználó letiltott funkciót próbált használni.

  • 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.

  • 409 DatabaseNotInStateToFailover – Az adatbázis jelenleg olyan állapotban van, hogy a feladatátvétel nem adható ki.

  • 409 ManagementServiceDatabaseBusy – Az adatbázis{0}' egy másik művelettel van elfoglalva. Próbálkozzon később a művelettel.

  • 409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető.

  • 409 OperationCancelled – A felhasználó megszakította a műveletet.

  • 409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése.

  • 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel.

  • 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Failover an database

Mintakérelem

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

Mintaválasz

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

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

Hibaválasz
ReplicaType

A feladatátvételre kijelölt replika típusa.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.
type

string

A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ReplicaType

Enumerálás

A feladatátvételre kijelölt replika típusa.

Érték Description
Primary
ReadableSecondary