Delen via

Databases - Failover

  • Referentie
Service:
SQL Database
API-versie:
2023-08-01

Failovers van een database.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
Met optionele parameters: 
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-parameters

Name In Vereist Type Description
databaseName
 path True

string

De naam van de database die moet worden uitgevoerd voor failover.
resourceGroupName
 path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version
 query True

string

De API-versie die moet worden gebruikt voor de aanvraag.
replicaType
 query

ReplicaType

Het type replica waarvan een failover moet worden uitgevoerd.

Antwoorden

Name Type Description
200 OK

De databasefailover is voltooid.
202 Accepted

Er wordt een databasefailover uitgevoerd.

Kopteksten

Location: string
Other Status Codes

ErrorResponse

Foutreacties: ***

  • 400 DatabaseFailoverNotSupportedOnSKU: dit type door de klant geïnitieerde failover wordt niet ondersteund voor de opgegeven SKU.

  • 400 DatabaseFailoverThrottled: er is een recente failover op de database of pool uitgevoerd als de database deel uitmaakt van een elastische pool.

  • 400 ManagementServiceFeatureDisabled - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld.

  • 404 OperationIdNotFound - De bewerking met id bestaat niet.

  • 409 DatabaseNotInStateToFailover : de database heeft momenteel een status, zodat failover niet kan worden uitgegeven.

  • 409 ManagementServiceDatabaseBusy - Database '{0}' is bezig met een andere bewerking. Probeer de bewerking later.

  • 409 CannotCancelOperation - De beheerbewerking heeft een status die niet kan worden geannuleerd.

  • 409 OperationCancelled - De bewerking is geannuleerd door de gebruiker.

  • 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en wordt automatisch teruggedraaid. Voer de bewerking opnieuw uit.

  • 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Voorbeelden

Failover an database

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ReplicaType

Het type replica waarvan een failover moet worden uitgevoerd.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ReplicaType

Inventarisatie

Het type replica waarvan een failover moet worden uitgevoerd.

Waarde Description
Primary
ReadableSecondary