Failover Groups - Failover

Failover van de huidige primaire server naar deze server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/failover?api-version=2021-11-01

URI-parameters

Name In Vereist Type Description
failoverGroupName
path True

string

De naam van de failovergroep.

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 die de failovergroep bevat.

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.

Antwoorden

Name Type Description
200 OK

FailoverGroup

De failover is geslaagd.

202 Accepted

Geaccepteerd

Other Status Codes

Foutreacties: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases: de opgegeven database-id's zijn niet juist samengestelde databaseresource-id's. Zie voor het voorbeeld van de juiste opmaak https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner - Het veld partners in de aanvraagtekst voor het maken of bijwerken van failovergroep is leeg of ongeldig. Geef een geldige waarde van dit veld op. Zie voor voorbeelden van correct opgemaakte aanvragen https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner - Een of meer van de opgegeven partnerservers maken al deel uit van de failovergroep. Zorg ervoor dat de primaire server en alle opgegeven partnerservers uniek zijn.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - Een of meer van de opgegeven databases bestaan niet op de primaire server van de failovergroep. Zorg ervoor dat alle databases aanwezig zijn op de primaire server.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Er wordt slechts één partnerserver voor failovergroep ondersteund. Wijzig uw aanvraag dienovereenkomstig. Zie voor voorbeelden van geldige aanvragen https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint : het veld readWriteEndpoint is vereist voor het maken of bijwerken van aanvragen.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid- De aanvraagtekst van de failovergroep maken of bijwerken is leeg of ongeldig.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary: wijzigingen in de failovergroep zijn niet toegestaan op een secundaire server. Voer de aanvraag uit op de primaire server.

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - Respijtperiodewaarde voor het eindpunt voor lezen/schrijven moet niet negatief zijn.

  • 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - De waarde van de respijtperiode voor de failovergroep moet groter zijn dan of gelijk zijn aan de minimale respijtperiode in minuten{0}

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - De eigenschap failoverWithDataLossGracePeriodMinutes moet worden opgegeven wanneer failoverbeleid Automatisch is geselecteerd voor het eindpunt lezen/schrijven.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy: het veld failoverPolicy voor het eindpunt voor lezen/schrijven is vereist voor het maken of bijwerken van aanvragen.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Waarde voor respijtperiode mag niet worden opgegeven wanneer failoverbeleid handmatig is geselecteerd voor het eindpunt lezen/schrijven. Verwijder deze uit de aanvraag.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - De aanvraagtekst van de failovergroep maken of bijwerken mag de eigenschap alleen-lezen{0} niet wijzigen.

  • 400 FailoverGroupFailoverRequestOnPrimary: de failoveraanvraag moet worden gestart op de secundaire server van de failovergroep.

  • 400 FailoverGroupPartnerServerFromDifferentSubscription: de primaire server en de partnerservers van de failovergroep zijn afkomstig uit verschillende abonnementen. Meerdere abonnementen voor servers van een failovergroep zijn niet toegestaan.

  • 400 InvalidAddSecondaryPermission - Gebruiker heeft onvoldoende machtigingen om secundaire op de opgegeven server toe te voegen.

  • 400 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven.

  • 400 ServerNotFound - De aangevraagde server is niet gevonden.

  • 400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie.

  • 400 TokenTooLong : het opgegeven token is te lang.

  • 400 InvalidTargetSubregion - De doelserver van een niet-leesbare secundaire server bevindt zich niet in een gekoppelde Azure-regio voor herstel na noodgeval.

  • 400 PartnerServerNotCompatible - De gebruiker probeert een database te kopiëren van een SAWA V1-server naar een Sterling-server of omgekeerd.

  • 400 IncorrectReplicationLinkState- De bewerking verwacht dat de database een verwachte status heeft op de replicatiekoppeling.

  • 400 ResourcePoolNotFound - De opgegeven elastische pool bestaat niet in de opgegeven logische server.

  • 400 AzureKeyVaultKeyDisabled: de bewerking kan niet worden voltooid op de server omdat de Azure Key Vault-sleutel is uitgeschakeld.

  • 400 AzureKeyVaultInvalidExpirationDate: de bewerking kan niet worden voltooid omdat de vervaldatum van de Azure Key Vault-sleutel ongeldig is.

  • 400 BeveiligingAzureKeyVaultUrlNullOrEmpty: de bewerking kan niet worden voltooid omdat de Azure Key Vault-URI null of leeg is.

  • 400 AzureKeyVaultNoServerIdentity: de serveridentiteit is niet juist geconfigureerd.

  • 400 AzureKeyVaultInvalidUri: een ongeldig antwoord van Azure Key Vault. Gebruik een geldige Azure Key Vault-URI.

  • 400 AzureKeyVaultMissingPermissions : de server mist vereiste machtigingen op de Azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName - De bewerking kan niet worden voltooid vanwege een ongeldige serversleutelnaam.

  • 400 PlannedFailoverTimedOutForDatabase - Gebruiker heeft geplande failover aangeroepen, er is een time-out opgetreden en een specifieke database lijkt de schuld te zijn.

  • 400 PlannedFailoverTimedOut: gebruiker heeft geplande failover aangeroepen en er is een time-out opgetreden tijdens het contact opnemen met de partnerbeheerservice.

  • 400 AdalGenericError: de bewerking kan niet worden voltooid omdat er een Azure Active Directory-fout is opgetreden.

  • 400 AdalServicePrincipalNotFound: de bewerking kan niet worden voltooid omdat er een fout met de service-principal van de Azure Active Directory-bibliotheek niet gevonden is opgetreden.

  • 400 AzureKeyVaultMalformedVaultUri : de opgegeven Key Vault-URI is ongeldig.

  • 400 CannotUseReservedDatabaseName : kan de gereserveerde databasenaam niet gebruiken in deze bewerking.

  • 400 InvalidFailoverGroupRegion - Servers die zijn opgegeven in een failovergroep, moeten zich in verschillende regio's bevinden om isolatie te bieden.

  • 400 FailoverGroupDoesNotExist - Failovergroep bestaat niet op een server.

  • 400 FailoverGroupNotSecondary: failover kan niet worden gestart vanaf de primaire server in een failovergroep.

  • 400 InvalidServerName - Ongeldige servernaam opgegeven.

  • 400 DatabaseInFailoverGroupNotPrimary - GeoDR-koppeling voor de database bestaat al, maar de rol is niet 'Primair' of het is geen continue kopieerkoppeling.

  • 400 SecurityAdalPrincipalCertExpiredError: de bewerking kan niet worden voltooid omdat het Azure Key Vault principal-certificaat is verlopen.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing - Failovergroep kan niet worden gemaakt voor server waarop tabelcontrole is ingeschakeld.

  • 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup - Database waarvoor Tabelcontrole is ingeschakeld, is niet toegankelijk via het eindpunt van de failovergroep.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - De opgegeven Key Vault-URI is ongeldig.

  • 400 KeyMaterialNotFoundOnRemoteServer - Externe server heeft geen toegang tot sleutelmateriaal dat wordt gebruikt als een TDE-beveiliging.

  • 400 LimitOfFailoverGroupsPerServerExceeded: het maken van een nieuwe failovergroep overschrijdt het toegestane aantal failovergroepen per server.

  • 400 SameKeyUriNotFoundOnRemoteServer - Secundaire server heeft niet het sleutelmateriaal uit dezelfde sleutelkluis als de versleutelingsbeveiliging van de primaire server met automatische rotatie van sleutels ingeschakeld.

  • 400 AzureKeyVaultRsaKeyNotSupported: de opgegeven sleutelkluis gebruikt niet-ondersteunde RSA-sleutelgrootte of -sleuteltype. De ondersteunde RSA-sleutelgrootte is 2048 of 3072 en sleuteltype is RSA of RSA-HSM.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - Secundaire server beschikt niet over het sleutelmateriaal van de versleutelingsbeveiliging van de primaire server.

  • 400 GeoReplicationDatabaseNotSecondary: de bewerking verwacht dat de database een replicatiedoel is.

  • 400 GeoReplicaLimitReached : de replicatielimiet per replica is bereikt.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported - Failovergroepen die zijn geconfigureerd met een automatisch failoverbeleid worden momenteel niet ondersteund op servers die zijn geconfigureerd met firewallregels voor virtuele netwerken. Configureer de failovergroep met handmatig failoverbeleid.

  • 400 UnableToResolveRemoteServer - De servernaam van de externe partner kan niet worden omgezet vanwege een ongeldige servernaam of dns-connectiviteitsproblemen.

  • 400 RemoteDatabaseCopyPermission - Gebruiker heeft onvoldoende machtigingen om een databasekopie te maken op de opgegeven server.

  • 400 BeveiligingAzureKeyVaultGeoChainError: het maken van een secundaire of secundaire (een proces dat ketenkoppeling wordt genoemd) wordt niet ondersteund bij het inschakelen van Transparent Data Encryption met behulp van Azure Key Vault (BYOK).

  • 404 OperationIdNotFound - De bewerking met id bestaat niet.

  • 404 ResourceNotFound - De aangevraagde resource is niet gevonden.

  • 404 OperationIdNotFound - De bewerking met id bestaat niet.

  • 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

  • 404 ServerNotInSubscription : de opgegeven server bestaat niet in het opgegeven abonnement.

  • 404 SourceDatabaseNotFound - De brondatabase bestaat niet.

  • 405 UnsupportedReplicationOperation: er is een niet-ondersteunde replicatiebewerking gestart op de database.

  • 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.

  • 409 ConflictingServerOperation : er wordt momenteel een bewerking uitgevoerd voor de server.

  • 409 SubscriptionDisabled - Abonnement is uitgeschakeld.

  • 409 ConflictingSystemOperationInProgress - Er wordt een systeemonderhoudsbewerking uitgevoerd op de database en verdere bewerkingen moeten wachten totdat deze is voltooid.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - Gebruiker heeft geprobeerd een geo-link te failovern of geforceerd te beëindigen terwijl de secundaire verbinding zich in een toestand bevindt waarin deze mogelijk niet fysiek consistent is en dus de primaire rol niet kan invoeren.

  • 409 ServerKeyNameAlreadyExists: de serversleutel bestaat al op de server.

  • 409 ServerKeyUriAlreadyExists: de serversleutel-URI bestaat al op de server.

  • 409 ServerKeyDoesNotExists - De serversleutel bestaat niet.

  • 409 UpdateSloInProgress - Gebruiker heeft geprobeerd een incompatibele bewerking te starten terwijl een SLO-update werd uitgevoerd.

  • 409 AzureKeyVaultKeyNameNotFound: de bewerking kan niet worden voltooid omdat de naam van de Azure Key Vault-sleutel niet bestaat.

  • 409 AzureKeyVaultKeyInUse : de sleutel wordt momenteel gebruikt door de server.

  • 409 FailoverGroupAlreadyExists: failovergroep bestaat al op een bepaalde server. Gebruik een andere naam voor de failovergroep.

  • 409 FailoverGroupBusy - Failovergroep is bezig met een andere bewerking.

  • 409 DatabaseBelongsToOtherFailoverGroup - Database behoort tot een andere failovergroep en kan niet worden beschouwd als onderdeel van deze groep.

  • 409 DatabaseBeingAddedToFailoverGroup - De database wordt momenteel toegevoegd aan de failovergroep. De klant moet wachten totdat deze bewerking is voltooid om verwijdering uit te voeren.

  • 409 DatabaseBeingRemovedFromFailoverGroup - De database wordt momenteel verwijderd uit de failovergroep. De klant moet wachten tot deze bewerking is voltooid om het toevoegen uit te voeren.

  • 409 FailoverGroupDnsRecordInUse - Er bestaat een dubbele DNS-record voor het aangevraagde eindpunt.

  • 409 InvalidFailoverGroupName - Er is een ongeldige naam van de failovergroep opgegeven.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship : er is een replicatiesedingbewerking uitgevoerd op een database die al een replicatierelatie heeft.

  • 409 InvalidDatabaseStateForOperation: de bewerking is niet toegestaan voor de database in de huidige replicatiestatus.

  • 409 DuplicateGeoDrRelation : de databases bevinden zich al in een replicatierelatie. Dit is een dubbele aanvraag.

  • 409 RemoteDatabaseExists - De naam van de doeldatabase bestaat al op de doelserver.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.

  • 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 AzureKeyVaultConnectionFailed : de bewerking kan niet worden voltooid op de server omdat pogingen om verbinding te maken met Azure Key Vault zijn mislukt

  • 503 AzureKeyVaultGenericConnectionError: de bewerking kan niet worden voltooid omdat er een fout is opgetreden bij het ophalen van Key Vault informatie .

  • 503 DatabaseUnavailable - De bewerking is mislukt omdat de database niet beschikbaar is.

  • 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Voorbeelden

Planned failover of a failover group

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3/failover?api-version=2021-11-01

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan West",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server",
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-2"
    ]
  }
}

Definities

Name Description
FailoverGroup

Een failovergroep.

FailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

FailoverGroupReadWriteEndpoint

Lees-schrijfeindpunt van het exemplaar van de failovergroep.

FailoverGroupReplicationRole

Lokale replicatierol van het exemplaar van de failovergroep.

PartnerInfo

Partnerservergegevens voor de failovergroep.

ReadOnlyEndpointFailoverPolicy

Failoverbeleid van het alleen-lezen eindpunt voor de failovergroep.

ReadWriteEndpointFailoverPolicy

Failoverbeleid van het eindpunt lezen/schrijven voor de failovergroep. Als failoverPolicy automatisch is, is failoverWithDataLossGracePeriodMinutes vereist.

FailoverGroup

Een failovergroep.

Name Type Description
id

string

Resource-id.

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.databases

string[]

Lijst met databases in de failovergroep.

properties.partnerServers

PartnerInfo[]

Lijst met partnerservergegevens voor de failovergroep.

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

Lees-schrijfeindpunt van het exemplaar van de failovergroep.

properties.replicationRole

FailoverGroupReplicationRole

Lokale replicatierol van het exemplaar van de failovergroep.

properties.replicationState

string

Replicatiestatus van het exemplaar van de failovergroep.

tags

object

Resourcetags.

type

string

Resourcetype.

FailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

Name Type Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Failoverbeleid van het alleen-lezen eindpunt voor de failovergroep.

FailoverGroupReadWriteEndpoint

Lees-schrijfeindpunt van het exemplaar van de failovergroep.

Name Type Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

Failoverbeleid van het eindpunt lezen/schrijven voor de failovergroep. Als failoverPolicy automatisch is, is failoverWithDataLossGracePeriodMinutes vereist.

failoverWithDataLossGracePeriodMinutes

integer

Respijtperiode voordat een failover met gegevensverlies wordt geprobeerd voor het eindpunt lezen/schrijven. Als failoverPolicy automatisch is, is failoverWithDataLossGracePeriodMinutes vereist.

FailoverGroupReplicationRole

Lokale replicatierol van het exemplaar van de failovergroep.

Name Type Description
Primary

string

Secondary

string

PartnerInfo

Partnerservergegevens voor de failovergroep.

Name Type Description
id

string

Resource-id van de partnerserver.

location

string

Geografische locatie van de partnerserver.

replicationRole

FailoverGroupReplicationRole

Replicatierol van de partnerserver.

ReadOnlyEndpointFailoverPolicy

Failoverbeleid van het alleen-lezen eindpunt voor de failovergroep.

Name Type Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Failoverbeleid van het eindpunt lezen/schrijven voor de failovergroep. Als failoverPolicy automatisch is, is failoverWithDataLossGracePeriodMinutes vereist.

Name Type Description
Automatic

string

Manual

string