Failover Groups - List By Server

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Listet die Failovergruppen auf einem Server auf.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers, der die Failovergruppe enthält.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	FailoverGroupListResult	Die Failovergruppen wurden erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – Die bereitgestellten Datenbank-IDs sind keine ordnungsgemäß erstellten Datenbankressourcen-IDs. Ein Beispiel für die richtige Formatierung finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidPartner – Das angegebene Partnerfeld beim Erstellen oder Aktualisieren des Anforderungstexts für Failovergruppen ist leer oder ungültig. Geben Sie einen gültigen Wert für dieses Feld an. Beispiele für ordnungsgemäß formatierte Anforderungen finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – Mindestens ein der bereitgestellten Partnerserver ist bereits Teil der Failovergruppe. Stellen Sie sicher, dass der primäre Server und alle angegebenen Partnerserver eindeutig sind. 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – Mindestens eine der bereitgestellten Datenbanken ist auf dem primären Server der Failovergruppe nicht vorhanden. Stellen Sie sicher, dass alle Datenbanken auf dem primären Server vorhanden sind. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – Nur ein Partnerserver für Failovergruppe wird unterstützt. Bitte ändern Sie Ihre Anfrage entsprechend. Beispiele für gültige Anforderungen finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – Das ReadWriteEndpoint-Feld ist zum Erstellen oder Aktualisieren von Anforderungen erforderlich. 400 FailoverGroupCreateOrUpdateRequestInvalid – Der Anforderungstext der Failovergruppe erstellen oder aktualisieren ist leer oder ungültig. 400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Änderungen an der Failovergruppe sind auf einem sekundären Server nicht zulässig. Führen Sie die Anforderung auf dem primären Server aus. 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Grace period value for the read-write endpoint must be non-negative. 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – Karenzzeitraumswert für die Failovergruppe muss größer oder gleich dem "{0}" Minuten mindester Karenzzeitraum sein 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Das EigenschaftsfailoverWithDataLossGracePeriodMinutes muss bereitgestellt werden, wenn failoverrichtlinien automatisch für den Lese-/Schreibzugriffsendpunkt ausgewählt wird. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – Das FailoverPolicy-Feld für den Lese-/Schreibzugriffsendpunkt ist zum Erstellen oder Aktualisieren von Anforderungen erforderlich. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – Grace period value should not be provided when failover policy Manual is selected for the read-write endpoint. Entfernen Sie sie aus der Anforderung. 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Der Textkörper der Failovergruppenanforderung sollte die schreibgeschützte Eigenschaft "{0}" nicht ändern. 400 FailoverGroupFailoverRequestOnPrimary – Die Failoveranforderung sollte auf dem sekundären Server der Failovergruppe initiiert werden. 400 FailoverGroupPartnerServerFromDifferentSubscription – Primärer Server und die Partnerserver der Failovergruppe stammen aus verschiedenen Abonnements. Abonnementübergreifendes Abonnement für Server der Failovergruppe ist nicht zulässig. 400 InvalidAddSecondaryPermission – Der Benutzer verfügt nicht über ausreichende Berechtigungen, um dem angegebenen Server sekundäre Elemente hinzuzufügen. 400 InvalidSku – Der Benutzer hat eine ungültige Sku angegeben. 400 ServerNotFound – Der angeforderte Server wurde nicht gefunden. 400 FeatureDisabledOnSelectedEdition – Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist. 400 TokenTooLong – Das bereitgestellte Token ist zu lang. 400 InvalidTargetSubregion – Der Zielserver eines nicht lesbaren sekundären Objekts befindet sich nicht in einer dr-gekoppelten Azure-Region. 400 PartnerServerNotCompatible - Der Benutzer versucht, eine Datenbank von einem SAWA V1-Server auf einen Sterling-Server zu kopieren oder umgekehrt. 400 IncorrectReplicationLinkState – Der Vorgang erwartet, dass sich die Datenbank in einem erwarteten Zustand auf der Replikationsverknüpfung befindet. 400 ResourcePoolNotFound - Der angegebene elastische Pool ist auf dem angegebenen logischen Server nicht vorhanden. 400 AzureKeyVaultKeyDisabled – Der Vorgang konnte auf dem Server nicht abgeschlossen werden, da der Azure Key Vault-Schlüssel deaktiviert ist. 400 AzureKeyVaultInvalidExpirationDate – Der Vorgang konnte nicht abgeschlossen werden, da das Ablaufdatum des Azure Key Vault-Schlüssels ungültig ist. 400 SecurityAzureKeyVaultUrlNullOrEmpty – Der Vorgang konnte nicht abgeschlossen werden, da der Azure Key Vault-URI null oder leer ist. 400 AzureKeyVaultNoServerIdentity – Die Serveridentität ist nicht ordnungsgemäß konfiguriert. 400 AzureKeyVaultInvalidUri – Eine ungültige Antwort von Azure Key Vault. Verwenden Sie einen gültigen Azure Key Vault-URI. 400 AzureKeyVaultMissingPermissions – Der Server fehlt die erforderlichen Berechtigungen für den Azure Key Vault. 400 SecurityAzureKeyVaultInvalidKeyName – Der Vorgang konnte aufgrund eines ungültigen Serverschlüsselnamens nicht abgeschlossen werden. 400 PlannedFailoverTimedOutForDatabase – Der Benutzer hat ein geplantes Failover aufgerufen, es ist ein Timeout, und eine bestimmte Datenbank scheint schuld zu sein. 400 PlannedFailoverTimedOut – Der Benutzer hat ein geplantes Failover aufgerufen, und es wurde beim Versuch, sich an den Partnerverwaltungsdienst zu wenden, timeout. 400 AdalGenericError – Der Vorgang konnte nicht abgeschlossen werden, weil ein Azure Active Directory-Fehler aufgetreten ist. 400 AdalServicePrincipalNotFound – Der Vorgang konnte nicht abgeschlossen werden, weil ein Azure Active Directory-Bibliotheksdienstprinzipal nicht gefunden wurde. 400 AzureKeyVaultMalformedVaultUri – Der bereitgestellte Key Vault-URI ist ungültig. 400 CannotUseReservedDatabaseName – In diesem Vorgang kann kein reservierter Datenbankname verwendet werden. 400 InvalidFailoverGroupRegion – Server, die in einer Failovergruppe angegeben sind, müssen sich in verschiedenen Regionen befinden, um Isolation bereitzustellen. 400 FailoverGroupDoesNotExist – Failovergruppe ist auf einem Server nicht vorhanden. 400 FailoverGroupNotSecondary – Failover kann nicht vom primären Server in einer Failovergruppe initiiert werden. 400 InvalidServerName – Ungültiger Servername angegeben. 400 DatabaseInFailoverGroupNotPrimary – GeoDR-Link für die Datenbank ist bereits vorhanden, ihre Rolle ist jedoch nicht "Primär" oder ist kein fortlaufender Kopierlink. 400 SecurityAdalPrincipalCertExpiredError – Der Vorgang konnte nicht abgeschlossen werden, da das Azure Key Vault-Prinzipalzertifikat abgelaufen ist. 400 CannotToCreateFailoverGroupDueToTableAuditing – Failovergruppe kann nicht für Server erstellt werden, auf dem die Tabellenüberwachung aktiviert ist. 400 InvalidIdentifier – Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen. 400 UnableToAddDbWithTableAuditingToFailoverGroup – Datenbank mit aktivierter Tabellenüberwachung kann nicht über den Failovergruppenendpunkt zugegriffen werden. 400 SecurityInvalidAzureKeyVaultRecoveryLevel – Der bereitgestellte Key Vault-URI ist ungültig. 400 KeyMaterialNotFoundOnRemoteServer – Remoteserver hat keinen Zugriff auf Schlüsselmaterial, das als TDE-Schutz verwendet wird. 400 LimitOfFailoverGroupsPerServerExceeded – Das Erstellen einer neuen Failovergruppe überschreitet die zulässige Anzahl von Failovergruppen pro Server. 400 SameKeyUriNotFoundOnRemoteServer – Der sekundäre Server verfügt nicht über das Schlüsselmaterial aus demselben Schlüsseltresor wie die Verschlüsselungsschutzvorrichtung des primären Servers mit aktivierter Automatischdrehung des Schlüssels. 400 AzureKeyVaultRsaKeyNotSupported – Der bereitgestellte Schlüsseltresor verwendet nicht unterstützte RSA Key Size oder Key Type. Die unterstützte RSA-Schlüsselgröße ist 2048 oder 3072, und der Schlüsseltyp ist RSA oder RSA-HSM. 400 SameKeyMaterialNotFoundOnRemoteServer – Sekundärer Server verfügt nicht über das Schlüsselmaterial der Verschlüsselungsschutzkomponente des primären Servers. 400 GeoReplicationDatabaseNotSecondary – Der Vorgang erwartet, dass die Datenbank ein Replikationsziel ist. 400 GeoReplicaLimitReached – Die Replikatreplikationsgrenze wurde erreicht. 400 FailoverGroupWithVirtualNetworkRulesNotSupported – Failovergruppen, die mit einer automatischen Failoverrichtlinie konfiguriert sind, werden derzeit auf Servern, die mit Firewallregeln für virtuelle Netzwerke konfiguriert sind, nicht unterstützt. Konfigurieren Sie die Failovergruppe mit manueller Failoverrichtlinie. 400 UnableToResolveRemoteServer – Der Name des Remotepartnerservers konnte aufgrund eines ungültigen Servernamens oder DNS-Verbindungsproblemen nicht behoben werden. 400 RemoteDatabaseCopyPermission – Der Benutzer verfügt nicht über ausreichende Berechtigungen zum Erstellen einer Datenbankkopie auf dem angegebenen Server. 400 SecurityAzureKeyVaultGeoChainError – Das Erstellen einer sekundären (als Verkettung bezeichneter Prozess) wird beim Aktivieren der transparenten Datenverschlüsselung mit Azure Key Vault (BYOK) nicht unterstützt. 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ServerNotInSubscription – Der angegebene Server ist für das angegebene Abonnement nicht vorhanden. 404 SourceDatabaseNotFound – Die Quelldatenbank ist nicht vorhanden. 405 UnsupportedReplicationOperation – Ein nicht unterstützter Replikationsvorgang wurde in der Datenbank initiiert. 409 ConflictingServerOperation – Ein Vorgang wird derzeit für den Server ausgeführt. 409 SubscriptionDisabled – Abonnement ist deaktiviert. 409 ConflictingSystemOperationInProgress – Ein Systemwartungsvorgang wird für die Datenbank ausgeführt, und weitere Vorgänge müssen warten, bis sie abgeschlossen ist. 409 GeoReplicationCannotBecomePrimaryDuringUndo – Der Benutzer hat versucht, eine Geoverknüpfung zu failovern oder zu erzwingen, während sich die sekundäre Verbindung in einem Zustand befindet, in dem sie möglicherweise nicht physisch konsistent ist und daher nicht in die primäre Rolle eintreten kann. 409 ServerKeyNameAlreadyExists – Der Serverschlüssel ist bereits auf dem Server vorhanden. 409 ServerKeyUriAlreadyExists – Der Serverschlüssel-URI ist bereits auf dem Server vorhanden. 409 ServerKeyDoesNotExists – Der Serverschlüssel ist nicht vorhanden. 409 UpdateSloInProgress – Der Benutzer hat versucht, einen inkompatiblen Vorgang zu initiieren, während ein SLO-Update ausgeführt wurde. 409 AzureKeyVaultKeyNameNotFound – Der Vorgang konnte nicht abgeschlossen werden, da der Azure Key Vault Key-Name nicht vorhanden ist. 409 AzureKeyVaultKeyInUse – Der Schlüssel wird derzeit vom Server verwendet. 409 FailoverGroupAlreadyExists – Failovergruppe ist bereits auf einem bestimmten Server vorhanden. Verwenden Sie einen anderen Failovergruppennamen. 409 FailoverGroupBusy – Failovergruppe ist mit einem anderen Vorgang beschäftigt. 409 DatabaseBelongsToOtherFailoverGroup – Die Datenbank gehört zu einer anderen Failovergruppe und kann nicht als Teil dieser Gruppe betrachtet werden. 409 DatabaseBeingAddedToFailoverGroup – Die Datenbank wird derzeit der Failovergruppe hinzugefügt, der Kunde muss warten, bis dieser Vorgang beendet ist, um das Problem zu entfernen. 409 DatabaseBeingRemovedFromFailoverGroup – Die Datenbank wird zurzeit aus der Failovergruppe entfernt, der Kunde muss warten, bis dieser Vorgang abgeschlossen ist, um das Problem hinzuzufügen. 409 FailoverGroupDnsRecordInUse – Ein doppelter DNS-Eintrag ist für den angeforderten Endpunkt vorhanden. 409 InvalidFailoverGroupName – Ungültiger Failovergruppenname wurde angegeben. 409 InvalidOperationForDatabaseNotInReplicationRelationship – Ein Replikations-Seedingvorgang wurde für eine Datenbank ausgeführt, die sich bereits in einer Replikationsbeziehung befindet. 409 InvalidDatabaseStateForOperation – Der Vorgang ist für die Datenbank im aktuellen Replikationsstatus nicht zulässig. 409 DuplicateGeoDrRelation - Die Datenbanken befinden sich bereits in einer Replikationsbeziehung. Dies ist eine doppelte Anforderung. 409 RemoteDatabaseExists – Der Zieldatenbankname ist bereits auf dem Zielserver vorhanden. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 503 AzureKeyVaultConnectionFailed – Der Vorgang konnte auf dem Server nicht abgeschlossen werden, da Versuche, eine Verbindung mit Azure Key Vault herzustellen, fehlgeschlagen sind. 503 AzureKeyVaultGenericConnectionError – Der Vorgang konnte nicht abgeschlossen werden, weil beim Versuch, Key Vault-Informationen abzurufen, ein Fehler aufgetreten ist. 503 DatabaseUnavailable – Fehler beim Vorgang, weil die Datenbank nicht verfügbar ist. 504 RequestTimeout – Serviceanforderung hat das zulässige Timeout überschritten.

Name

Typ

Beschreibung

200 OK

FailoverGroupListResult

Die Failovergruppen wurden erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – Die bereitgestellten Datenbank-IDs sind keine ordnungsgemäß erstellten Datenbankressourcen-IDs. Ein Beispiel für die richtige Formatierung finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestInvalidPartner – Das angegebene Partnerfeld beim Erstellen oder Aktualisieren des Anforderungstexts für Failovergruppen ist leer oder ungültig. Geben Sie einen gültigen Wert für dieses Feld an. Beispiele für ordnungsgemäß formatierte Anforderungen finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – Mindestens ein der bereitgestellten Partnerserver ist bereits Teil der Failovergruppe. Stellen Sie sicher, dass der primäre Server und alle angegebenen Partnerserver eindeutig sind.
400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – Mindestens eine der bereitgestellten Datenbanken ist auf dem primären Server der Failovergruppe nicht vorhanden. Stellen Sie sicher, dass alle Datenbanken auf dem primären Server vorhanden sind.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – Nur ein Partnerserver für Failovergruppe wird unterstützt. Bitte ändern Sie Ihre Anfrage entsprechend. Beispiele für gültige Anforderungen finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – Das ReadWriteEndpoint-Feld ist zum Erstellen oder Aktualisieren von Anforderungen erforderlich.
400 FailoverGroupCreateOrUpdateRequestInvalid – Der Anforderungstext der Failovergruppe erstellen oder aktualisieren ist leer oder ungültig.
400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Änderungen an der Failovergruppe sind auf einem sekundären Server nicht zulässig. Führen Sie die Anforderung auf dem primären Server aus.
400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Grace period value for the read-write endpoint must be non-negative.
400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – Karenzzeitraumswert für die Failovergruppe muss größer oder gleich dem "{0}" Minuten mindester Karenzzeitraum sein
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Das EigenschaftsfailoverWithDataLossGracePeriodMinutes muss bereitgestellt werden, wenn failoverrichtlinien automatisch für den Lese-/Schreibzugriffsendpunkt ausgewählt wird.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – Das FailoverPolicy-Feld für den Lese-/Schreibzugriffsendpunkt ist zum Erstellen oder Aktualisieren von Anforderungen erforderlich.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – Grace period value should not be provided when failover policy Manual is selected for the read-write endpoint. Entfernen Sie sie aus der Anforderung.
400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Der Textkörper der Failovergruppenanforderung sollte die schreibgeschützte Eigenschaft "{0}" nicht ändern.
400 FailoverGroupFailoverRequestOnPrimary – Die Failoveranforderung sollte auf dem sekundären Server der Failovergruppe initiiert werden.
400 FailoverGroupPartnerServerFromDifferentSubscription – Primärer Server und die Partnerserver der Failovergruppe stammen aus verschiedenen Abonnements. Abonnementübergreifendes Abonnement für Server der Failovergruppe ist nicht zulässig.
400 InvalidAddSecondaryPermission – Der Benutzer verfügt nicht über ausreichende Berechtigungen, um dem angegebenen Server sekundäre Elemente hinzuzufügen.
400 InvalidSku – Der Benutzer hat eine ungültige Sku angegeben.
400 ServerNotFound – Der angeforderte Server wurde nicht gefunden.
400 FeatureDisabledOnSelectedEdition – Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist.
400 TokenTooLong – Das bereitgestellte Token ist zu lang.
400 InvalidTargetSubregion – Der Zielserver eines nicht lesbaren sekundären Objekts befindet sich nicht in einer dr-gekoppelten Azure-Region.
400 PartnerServerNotCompatible - Der Benutzer versucht, eine Datenbank von einem SAWA V1-Server auf einen Sterling-Server zu kopieren oder umgekehrt.
400 IncorrectReplicationLinkState – Der Vorgang erwartet, dass sich die Datenbank in einem erwarteten Zustand auf der Replikationsverknüpfung befindet.
400 ResourcePoolNotFound - Der angegebene elastische Pool ist auf dem angegebenen logischen Server nicht vorhanden.
400 AzureKeyVaultKeyDisabled – Der Vorgang konnte auf dem Server nicht abgeschlossen werden, da der Azure Key Vault-Schlüssel deaktiviert ist.
400 AzureKeyVaultInvalidExpirationDate – Der Vorgang konnte nicht abgeschlossen werden, da das Ablaufdatum des Azure Key Vault-Schlüssels ungültig ist.
400 SecurityAzureKeyVaultUrlNullOrEmpty – Der Vorgang konnte nicht abgeschlossen werden, da der Azure Key Vault-URI null oder leer ist.
400 AzureKeyVaultNoServerIdentity – Die Serveridentität ist nicht ordnungsgemäß konfiguriert.
400 AzureKeyVaultInvalidUri – Eine ungültige Antwort von Azure Key Vault. Verwenden Sie einen gültigen Azure Key Vault-URI.
400 AzureKeyVaultMissingPermissions – Der Server fehlt die erforderlichen Berechtigungen für den Azure Key Vault.
400 SecurityAzureKeyVaultInvalidKeyName – Der Vorgang konnte aufgrund eines ungültigen Serverschlüsselnamens nicht abgeschlossen werden.
400 PlannedFailoverTimedOutForDatabase – Der Benutzer hat ein geplantes Failover aufgerufen, es ist ein Timeout, und eine bestimmte Datenbank scheint schuld zu sein.
400 PlannedFailoverTimedOut – Der Benutzer hat ein geplantes Failover aufgerufen, und es wurde beim Versuch, sich an den Partnerverwaltungsdienst zu wenden, timeout.
400 AdalGenericError – Der Vorgang konnte nicht abgeschlossen werden, weil ein Azure Active Directory-Fehler aufgetreten ist.
400 AdalServicePrincipalNotFound – Der Vorgang konnte nicht abgeschlossen werden, weil ein Azure Active Directory-Bibliotheksdienstprinzipal nicht gefunden wurde.
400 AzureKeyVaultMalformedVaultUri – Der bereitgestellte Key Vault-URI ist ungültig.
400 CannotUseReservedDatabaseName – In diesem Vorgang kann kein reservierter Datenbankname verwendet werden.
400 InvalidFailoverGroupRegion – Server, die in einer Failovergruppe angegeben sind, müssen sich in verschiedenen Regionen befinden, um Isolation bereitzustellen.
400 FailoverGroupDoesNotExist – Failovergruppe ist auf einem Server nicht vorhanden.
400 FailoverGroupNotSecondary – Failover kann nicht vom primären Server in einer Failovergruppe initiiert werden.
400 InvalidServerName – Ungültiger Servername angegeben.
400 DatabaseInFailoverGroupNotPrimary – GeoDR-Link für die Datenbank ist bereits vorhanden, ihre Rolle ist jedoch nicht "Primär" oder ist kein fortlaufender Kopierlink.
400 SecurityAdalPrincipalCertExpiredError – Der Vorgang konnte nicht abgeschlossen werden, da das Azure Key Vault-Prinzipalzertifikat abgelaufen ist.
400 CannotToCreateFailoverGroupDueToTableAuditing – Failovergruppe kann nicht für Server erstellt werden, auf dem die Tabellenüberwachung aktiviert ist.
400 InvalidIdentifier – Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen.
400 UnableToAddDbWithTableAuditingToFailoverGroup – Datenbank mit aktivierter Tabellenüberwachung kann nicht über den Failovergruppenendpunkt zugegriffen werden.
400 SecurityInvalidAzureKeyVaultRecoveryLevel – Der bereitgestellte Key Vault-URI ist ungültig.
400 KeyMaterialNotFoundOnRemoteServer – Remoteserver hat keinen Zugriff auf Schlüsselmaterial, das als TDE-Schutz verwendet wird.
400 LimitOfFailoverGroupsPerServerExceeded – Das Erstellen einer neuen Failovergruppe überschreitet die zulässige Anzahl von Failovergruppen pro Server.
400 SameKeyUriNotFoundOnRemoteServer – Der sekundäre Server verfügt nicht über das Schlüsselmaterial aus demselben Schlüsseltresor wie die Verschlüsselungsschutzvorrichtung des primären Servers mit aktivierter Automatischdrehung des Schlüssels.
400 AzureKeyVaultRsaKeyNotSupported – Der bereitgestellte Schlüsseltresor verwendet nicht unterstützte RSA Key Size oder Key Type. Die unterstützte RSA-Schlüsselgröße ist 2048 oder 3072, und der Schlüsseltyp ist RSA oder RSA-HSM.
400 SameKeyMaterialNotFoundOnRemoteServer – Sekundärer Server verfügt nicht über das Schlüsselmaterial der Verschlüsselungsschutzkomponente des primären Servers.
400 GeoReplicationDatabaseNotSecondary – Der Vorgang erwartet, dass die Datenbank ein Replikationsziel ist.
400 GeoReplicaLimitReached – Die Replikatreplikationsgrenze wurde erreicht.
400 FailoverGroupWithVirtualNetworkRulesNotSupported – Failovergruppen, die mit einer automatischen Failoverrichtlinie konfiguriert sind, werden derzeit auf Servern, die mit Firewallregeln für virtuelle Netzwerke konfiguriert sind, nicht unterstützt. Konfigurieren Sie die Failovergruppe mit manueller Failoverrichtlinie.
400 UnableToResolveRemoteServer – Der Name des Remotepartnerservers konnte aufgrund eines ungültigen Servernamens oder DNS-Verbindungsproblemen nicht behoben werden.
400 RemoteDatabaseCopyPermission – Der Benutzer verfügt nicht über ausreichende Berechtigungen zum Erstellen einer Datenbankkopie auf dem angegebenen Server.
400 SecurityAzureKeyVaultGeoChainError – Das Erstellen einer sekundären (als Verkettung bezeichneter Prozess) wird beim Aktivieren der transparenten Datenverschlüsselung mit Azure Key Vault (BYOK) nicht unterstützt.
404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.
404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.
404 ServerNotInSubscription – Der angegebene Server ist für das angegebene Abonnement nicht vorhanden.
404 SourceDatabaseNotFound – Die Quelldatenbank ist nicht vorhanden.
405 UnsupportedReplicationOperation – Ein nicht unterstützter Replikationsvorgang wurde in der Datenbank initiiert.
409 ConflictingServerOperation – Ein Vorgang wird derzeit für den Server ausgeführt.
409 SubscriptionDisabled – Abonnement ist deaktiviert.
409 ConflictingSystemOperationInProgress – Ein Systemwartungsvorgang wird für die Datenbank ausgeführt, und weitere Vorgänge müssen warten, bis sie abgeschlossen ist.
409 GeoReplicationCannotBecomePrimaryDuringUndo – Der Benutzer hat versucht, eine Geoverknüpfung zu failovern oder zu erzwingen, während sich die sekundäre Verbindung in einem Zustand befindet, in dem sie möglicherweise nicht physisch konsistent ist und daher nicht in die primäre Rolle eintreten kann.
409 ServerKeyNameAlreadyExists – Der Serverschlüssel ist bereits auf dem Server vorhanden.
409 ServerKeyUriAlreadyExists – Der Serverschlüssel-URI ist bereits auf dem Server vorhanden.
409 ServerKeyDoesNotExists – Der Serverschlüssel ist nicht vorhanden.
409 UpdateSloInProgress – Der Benutzer hat versucht, einen inkompatiblen Vorgang zu initiieren, während ein SLO-Update ausgeführt wurde.
409 AzureKeyVaultKeyNameNotFound – Der Vorgang konnte nicht abgeschlossen werden, da der Azure Key Vault Key-Name nicht vorhanden ist.
409 AzureKeyVaultKeyInUse – Der Schlüssel wird derzeit vom Server verwendet.
409 FailoverGroupAlreadyExists – Failovergruppe ist bereits auf einem bestimmten Server vorhanden. Verwenden Sie einen anderen Failovergruppennamen.
409 FailoverGroupBusy – Failovergruppe ist mit einem anderen Vorgang beschäftigt.
409 DatabaseBelongsToOtherFailoverGroup – Die Datenbank gehört zu einer anderen Failovergruppe und kann nicht als Teil dieser Gruppe betrachtet werden.
409 DatabaseBeingAddedToFailoverGroup – Die Datenbank wird derzeit der Failovergruppe hinzugefügt, der Kunde muss warten, bis dieser Vorgang beendet ist, um das Problem zu entfernen.
409 DatabaseBeingRemovedFromFailoverGroup – Die Datenbank wird zurzeit aus der Failovergruppe entfernt, der Kunde muss warten, bis dieser Vorgang abgeschlossen ist, um das Problem hinzuzufügen.
409 FailoverGroupDnsRecordInUse – Ein doppelter DNS-Eintrag ist für den angeforderten Endpunkt vorhanden.
409 InvalidFailoverGroupName – Ungültiger Failovergruppenname wurde angegeben.
409 InvalidOperationForDatabaseNotInReplicationRelationship – Ein Replikations-Seedingvorgang wurde für eine Datenbank ausgeführt, die sich bereits in einer Replikationsbeziehung befindet.
409 InvalidDatabaseStateForOperation – Der Vorgang ist für die Datenbank im aktuellen Replikationsstatus nicht zulässig.
409 DuplicateGeoDrRelation - Die Datenbanken befinden sich bereits in einer Replikationsbeziehung. Dies ist eine doppelte Anforderung.
409 RemoteDatabaseExists – Der Zieldatenbankname ist bereits auf dem Zielserver vorhanden.
429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.
429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.
503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.
503 AzureKeyVaultConnectionFailed – Der Vorgang konnte auf dem Server nicht abgeschlossen werden, da Versuche, eine Verbindung mit Azure Key Vault herzustellen, fehlgeschlagen sind.
503 AzureKeyVaultGenericConnectionError – Der Vorgang konnte nicht abgeschlossen werden, weil beim Versuch, Key Vault-Informationen abzurufen, ein Fehler aufgetreten ist.
503 DatabaseUnavailable – Fehler beim Vorgang, weil die Datenbank nicht verfügbar ist.
504 RequestTimeout – Serviceanforderung hat das zulässige Timeout überschritten.

Beispiele

List failover group

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


/**
 * Samples for FailoverGroups ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverGroupList.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().getFailoverGroups().listByServer("Default",
            "failover-group-primary-server", 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

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
FailoverGroup	Eine Failovergruppe.
FailoverGroupListResult	Eine Liste der Failovergruppen.
FailoverGroupReadOnlyEndpoint	Schreibgeschützter Endpunkt der Failovergruppeninstanz.
FailoverGroupReadWriteEndpoint	Lese-/Schreibzugriffsendpunkt der Failovergruppeninstanz.
FailoverGroupReplicationRole	Lokale Replikationsrolle der Failovergruppeninstanz.
PartnerInfo	Partnerserverinformationen für die Failovergruppe.
ReadOnlyEndpointFailoverPolicy	Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe.
ReadWriteEndpointFailoverPolicy	Failoverrichtlinie des Lese-/Schreibzugriffsendpunkts für die Failovergruppe. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich.

FailoverGroup

Objekt

Eine Failovergruppe.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
location	string	Ressourcenspeicherort.
name	string	Ressourcenname.
properties.databases	string[] (arm-id)	Liste der Datenbanken in der Failovergruppe.
properties.partnerServers	PartnerInfo[]	Liste der Partnerserverinformationen für die Failovergruppe.
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	Schreibgeschützter Endpunkt der Failovergruppeninstanz.
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	Lese-/Schreibzugriffsendpunkt der Failovergruppeninstanz.
properties.replicationRole	FailoverGroupReplicationRole	Lokale Replikationsrolle der Failovergruppeninstanz.
properties.replicationState	string	Replikationsstatus der Failovergruppeninstanz.
tags	object	Ressourcentags.
type	string	Ressourcentyp.

FailoverGroupListResult

Objekt

Eine Liste der Failovergruppen.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Seite mit Ergebnissen.
value	FailoverGroup[]	Array von Ergebnissen.

FailoverGroupReadOnlyEndpoint

Objekt

Schreibgeschützter Endpunkt der Failovergruppeninstanz.

Name	Typ	Beschreibung
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe.

FailoverGroupReadWriteEndpoint

Objekt

Lese-/Schreibzugriffsendpunkt der Failovergruppeninstanz.

Name	Typ	Beschreibung
failoverPolicy	ReadWriteEndpointFailoverPolicy	Failoverrichtlinie des Lese-/Schreibzugriffsendpunkts für die Failovergruppe. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich.
failoverWithDataLossGracePeriodMinutes	integer (int32)	Die Karenzzeit vor dem Failover mit Datenverlust wird für den Endpunkt mit Lese-/Schreibzugriff versucht. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich.

FailoverGroupReplicationRole

Enumeration

Lokale Replikationsrolle der Failovergruppeninstanz.

Wert	Beschreibung
Primary
Secondary

PartnerInfo

Objekt

Partnerserverinformationen für die Failovergruppe.

Name	Typ	Beschreibung
id	string (arm-id)	Ressourcenbezeichner des Partnerservers.
location	string	Geografischer Standort des Partnerservers.
replicationRole	FailoverGroupReplicationRole	Replikationsrolle des Partnerservers.

ReadOnlyEndpointFailoverPolicy

Enumeration

Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe.

Wert	Beschreibung
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

Enumeration

Failoverrichtlinie des Lese-/Schreibzugriffsendpunkts für die Failovergruppe. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich.

Wert	Beschreibung
Automatic
Manual

Freigeben über

Failover Groups - List By Server

URI-Parameter

Antworten

Beispiele

List failover group

Beispielanforderung

Beispiel für eine Antwort

Definitionen

FailoverGroup

FailoverGroupListResult

FailoverGroupReadOnlyEndpoint

FailoverGroupReadWriteEndpoint

FailoverGroupReplicationRole

PartnerInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

Zusätzliche Ressourcen