Instance Failover Groups - List By Location

Service:: SQL Database

API-versie:: 2023-08-01

Geeft een lijst weer van de failovergroepen op een locatie.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups?api-version=2023-08-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	ErrorResponse	Foutreacties: *** 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary: het opgegeven primaire veld in de aanvraagtekst van de aanvraag voor een failovergroep voor het maken of bijwerken van exemplaren is leeg of ongeldig. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner: het veld opgegeven partners in de aanvraagtekst van de aanvraag voor het maken of bijwerken van een exemplaarfailovergroep 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 opgegeven regio van het beheerde partnerexemplaren in de aanvraagtekst van de instantiefailovergroep is leeg of ongeldig. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Er wordt slechts één partnerregio ondersteund. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Er wordt slechts één beheerd exemplaarpaar ondersteund. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint : het veld readWriteEndpoint is vereist voor het maken of bijwerken van aanvragen. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid : de aanvraagbody voor de aanvraag voor het maken of bijwerken van een exemplaarfailovergroep 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 instantiefailovergroep moet groter zijn dan of gelijk zijn aan de minimum respijtperiode voor '{0}' minuten 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - De eigenschapfailoverWithDataLossGracePeriodMinutes moet worden opgegeven wanneer failoverbeleid Automatisch is geselecteerd voor het eindpunt lezen/schrijven. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - Het veld failoverPolicy voor het eindpunt lezen/schrijven is vereist voor het maken of bijwerken van aanvragen. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Respijtperiodewaarde mag niet worden opgegeven wanneer failoverbeleid Handmatig is geselecteerd voor het eindpunt lezen/schrijven. 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: de aanvraagbody van de aanvraag voor failovergroepen voor het maken of bijwerken van exemplaren mag de alleen-lezen eigenschap '{0}' niet wijzigen. 400 InstanceFailoverGroupFailoverRequestOnPrimary: de failoveraanvraag moet worden gestart op de secundaire server van de failovergroep van het exemplaar. 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Primaire server en de partnerserver van de failovergroep zijn afkomstig uit verschillende abonnementen. Kruisabonnement voor servers van failovergroep is niet toegestaan. 400 InvalidAddSecondaryPermission - Gebruiker heeft onvoldoende machtigingen om secundair toe te voegen op de opgegeven server. 400 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven. 400 ServerNotFound - De aangevraagde server is niet gevonden. 400 ServerEditionMismatch - Edition moet hetzelfde zijn als de primaire server bij het maken van een replicaserver. 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 met herstel na noodgeval. 400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft 400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft 400 IncorrectReplicationLinkState: de bewerking verwacht dat de database een verwachte status heeft op de replicatiekoppeling. 400 CloudLifterFogIn accessibleDbRoleMismatch - Kan database-{0} niet toegankelijk maken op SQL Managed Instance {1} toegankelijk omdat de instantierol in de failovergroep is gewijzigd van {2} in {3} terwijl de database de status Niet toegankelijk heeft. Herstel de oorspronkelijke databaserol door geo-failover uit te voeren en probeer het opnieuw. 400 CloudLifterGeodrBlocksDbActivate : kan database-{0} niet maken op SQL Managed Instance {1} toegankelijk vanwege een lopende geodr-bewerking. Wacht totdat de conflicterende bewerking is voltooid en probeer het opnieuw. 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 SecurityAzureKeyVaultUrlNullOrEmpty: 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 voor de Azure Key Vault. 400 SecurityAzureKeyVaultInvalidKeyName : de bewerking kan niet worden voltooid vanwege een ongeldige serversleutelnaam. 400 PlannedFailoverTimedOutForDatabase : gebruiker heeft een geplande failover aangeroepen, er is een time-out opgetreden en een specifieke database lijkt de schuld te zijn. 400 PlannedFailoverTimedOut - Gebruiker heeft een 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 geen service-principal voor de Azure Active Directory-bibliotheek is gevonden. 400 AzureKeyVaultMalformedVaultUri: de opgegeven Key Vault-URI is niet geldig. 400 CannotUseReservedDatabaseName - Kan in deze bewerking geen gereserveerde databasenaam gebruiken. 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 ManagedInstanceGeoDRNotAllowedForInstancePool : het maken van een groep voor automatische failover (GeoDR) wordt niet ondersteund voor beheerde exemplaren die zijn ingericht in exemplaarpools. Automatische failovergroepen kunnen alleen worden gemaakt voor zelfstandige beheerde exemplaren. 400 InvalidServerName - Ongeldige servernaam opgegeven. 400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - Failovergroep kan niet worden gemaakt omdat de database-indeling van het primaire exemplaar niet compatibel is met de databaseindeling van het secundaire exemplaar. Zie https://go.microsoft.com/fwlink/?linkid=2251601 voor meer informatie. 400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions - Failoverbewerking kan niet worden uitgevoerd omdat de databaseindeling niet overeenkomt tussen de exemplaren in de failovergroep. Overweeg om de database-indeling van het primaire exemplaar te upgraden of de failovergroep te verwijderen om het huidige secundaire exemplaar te promoveren naar een zelfstandige instantie. Zie https://go.microsoft.com/fwlink/?linkid=2251601 voor meer informatie. 400 SecurityAdalPrincipalCertExpiredError: de bewerking kan niet worden voltooid omdat het Azure Key Vault-principalcertificaat is verlopen. 400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium - Failovergroep implementeren wordt niet ondersteund met de gratis azure SQL Managed Instance-aanbieding. 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken. 400 SecurityInvalidAzureKeyVaultRecoveryLevel- De opgegeven Key Vault-URI is niet geldig. 400 ManagedInstanceGeoFailoverCannotBeExecuted - Managed Instance geo-failover kan momenteel niet worden uitgevoerd. Reden: '{0}'. 400 KeyMaterialNotFoundOnRemoteServer - Externe server heeft geen toegang tot sleutelmateriaal dat wordt gebruikt als een TDE-beveiliging. 400 SameKeyUriNotFoundOnRemoteServer - Secundaire server beschikt niet over het sleutelmateriaal uit dezelfde sleutelkluis als de versleutelingsbeveiliging van de primaire server waarvoor automatische rotatie van sleutels is ingeschakeld. 400 AzureKeyVaultRsaKeyNotSupported: de opgegeven sleutelkluis maakt gebruik van 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 ManagedInstanceUpdateSloOngoing : de bewerking kan niet worden voltooid omdat er een servicelaagwijziging wordt uitgevoerd voor het beheerde exemplaar{0}.' Wacht totdat de bewerking is voltooid en probeer het opnieuw. 400 FailoverGroupRegionMismatch - Partnerregio opgegeven in failovergroep moet overeenkomen met de regio van het door de partner beheerde exemplaar aangegeven. 400 DnsZoneMismatch - De DNSZone op de partnerserver verschilt van de DNSZone op de bronserver. Hierdoor wordt de functionaliteit InstanceFailoverGroup verbroken. 400 GeoDrInstanceSizeMismatch - Primair beheerd exemplaar en beheerd exemplaar van partner hebben niet dezelfde opslaggrootte. 400 UnableToResolveRemoteServer : de naam van de externe partnerserver kan niet worden omgezet vanwege een ongeldige servernaam of DNS-verbindingsproblemen. 400 GeoDrSecondaryInstanceNotEmpty - Secundair beheerd exemplaar heeft gebruikersdatabases. Als u een exemplaarfailovergroep wilt maken, moet het secundaire beheerde exemplaar leeg zijn. 400 RemoteDatabaseCopyPermission - Gebruiker beschikt niet over voldoende machtigingen om een databasekopie te maken op de opgegeven server. 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Netwerkconfiguratie is onjuist. Het replicatieverkeer van de primaire server kan geen secundaire server bereiken. 404 ResourceNotFound : de aangevraagde resource is niet gevonden. 404 ServerNotInSubscriptionResourceGroup - 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 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 ManagedInstanceContainsInaccessibleDatabases : de bewerking kan niet worden voltooid omdat het beheerde exemplaar '{0}' databases bevat die de status Niet toegankelijk hebben. Verwijder ontoegankelijke databases of los de problemen met toegang tot de door de klant beheerde TDE-protectorsleutel voor het beheerde exemplaar op voordat u de bewerking opnieuw probeert uit te voeren. https://go.microsoft.com/fwlink/?linkid=2111623 409 ManagedInstanceHasHybridLink : gebruiker heeft geprobeerd een bewerking te starten die niet wordt ondersteund wanneer een beheerd exemplaar een hybride koppeling heeft geconfigureerd. 409 GeoReplicationCannotBecomePrimaryDuringUndo - Gebruiker heeft geprobeerd een geo-link uit te voeren of een geo-link af te sluiten, terwijl de secundaire 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 er een SLO-update werd uitgevoerd. 409 AzureKeyVaultKeyNameNotFound: de bewerking kan niet worden voltooid omdat de Azure Key Vault-sleutelnaam niet bestaat. 409 AzureKeyVaultKeyInUse: de sleutel wordt momenteel gebruikt door de server. 409 InstanceFailoverGroupAlreadyExists - Failovergroep bestaat al op een bepaalde server. 409 InstanceFailoverGroupBusy - ExemplaarfailoverGroupBusy is bezig met een andere bewerking. 409 InstanceFailoverGroupDnsRecordInUse: er bestaat een dubbele DNS-record voor het aangevraagde eindpunt. 409 InvalidFailoverGroupName - Ongeldige naam van failovergroep exemplaar is opgegeven. 409 InvalidOperationForDatabaseNotInReplicationRelationship - Er is een replicatiebewerking uitgevoerd op een database die zich niet in een replicatierelatie bevindt. 409 InvalidDatabaseStateForOperation: de bewerking is niet toegestaan voor de database met 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 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. 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen 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-gegevens. 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Name

Type

Description

200 OK

InstanceFailoverGroupListResult

De failovergroepen zijn opgehaald.

Other Status Codes

ErrorResponse

Foutreacties: ***

400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary: het opgegeven primaire veld in de aanvraagtekst van de aanvraag voor een failovergroep voor het maken of bijwerken van exemplaren is leeg of ongeldig.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner: het veld opgegeven partners in de aanvraagtekst van de aanvraag voor het maken of bijwerken van een exemplaarfailovergroep 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 opgegeven regio van het beheerde partnerexemplaren in de aanvraagtekst van de instantiefailovergroep is leeg of ongeldig.
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Er wordt slechts één partnerregio ondersteund.
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Er wordt slechts één beheerd exemplaarpaar ondersteund.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint : het veld readWriteEndpoint is vereist voor het maken of bijwerken van aanvragen.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalid : de aanvraagbody voor de aanvraag voor het maken of bijwerken van een exemplaarfailovergroep 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 instantiefailovergroep moet groter zijn dan of gelijk zijn aan de minimum respijtperiode voor '{0}' minuten
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - De eigenschapfailoverWithDataLossGracePeriodMinutes moet worden opgegeven wanneer failoverbeleid Automatisch is geselecteerd voor het eindpunt lezen/schrijven.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - Het veld failoverPolicy voor het eindpunt lezen/schrijven is vereist voor het maken of bijwerken van aanvragen.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Respijtperiodewaarde mag niet worden opgegeven wanneer failoverbeleid Handmatig is geselecteerd voor het eindpunt lezen/schrijven.
400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: de aanvraagbody van de aanvraag voor failovergroepen voor het maken of bijwerken van exemplaren mag de alleen-lezen eigenschap '{0}' niet wijzigen.
400 InstanceFailoverGroupFailoverRequestOnPrimary: de failoveraanvraag moet worden gestart op de secundaire server van de failovergroep van het exemplaar.
400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Primaire server en de partnerserver van de failovergroep zijn afkomstig uit verschillende abonnementen. Kruisabonnement voor servers van failovergroep is niet toegestaan.
400 InvalidAddSecondaryPermission - Gebruiker heeft onvoldoende machtigingen om secundair toe te voegen op de opgegeven server.
400 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven.
400 ServerNotFound - De aangevraagde server is niet gevonden.
400 ServerEditionMismatch - Edition moet hetzelfde zijn als de primaire server bij het maken van een replicaserver.
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 met herstel na noodgeval.
400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft
400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft
400 IncorrectReplicationLinkState: de bewerking verwacht dat de database een verwachte status heeft op de replicatiekoppeling.
400 CloudLifterFogIn accessibleDbRoleMismatch - Kan database-{0} niet toegankelijk maken op SQL Managed Instance {1} toegankelijk omdat de instantierol in de failovergroep is gewijzigd van {2} in {3} terwijl de database de status Niet toegankelijk heeft. Herstel de oorspronkelijke databaserol door geo-failover uit te voeren en probeer het opnieuw.
400 CloudLifterGeodrBlocksDbActivate : kan database-{0} niet maken op SQL Managed Instance {1} toegankelijk vanwege een lopende geodr-bewerking. Wacht totdat de conflicterende bewerking is voltooid en probeer het opnieuw.
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 SecurityAzureKeyVaultUrlNullOrEmpty: 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 voor de Azure Key Vault.
400 SecurityAzureKeyVaultInvalidKeyName : de bewerking kan niet worden voltooid vanwege een ongeldige serversleutelnaam.
400 PlannedFailoverTimedOutForDatabase : gebruiker heeft een geplande failover aangeroepen, er is een time-out opgetreden en een specifieke database lijkt de schuld te zijn.
400 PlannedFailoverTimedOut - Gebruiker heeft een 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 geen service-principal voor de Azure Active Directory-bibliotheek is gevonden.
400 AzureKeyVaultMalformedVaultUri: de opgegeven Key Vault-URI is niet geldig.
400 CannotUseReservedDatabaseName - Kan in deze bewerking geen gereserveerde databasenaam gebruiken.
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 ManagedInstanceGeoDRNotAllowedForInstancePool : het maken van een groep voor automatische failover (GeoDR) wordt niet ondersteund voor beheerde exemplaren die zijn ingericht in exemplaarpools. Automatische failovergroepen kunnen alleen worden gemaakt voor zelfstandige beheerde exemplaren.
400 InvalidServerName - Ongeldige servernaam opgegeven.
400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - Failovergroep kan niet worden gemaakt omdat de database-indeling van het primaire exemplaar niet compatibel is met de databaseindeling van het secundaire exemplaar. Zie https://go.microsoft.com/fwlink/?linkid=2251601 voor meer informatie.
400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions - Failoverbewerking kan niet worden uitgevoerd omdat de databaseindeling niet overeenkomt tussen de exemplaren in de failovergroep. Overweeg om de database-indeling van het primaire exemplaar te upgraden of de failovergroep te verwijderen om het huidige secundaire exemplaar te promoveren naar een zelfstandige instantie. Zie https://go.microsoft.com/fwlink/?linkid=2251601 voor meer informatie.
400 SecurityAdalPrincipalCertExpiredError: de bewerking kan niet worden voltooid omdat het Azure Key Vault-principalcertificaat is verlopen.
400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium - Failovergroep implementeren wordt niet ondersteund met de gratis azure SQL Managed Instance-aanbieding.
400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken.
400 SecurityInvalidAzureKeyVaultRecoveryLevel- De opgegeven Key Vault-URI is niet geldig.
400 ManagedInstanceGeoFailoverCannotBeExecuted - Managed Instance geo-failover kan momenteel niet worden uitgevoerd. Reden: '{0}'.
400 KeyMaterialNotFoundOnRemoteServer - Externe server heeft geen toegang tot sleutelmateriaal dat wordt gebruikt als een TDE-beveiliging.
400 SameKeyUriNotFoundOnRemoteServer - Secundaire server beschikt niet over het sleutelmateriaal uit dezelfde sleutelkluis als de versleutelingsbeveiliging van de primaire server waarvoor automatische rotatie van sleutels is ingeschakeld.
400 AzureKeyVaultRsaKeyNotSupported: de opgegeven sleutelkluis maakt gebruik van 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 ManagedInstanceUpdateSloOngoing : de bewerking kan niet worden voltooid omdat er een servicelaagwijziging wordt uitgevoerd voor het beheerde exemplaar{0}.' Wacht totdat de bewerking is voltooid en probeer het opnieuw.
400 FailoverGroupRegionMismatch - Partnerregio opgegeven in failovergroep moet overeenkomen met de regio van het door de partner beheerde exemplaar aangegeven.
400 DnsZoneMismatch - De DNSZone op de partnerserver verschilt van de DNSZone op de bronserver. Hierdoor wordt de functionaliteit InstanceFailoverGroup verbroken.
400 GeoDrInstanceSizeMismatch - Primair beheerd exemplaar en beheerd exemplaar van partner hebben niet dezelfde opslaggrootte.
400 UnableToResolveRemoteServer : de naam van de externe partnerserver kan niet worden omgezet vanwege een ongeldige servernaam of DNS-verbindingsproblemen.
400 GeoDrSecondaryInstanceNotEmpty - Secundair beheerd exemplaar heeft gebruikersdatabases. Als u een exemplaarfailovergroep wilt maken, moet het secundaire beheerde exemplaar leeg zijn.
400 RemoteDatabaseCopyPermission - Gebruiker beschikt niet over voldoende machtigingen om een databasekopie te maken op de opgegeven server.
400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Netwerkconfiguratie is onjuist. Het replicatieverkeer van de primaire server kan geen secundaire server bereiken.
404 ResourceNotFound : de aangevraagde resource is niet gevonden.
404 ServerNotInSubscriptionResourceGroup - 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 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 ManagedInstanceContainsInaccessibleDatabases : de bewerking kan niet worden voltooid omdat het beheerde exemplaar '{0}' databases bevat die de status Niet toegankelijk hebben. Verwijder ontoegankelijke databases of los de problemen met toegang tot de door de klant beheerde TDE-protectorsleutel voor het beheerde exemplaar op voordat u de bewerking opnieuw probeert uit te voeren. https://go.microsoft.com/fwlink/?linkid=2111623
409 ManagedInstanceHasHybridLink : gebruiker heeft geprobeerd een bewerking te starten die niet wordt ondersteund wanneer een beheerd exemplaar een hybride koppeling heeft geconfigureerd.
409 GeoReplicationCannotBecomePrimaryDuringUndo - Gebruiker heeft geprobeerd een geo-link uit te voeren of een geo-link af te sluiten, terwijl de secundaire 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 er een SLO-update werd uitgevoerd.
409 AzureKeyVaultKeyNameNotFound: de bewerking kan niet worden voltooid omdat de Azure Key Vault-sleutelnaam niet bestaat.
409 AzureKeyVaultKeyInUse: de sleutel wordt momenteel gebruikt door de server.
409 InstanceFailoverGroupAlreadyExists - Failovergroep bestaat al op een bepaalde server.
409 InstanceFailoverGroupBusy - ExemplaarfailoverGroupBusy is bezig met een andere bewerking.
409 InstanceFailoverGroupDnsRecordInUse: er bestaat een dubbele DNS-record voor het aangevraagde eindpunt.
409 InvalidFailoverGroupName - Ongeldige naam van failovergroep exemplaar is opgegeven.
409 InvalidOperationForDatabaseNotInReplicationRelationship - Er is een replicatiebewerking uitgevoerd op een database die zich niet in een replicatierelatie bevindt.
409 InvalidDatabaseStateForOperation: de bewerking is niet toegestaan voor de database met 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 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.
503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen 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-gegevens.
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=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/InstanceFailoverGroupList.json
// this example is just showing the usage of "InstanceFailoverGroups_ListByLocation" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://free.blessedness.top/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this InstanceFailoverGroupResource
AzureLocation locationName = new AzureLocation("Japan East");
InstanceFailoverGroupCollection collection = resourceGroupResource.GetInstanceFailoverGroups(locationName);

// invoke the operation and iterate over the result
await foreach (InstanceFailoverGroupResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    InstanceFailoverGroupData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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"
          }
        ],
        "secondaryType": "Geo"
      }
    },
    {
      "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"
          }
        ],
        "secondaryType": "Geo"
      }
    }
  ]
}

Definities

Name	Description
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
InstanceFailoverGroup	Een exemplaarfailovergroep.
InstanceFailoverGroupListResult	Een lijst met exemplaarfailovergroepen.
InstanceFailoverGroupReadOnlyEndpoint	Alleen-lezeneindpunt 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	Informatie over de partnerregio 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.
SecondaryInstanceType	Type van het geo-secundaire exemplaar. Stel Stand-by in als het exemplaar alleen als dr-optie wordt gebruikt.

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.

InstanceFailoverGroup

Object

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[]	Informatie over de partnerregio voor de failovergroep.
properties.readOnlyEndpoint	InstanceFailoverGroupReadOnlyEndpoint	Alleen-lezeneindpunt 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.
properties.secondaryType	SecondaryInstanceType	Type van het geo-secundaire exemplaar. Stel Stand-by in als het exemplaar alleen als dr-optie wordt gebruikt.
type	string	Resourcetype.

InstanceFailoverGroupListResult

Object

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

Object

Alleen-lezeneindpunt van het exemplaar van de failovergroep.

Name	Type	Description
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Failoverbeleid van het alleen-lezen eindpunt voor de failovergroep.

InstanceFailoverGroupReadWriteEndpoint

Object

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 (int32)	Respijtperiode voordat een failover met gegevensverlies wordt uitgevoerd voor het eindpunt voor lezen/schrijven. Als failoverPolicy Automatisch is, is failoverWithDataLossGracePeriodMinutes vereist.

InstanceFailoverGroupReplicationRole

Inventarisatie

Lokale replicatierol van het exemplaar van de failovergroep.

Waarde	Description
Primary
Secondary

ManagedInstancePairInfo

Object

Paren van beheerde exemplaren in de failovergroep.

Name	Type	Description
partnerManagedInstanceId	string	Id van partnerbeheerexemplaren in combinatie.
primaryManagedInstanceId	string	Id van primair beheerd exemplaar in combinatie.

PartnerRegionInfo

Object

Informatie over de partnerregio voor de failovergroep.

Name	Type	Description
location	string	Geografische locatie van de beheerde exemplaren van de partner.
replicationRole	InstanceFailoverGroupReplicationRole	Replicatierol van de door de partner beheerde exemplaren.

ReadOnlyEndpointFailoverPolicy

Inventarisatie

Failoverbeleid van het alleen-lezen eindpunt voor de failovergroep.

Waarde	Description
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

Inventarisatie

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

Waarde	Description
Manual
Automatic

SecondaryInstanceType

Inventarisatie

Type van het geo-secundaire exemplaar. Stel Stand-by in als het exemplaar alleen als dr-optie wordt gebruikt.

Waarde	Description
Geo
Standby

Delen via

Instance Failover Groups - List By Location

URI-parameters

Antwoorden

Voorbeelden

List failover group

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InstanceFailoverGroup

InstanceFailoverGroupListResult

InstanceFailoverGroupReadOnlyEndpoint

InstanceFailoverGroupReadWriteEndpoint

InstanceFailoverGroupReplicationRole

ManagedInstancePairInfo

PartnerRegionInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

SecondaryInstanceType