Instance Failover Groups - List By Location

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Lijsten de failovergroepen op een locatie.

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

URI-parameters

Name	In	Vereist	Type	Description
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.

Antwoorden

Name	Type	Description
200 OK	InstanceFailoverGroupListResult	De failovergroepen zijn opgehaald.
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 ResourceNotFound - De aangevraagde resource is niet gevonden. 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 ManagedInstanceHasHybridLink - Gebruiker heeft geprobeerd een bewerking te starten die niet wordt ondersteund wanneer voor het beheerde exemplaar een hybride koppeling is geconfigureerd. 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 - Failovergroep exemplaar is bezig met een andere bewerking. 409 GeoReplicationCannotBecomePrimaryDuringUndo - Gebruiker heeft geprobeerd een geo-link te failovern of te forceren, 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 er 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 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.

Name

Type

Description

200 OK

InstanceFailoverGroupListResult

De failovergroepen zijn opgehaald.

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 ResourceNotFound - De aangevraagde resource is niet gevonden.
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 ManagedInstanceHasHybridLink - Gebruiker heeft geprobeerd een bewerking te starten die niet wordt ondersteund wanneer voor het beheerde exemplaar een hybride koppeling is geconfigureerd.
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 - Failovergroep exemplaar is bezig met een andere bewerking.
409 GeoReplicationCannotBecomePrimaryDuringUndo - Gebruiker heeft geprobeerd een geo-link te failovern of te forceren, 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 er 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 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

List failover group

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


/**
 * Samples for InstanceFailoverGroups ListByLocation.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/InstanceFailoverGroupList.json
     */
    /**
     * Sample code: List failover group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listFailoverGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstanceFailoverGroups().listByLocation("Default", "Japan East",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test",
      "name": "failover-group-test",
      "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-1",
      "name": "failover-group-test-1",
      "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-1",
            "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance-1"
          }
        ]
      }
    }
  ]
}

Definities

Name	Description
InstanceFailoverGroup	Een exemplaarfailovergroep.
InstanceFailoverGroupListResult	Een lijst met exemplaarfailovergroepen.
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.

InstanceFailoverGroupListResult

Een lijst met exemplaarfailovergroepen.

Name	Type	Description
nextLink	string	Koppeling om de volgende pagina met resultaten op te halen.
value	InstanceFailoverGroup[]	Matrix met resultaten.

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

Delen via

Instance Failover Groups - List By Location

URI-parameters

Antwoorden

Voorbeelden

List failover group

Voorbeeldaanvraag

Voorbeeldrespons

Definities

InstanceFailoverGroup

InstanceFailoverGroupListResult

InstanceFailoverGroupReadOnlyEndpoint

InstanceFailoverGroupReadWriteEndpoint

InstanceFailoverGroupReplicationRole

ManagedInstancePairInfo

PartnerRegionInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

Aanvullende resources