Delen via


Instance Failover Groups - Create Or Update

Hiermee maakt u een failovergroep of werkt u deze bij.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-11-01

URI-parameters

Name In Vereist Type Description
failoverGroupName
path True

string

De naam van de failovergroep.

locationName
path True

string

De naam van de regio waar de resource zich bevindt.

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.

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.

Aanvraagbody

Name Vereist Type Description
properties.managedInstancePairs True

ManagedInstancePairInfo[]

Lijst met beheerde exemplaarparen in de failovergroep.

properties.partnerRegions True

PartnerRegionInfo[]

Partnerregiogegevens voor de failovergroep.

properties.readWriteEndpoint True

InstanceFailoverGroupReadWriteEndpoint

Lees-schrijfeindpunt van het exemplaar van de failovergroep.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

Antwoorden

Name Type Description
200 OK

InstanceFailoverGroup

De failovergroep is bijgewerkt.

201 Created

InstanceFailoverGroup

De failovergroep is gemaakt.

202 Accepted

Geaccepteerd

Other Status Codes

Foutreacties: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary: het opgegeven primaire veld in de aanvraagtekst van de failovergroep voor het maken of bijwerken van exemplaren is leeg of ongeldig.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner: het veld Partners in de aanvraagtekst van de failovergroep voor het maken of bijwerken van exemplaren is leeg of ongeldig.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - De door de partner beheerde exemplaarregio in de aanvraagbody van de exemplaarfailovergroep is leeg of ongeldig.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Er wordt slechts één partnerregio ondersteund.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Er wordt slechts één paar beheerde exemplaren ondersteund.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - Het veld readWriteEndpoint is vereist voor het maken of bijwerken van aanvragen.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid: de aanvraagtekst van de failovergroep voor het maken of bijwerken van exemplaren is leeg of ongeldig.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary : wijzigingen in de failovergroep van het exemplaar zijn niet toegestaan op een secundaire server. Voer de aanvraag uit op de primaire server.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - Respijtperiodewaarde voor de failovergroep van het exemplaar moet groter zijn dan of gelijk zijn aan de minimale respijtperiode in minuten{0}

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy- Het failoverPolicy-veld voor het eindpunt voor lezen/schrijven is vereist voor het maken of bijwerken van aanvragen.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Waarde voor respijtperiode mag niet worden opgegeven wanneer failoverbeleid Handmatig is geselecteerd voor het eindpunt lezen/schrijven.

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

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary: de failoveraanvraag moet worden gestart op de secundaire server van de exemplaarfailovergroep.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - De primaire server en de partnerserver van de failovergroep zijn afkomstig uit verschillende abonnementen. Meerdere abonnementen voor servers van een failovergroep zijn niet toegestaan.

  • 400 FailoverGroupRegionMismatch - Partnerregio die is opgegeven in failovergroep, moet overeenkomen met de regio van het door de partner beheerde exemplaar dat is aangegeven.

  • 400 ServerEditionMismatch - Editie moet hetzelfde zijn als de primaire server bij het maken van een replicaserver.

  • 400 DnsZoneMismatch: de DNSZone op de partnerserver verschilt van de DNSZone op de bronserver. Hierdoor wordt de functionaliteit van InstanceFailoverGroup verbroken.

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

  • 400 GeoDrInstanceSizeMismatch : het primaire beheerde exemplaar en het door de partner beheerde exemplaar hebben niet dezelfde opslaggrootte.

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

  • 400 GeoDrSecondaryInstanceNotEmpty - Secundair beheerd exemplaar bevat gebruikersdatabases. Als u een exemplaarfailovergroep wilt maken, moet het secundaire beheerde exemplaar leeg zijn.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Netwerkconfiguratie is onjuist. Het replicatieverkeer van de primaire server kan de secundaire server niet bereiken.

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

  • 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 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 UnableToResolveRemoteServer - De servernaam van de externe partner kan niet worden omgezet vanwege een ongeldige servernaam of dns-connectiviteitsproblemen.

  • 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 RemoteDatabaseCopyPermission - Gebruiker heeft onvoldoende machtigingen om een databasekopie te maken op de opgegeven server.

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

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

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

  • 400 InstanceFailoverGroupDoesNotExist - Failovergroep bestaat niet op een server.

  • 400 InstanceFailoverGroupNotSecondary: failover kan niet worden gestart vanaf de primaire server in een exemplaarfailovergroep.

  • 400 InvalidServerName - Ongeldige servernaam opgegeven.

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

  • 400 TokenTooLong : het opgegeven token is te lang.

  • 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 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven.

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

  • 400 ServerNotFound - De aangevraagde server is niet gevonden.

  • 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 GeoReplicationDatabaseNotSecondary: de bewerking verwacht dat de database een replicatiedoel is.

  • 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 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie.

  • 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 SourceDatabaseNotFound - De brondatabase bestaat niet.

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

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

  • 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 ManagedInstanceHasHybridLink - Gebruiker heeft geprobeerd een bewerking te starten die niet wordt ondersteund wanneer een hybride koppeling is geconfigureerd voor het beheerde exemplaar.

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

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

  • 409 SubscriptionDisabled - Abonnement is uitgeschakeld.

  • 409 InstanceFailoverGroupAlreadyExists - Failovergroep bestaat al op een bepaalde server.

  • 409 InstanceFailoverGroupBusy - ExemplaarfailoverGroupBusy is bezig met een andere bewerking.

  • 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 InstanceFailoverGroupDnsRecordInUse - Er bestaat een dubbele DNS-record voor het aangevraagde eindpunt.

  • 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 InvalidFailoverGroupName - Er is een ongeldige naam van de failovergroep voor het exemplaar opgegeven.

  • 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 ConflictingSystemOperationInProgress - Er wordt een systeemonderhoudsbewerking uitgevoerd op de database en verdere bewerkingen moeten wachten totdat deze is voltooid.

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

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

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

Voorbeelden

Create failover group

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test-3?api-version=2021-11-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerRegions": [
      {
        "location": "Japan West"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Definities

Name Description
InstanceFailoverGroup

Een exemplaarfailovergroep.

InstanceFailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

InstanceFailoverGroupReadWriteEndpoint

Lees-schrijfeindpunt van het exemplaar van de failovergroep.

InstanceFailoverGroupReplicationRole

Lokale replicatierol van het exemplaar van de failovergroep.

ManagedInstancePairInfo

Paren van beheerde exemplaren in de failovergroep.

PartnerRegionInfo

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

InstanceFailoverGroup

Een exemplaarfailovergroep.

Name Type Description
id

string

Resource-id.

name

string

Resourcenaam.

properties.managedInstancePairs

ManagedInstancePairInfo[]

Lijst met beheerde exemplaarparen in de failovergroep.

properties.partnerRegions

PartnerRegionInfo[]

Partnerregiogegevens voor de failovergroep.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Lees-schrijfeindpunt van het exemplaar van de failovergroep.

properties.replicationRole

InstanceFailoverGroupReplicationRole

Lokale replicatierol van het exemplaar van de failovergroep.

properties.replicationState

string

Replicatiestatus van het exemplaar van de failovergroep.

type

string

Resourcetype.

InstanceFailoverGroupReadOnlyEndpoint

Alleen-lezen eindpunt van het exemplaar van de failovergroep.

Name Type Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Failoverbeleid van het alleen-lezen eindpunt voor de failovergroep.

InstanceFailoverGroupReadWriteEndpoint

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.

InstanceFailoverGroupReplicationRole

Lokale replicatierol van het exemplaar van de failovergroep.

Name Type Description
Primary

string

Secondary

string

ManagedInstancePairInfo

Paren van beheerde exemplaren in de failovergroep.

Name Type Description
partnerManagedInstanceId

string

Id van beheerd exemplaar van partner in paar.

primaryManagedInstanceId

string

Id van primair beheerd exemplaar in paar.

PartnerRegionInfo

Partnerregiogegevens voor de failovergroep.

Name Type Description
location

string

Geo-locatie van de door de partner beheerde exemplaren.

replicationRole

InstanceFailoverGroupReplicationRole

Replicatierol van de door de partner beheerde exemplaren.

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