Failover Groups - Update

Tjänst:: SQL Database

API-version:: 2023-08-01

Uppdaterar en redundansgrupp.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2023-08-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
failoverGroupName	path	True	string	Namnet på redundansgruppen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern som innehåller redundansgruppen.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
properties.databases	string[] (arm-id)	Lista över databaser i redundansgruppen.
properties.partnerServers	PartnerInfo[]	Lista över partnerserverinformation för redundansgruppen.
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
properties.secondaryType	FailoverGroupDatabasesSecondaryType	Databasers sekundära typ på partnerservern.
tags	object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	FailoverGroup	Redundansgruppen har uppdaterats.
202 Accepted		Accepterad Sidhuvuden Location: string
Other Status Codes	ErrorResponse	Felsvar: *** 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – de angivna databas-ID:erna är inte korrekt konstruerade databasresurs-ID:er. Exempel på korrekt formatering finns i https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidPartner – det angivna partnerfältet i begärandetexten för skapa eller uppdatera redundansgrupper är tomt eller ogiltigt. Ange ett giltigt värde för det här fältet. Exempel på korrekt formaterade begäranden finns i https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – en eller flera av de angivna partnerservrarna ingår redan i redundansgruppen. Kontrollera att den primära servern och alla givna partnerservrar är unika. 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – En eller flera av de angivna databaserna finns inte på den primära servern i redundansgruppen. Kontrollera att alla databaser finns på den primära servern. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – Endast en partnerserver för redundansgrupp stöds. Ändra din begäran i enlighet med detta. Exempel på giltiga begäranden finns i https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – fältet readWriteEndpoint krävs för att skapa eller uppdatera begäranden. 400 FailoverGroupCreateOrUpdateRequestInvalid – Begärandetexten för att skapa eller uppdatera redundansgrupper är tom eller ogiltig. 400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Ändringar i redundansgruppen tillåts inte på en sekundär server. Kör begäran på den primära servern. 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Respitperiodvärdet för läs- och skrivslutpunkten måste vara icke-negativt. 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – Respitperiodvärdet för redundansgruppen måste vara större än eller lika med minsta respitperiod för{0}minuter 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Egenskapen failoverWithDataLossGracePeriodMinutes måste anges när redundansprincipen Automatisk har valts för skrivskyddad slutpunkt. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – fältet failoverPolicy för läs-och-skrivslutpunkten krävs för att skapa eller uppdatera begäranden. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – Respitperiodvärde ska inte anges när policyhandboken för redundansväxling har valts för läs-och-skrivslutpunkten. Ta bort den från begäran. 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Begärandetexten skapa eller uppdatera redundansgrupper bör inte ändra den skrivskyddade egenskapen "{0}". 400 FailoverGroupFailoverRequestOnPrimary – Redundansbegäran bör initieras på den sekundära servern för redundansgruppen. 400 FailoverGroupPartnerServerFromDifferentSubscription – Primär server och partnerservrarna i redundansgruppen kommer från olika prenumerationer. Korsprenumeration för servrar i redundansgrupper tillåts inte. 400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer – egenskapen targetServer för den skrivskyddade slutpunkten måste vara en giltig server som finns bland partnerServrarna som konfigurerats för redundansgruppen. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby – Endast en partnerserver för redundanskluster stöds för secondaryType-vänteläge. Ändra din begäran i enlighet med detta. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 TokenTooLong – den angivna token är för lång. 400 InvalidAddSecondaryPermission – Användaren har inte tillräcklig behörighet för att lägga till sekundär på den angivna servern. 400 InvalidSku – Användaren angav en ogiltig sku. 400 ServerNotFound – Den begärda servern hittades inte. 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan. 400 TokenTooLong – den angivna token är för lång. 400 InvalidTargetSubregion – målservern för en icke läsbar sekundär är inte i en DR-länkad Azure-region. 400 PartnerServerNotCompatible – Användaren försöker kopiera en databas från en SAWA V1-server till en Sterling-server eller vice versa. 400 IncorrectReplicationLinkState – Åtgärden förväntar sig att databasen är i ett förväntat tillstånd på replikeringslänken. 400 ResourcePoolNotFound – Den angivna elastiska poolen finns inte på den angivna logiska servern. 400 AzureKeyVaultKeyDisabled – Det gick inte att slutföra åtgärden på servern eftersom Azure Key Vault-nyckeln är inaktiverad. 400 AzureKeyVaultInvalidExpirationDate – Det gick inte att slutföra åtgärden eftersom förfallodatumet för Azure Key Vault-nyckeln är ogiltigt. 400 SecurityAzureKeyVaultUrlNullOrEmpty – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-URI:n är null eller tom. 400 AzureKeyVaultNoServerIdentity – serveridentiteten är inte korrekt konfigurerad. 400 AzureKeyVaultInvalidUri – ett ogiltigt svar från Azure Key Vault. Använd en giltig Azure Key Vault-URI. 400 AzureKeyVaultMissingPermissions – Servern saknar nödvändiga behörigheter i Azure Key Vault. 400 SecurityAzureKeyVaultInvalidKeyName – Åtgärden kunde inte slutföras på grund av ett ogiltigt servernyckelnamn. 400 PlannedFailoverTimedOutForDatabase – Användaren anropade planerad redundans, tidsgränsen uppnåddes och en specifik databas verkar vara skyldig. 400 PlannedFailoverTimedOut – Användaren anropade planerad redundans och tidsgränsen uppnåddes när partnerhanteringstjänsten skulle kontaktas. 400 AdalGenericError – Det gick inte att slutföra åtgärden eftersom ett Azure Active Directory-fel påträffades. 400 AdalServicePrincipalNotFound – Det gick inte att slutföra åtgärden eftersom ett azure Active Directory-bibliotekstjänsthuvudnamn inte hittades. 400 AzureKeyVaultMalformedVaultUri – Den angivna Key Vault-URI:n är inte giltig. 400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden. 400 InvalidFailoverGroupRegion – servrar som anges i en redundansgrupp måste finnas i olika regioner för att tillhandahålla isolering. 400 FailoverGroupDoesNotExist – redundansgruppen finns inte på en server. 400 FailoverGroupNotSecondary – Redundans kan inte initieras från den primära servern i en redundansgrupp. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 DatabaseInFailoverGroupNotPrimary – GeoDR-länk för databasen finns redan, men dess roll är inte "Primär" eller så är den inte kontinuerlig kopieringslänk. 400 SecurityAdalPrincipalCertExpiredError – Åtgärden kunde inte slutföras eftersom Azure Key Vault-huvudcertifikatet har upphört att gälla. 400 UnableToCreateFailoverGroupDueToTableAuditing – Redundansgrupp kan inte skapas för server som har tabellgranskning aktiverat. 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 UnableToAddDbWithTableAuditingToFailoverGroup – Databasen med tabellgranskning aktiverad kommer inte att vara tillgänglig via slutpunkten för redundansgruppen. 400 SecurityInvalidAzureKeyVaultRecoveryLevel – Den angivna Key Vault-URI:n är inte giltig. 400 KeyMaterialNotFoundOnRemoteServer – Fjärrservern har inte åtkomst till nyckelmaterial som används som TDE-skydd. 400 LimitOfFailoverGroupsPerServerExceeded – Om du skapar en ny redundansgrupp överskrids det tillåtna antalet redundansgrupper per server. 400 SameKeyUriNotFoundOnRemoteServer – Sekundär server har inte nyckelmaterialet från samma nyckelvalv som den primära serverns krypteringsskydd med automatisk rotation aktiverad. 400 AzureKeyVaultRsaKeyNotSupported – Det angivna nyckelvalvet använder RSA-nyckelstorlek eller nyckeltyp som inte stöds. RSA-nyckelstorleken som stöds är 2048 eller 3072 och nyckeltypen är RSA eller RSA-HSM. 400 SameKeyMaterialNotFoundOnRemoteServer – sekundär server har inte nyckelmaterialet för den primära serverns krypteringsskydd. 400 GeoReplicationDatabaseNotSecondary – Åtgärden förväntar sig att databasen är ett replikeringsmål. 400 GeoReplicaLimitReached – replikeringsgränsen per replik uppnåddes. 400 FailoverGroupWithVirtualNetworkRulesNotSupported – Redundansgrupper som konfigurerats med en automatisk redundansprincip stöds för närvarande inte på servrar som konfigurerats med brandväggsregler för virtuella nätverk. Konfigurera redundansgruppen med en manuell redundansprincip. 400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller DNS-anslutningsproblem. 400 RemoteDatabaseCopyPermission – Användaren har inte tillräcklig behörighet för att skapa en databaskopia på den angivna servern. 400 SecurityAzureKeyVaultGeoChainError – Det går inte att skapa sekundär sekundär (en process som kallas länkning) när transparent datakryptering aktiveras med hjälp av Azure Key Vault (BYOK). 400 FailoverGroupCreateOrUpdatePartiallySucceeded – Vissa databaser kunde inte läggas till eller tas bort. 404 OperationIdNotFound – Åtgärden med ID finns inte. 404 ResourceNotFound – Den begärda resursen hittades inte. 404 OperationIdNotFound – Åtgärden med ID finns inte. 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 404 SourceDatabaseNotFound – källdatabasen finns inte. 405 UnsupportedReplicationOperation – En replikeringsåtgärd som inte stöds initierades i databasen. 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 409 ConflictingServerOperation – En åtgärd pågår för närvarande för servern. 409 SubscriptionDisabled – Prenumerationen är inaktiverad. 409 ConflictingSystemOperationInProgress – En systemunderhållsåtgärd pågår i databasen och ytterligare åtgärder måste vänta tills den har slutförts. 409 GeoReplicationCannotBecomePrimaryDuringUndo – Användaren försökte redundanshantera eller tvinga fram en geo-länk medan den sekundära är i ett tillstånd där den kanske inte är fysiskt konsekvent och därför inte kan ange den primära rollen. 409 ServerKeyNameAlreadyExists – servernyckeln finns redan på servern. 409 ServerKeyUriAlreadyExists – Servernyckelns URI finns redan på servern. 409 ServerKeyDoesNotExists – servernyckeln finns inte. 409 UpdateSloInProgress – Användaren försökte initiera en inkompatibel åtgärd medan en SLO-uppdatering pågick. 409 AzureKeyVaultKeyNameNotFound – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-nyckelnamnet inte finns. 409 AzureKeyVaultKeyInUse – Nyckeln används för närvarande av servern. 409 FailoverGroupAlreadyExists – Redundansgruppen finns redan på en viss server. Använd ett annat namn på redundansklustergruppen. 409 FailoverGroupBusy – redundansgruppen är upptagen med en annan åtgärd. 409 DatabaseBelongsToOtherFailoverGroup – databasen tillhör en annan redundansgrupp och kan inte betraktas som en del av den här. 409 DatabaseBeingAddedToFailoverGroup – Databasen läggs för närvarande till i redundansgruppen, kunden måste vänta tills åtgärden har slutförts för att problemet ska tas bort. 409 DatabaseBeingRemovedFromFailoverGroup – Databasen tas för närvarande bort från redundansgruppen, kunden måste vänta tills åtgärden har slutförts för att lägga till problemet. 409 FailoverGroupDnsRecordInUse – Det finns en duplicerad DNS-post för den begärda slutpunkten. 409 InvalidFailoverGroupName – Ogiltigt redundansgruppnamn angavs. 409 InvalidOperationForDatabaseNotInReplicationRelationship – En replikeringsåtgärd utfördes på en databas som inte finns i en replikeringsrelation. 409 InvalidDatabaseStateForOperation – Åtgärden tillåts inte för databasen i dess aktuella replikeringstillstånd. 409 DuplicateGeoDrRelation – databaserna är redan i en replikeringsrelation. Det här är en duplicerad begäran. 409 RemoteDatabaseExists – måldatabasnamnet finns redan på målservern. 409 FailoverGroupUnableToPerformGroupOperationOnDatabases – listan över databaser som ska läggas till/ta bort till/från redundansgruppen innehåller fel som förhindrar att åtgärden slutförs. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 AzureKeyVaultConnectionFailed – Det gick inte att slutföra åtgärden på servern eftersom det inte gick att ansluta till Azure Key Vault 503 AzureKeyVaultGenericConnectionError – Det gick inte att slutföra åtgärden eftersom ett fel uppstod vid försök att hämta Key Vault-information . 503 DatabaseUnavailable – Åtgärden misslyckades eftersom databasen inte är tillgänglig. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Name

Typ

Description

200 OK

FailoverGroup

Redundansgruppen har uppdaterats.

202 Accepted

Accepterad

Sidhuvuden

Location: string

Other Status Codes

ErrorResponse

Felsvar: ***

400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – de angivna databas-ID:erna är inte korrekt konstruerade databasresurs-ID:er. Exempel på korrekt formatering finns i https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestInvalidPartner – det angivna partnerfältet i begärandetexten för skapa eller uppdatera redundansgrupper är tomt eller ogiltigt. Ange ett giltigt värde för det här fältet. Exempel på korrekt formaterade begäranden finns i https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – en eller flera av de angivna partnerservrarna ingår redan i redundansgruppen. Kontrollera att den primära servern och alla givna partnerservrar är unika.
400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – En eller flera av de angivna databaserna finns inte på den primära servern i redundansgruppen. Kontrollera att alla databaser finns på den primära servern.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – Endast en partnerserver för redundansgrupp stöds. Ändra din begäran i enlighet med detta. Exempel på giltiga begäranden finns i https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – fältet readWriteEndpoint krävs för att skapa eller uppdatera begäranden.
400 FailoverGroupCreateOrUpdateRequestInvalid – Begärandetexten för att skapa eller uppdatera redundansgrupper är tom eller ogiltig.
400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Ändringar i redundansgruppen tillåts inte på en sekundär server. Kör begäran på den primära servern.
400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Respitperiodvärdet för läs- och skrivslutpunkten måste vara icke-negativt.
400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – Respitperiodvärdet för redundansgruppen måste vara större än eller lika med minsta respitperiod för{0}minuter
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Egenskapen failoverWithDataLossGracePeriodMinutes måste anges när redundansprincipen Automatisk har valts för skrivskyddad slutpunkt.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – fältet failoverPolicy för läs-och-skrivslutpunkten krävs för att skapa eller uppdatera begäranden.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – Respitperiodvärde ska inte anges när policyhandboken för redundansväxling har valts för läs-och-skrivslutpunkten. Ta bort den från begäran.
400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Begärandetexten skapa eller uppdatera redundansgrupper bör inte ändra den skrivskyddade egenskapen "{0}".
400 FailoverGroupFailoverRequestOnPrimary – Redundansbegäran bör initieras på den sekundära servern för redundansgruppen.
400 FailoverGroupPartnerServerFromDifferentSubscription – Primär server och partnerservrarna i redundansgruppen kommer från olika prenumerationer. Korsprenumeration för servrar i redundansgrupper tillåts inte.
400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer – egenskapen targetServer för den skrivskyddade slutpunkten måste vara en giltig server som finns bland partnerServrarna som konfigurerats för redundansgruppen.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby – Endast en partnerserver för redundanskluster stöds för secondaryType-vänteläge. Ändra din begäran i enlighet med detta.
400 InvalidServerName – Ogiltigt servernamn har angetts.
400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.
400 TokenTooLong – den angivna token är för lång.
400 InvalidAddSecondaryPermission – Användaren har inte tillräcklig behörighet för att lägga till sekundär på den angivna servern.
400 InvalidSku – Användaren angav en ogiltig sku.
400 ServerNotFound – Den begärda servern hittades inte.
400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan.
400 TokenTooLong – den angivna token är för lång.
400 InvalidTargetSubregion – målservern för en icke läsbar sekundär är inte i en DR-länkad Azure-region.
400 PartnerServerNotCompatible – Användaren försöker kopiera en databas från en SAWA V1-server till en Sterling-server eller vice versa.
400 IncorrectReplicationLinkState – Åtgärden förväntar sig att databasen är i ett förväntat tillstånd på replikeringslänken.
400 ResourcePoolNotFound – Den angivna elastiska poolen finns inte på den angivna logiska servern.
400 AzureKeyVaultKeyDisabled – Det gick inte att slutföra åtgärden på servern eftersom Azure Key Vault-nyckeln är inaktiverad.
400 AzureKeyVaultInvalidExpirationDate – Det gick inte att slutföra åtgärden eftersom förfallodatumet för Azure Key Vault-nyckeln är ogiltigt.
400 SecurityAzureKeyVaultUrlNullOrEmpty – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-URI:n är null eller tom.
400 AzureKeyVaultNoServerIdentity – serveridentiteten är inte korrekt konfigurerad.
400 AzureKeyVaultInvalidUri – ett ogiltigt svar från Azure Key Vault. Använd en giltig Azure Key Vault-URI.
400 AzureKeyVaultMissingPermissions – Servern saknar nödvändiga behörigheter i Azure Key Vault.
400 SecurityAzureKeyVaultInvalidKeyName – Åtgärden kunde inte slutföras på grund av ett ogiltigt servernyckelnamn.
400 PlannedFailoverTimedOutForDatabase – Användaren anropade planerad redundans, tidsgränsen uppnåddes och en specifik databas verkar vara skyldig.
400 PlannedFailoverTimedOut – Användaren anropade planerad redundans och tidsgränsen uppnåddes när partnerhanteringstjänsten skulle kontaktas.
400 AdalGenericError – Det gick inte att slutföra åtgärden eftersom ett Azure Active Directory-fel påträffades.
400 AdalServicePrincipalNotFound – Det gick inte att slutföra åtgärden eftersom ett azure Active Directory-bibliotekstjänsthuvudnamn inte hittades.
400 AzureKeyVaultMalformedVaultUri – Den angivna Key Vault-URI:n är inte giltig.
400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden.
400 InvalidFailoverGroupRegion – servrar som anges i en redundansgrupp måste finnas i olika regioner för att tillhandahålla isolering.
400 FailoverGroupDoesNotExist – redundansgruppen finns inte på en server.
400 FailoverGroupNotSecondary – Redundans kan inte initieras från den primära servern i en redundansgrupp.
400 InvalidServerName – Ogiltigt servernamn har angetts.
400 DatabaseInFailoverGroupNotPrimary – GeoDR-länk för databasen finns redan, men dess roll är inte "Primär" eller så är den inte kontinuerlig kopieringslänk.
400 SecurityAdalPrincipalCertExpiredError – Åtgärden kunde inte slutföras eftersom Azure Key Vault-huvudcertifikatet har upphört att gälla.
400 UnableToCreateFailoverGroupDueToTableAuditing – Redundansgrupp kan inte skapas för server som har tabellgranskning aktiverat.
400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.
400 UnableToAddDbWithTableAuditingToFailoverGroup – Databasen med tabellgranskning aktiverad kommer inte att vara tillgänglig via slutpunkten för redundansgruppen.
400 SecurityInvalidAzureKeyVaultRecoveryLevel – Den angivna Key Vault-URI:n är inte giltig.
400 KeyMaterialNotFoundOnRemoteServer – Fjärrservern har inte åtkomst till nyckelmaterial som används som TDE-skydd.
400 LimitOfFailoverGroupsPerServerExceeded – Om du skapar en ny redundansgrupp överskrids det tillåtna antalet redundansgrupper per server.
400 SameKeyUriNotFoundOnRemoteServer – Sekundär server har inte nyckelmaterialet från samma nyckelvalv som den primära serverns krypteringsskydd med automatisk rotation aktiverad.
400 AzureKeyVaultRsaKeyNotSupported – Det angivna nyckelvalvet använder RSA-nyckelstorlek eller nyckeltyp som inte stöds. RSA-nyckelstorleken som stöds är 2048 eller 3072 och nyckeltypen är RSA eller RSA-HSM.
400 SameKeyMaterialNotFoundOnRemoteServer – sekundär server har inte nyckelmaterialet för den primära serverns krypteringsskydd.
400 GeoReplicationDatabaseNotSecondary – Åtgärden förväntar sig att databasen är ett replikeringsmål.
400 GeoReplicaLimitReached – replikeringsgränsen per replik uppnåddes.
400 FailoverGroupWithVirtualNetworkRulesNotSupported – Redundansgrupper som konfigurerats med en automatisk redundansprincip stöds för närvarande inte på servrar som konfigurerats med brandväggsregler för virtuella nätverk. Konfigurera redundansgruppen med en manuell redundansprincip.
400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller DNS-anslutningsproblem.
400 RemoteDatabaseCopyPermission – Användaren har inte tillräcklig behörighet för att skapa en databaskopia på den angivna servern.
400 SecurityAzureKeyVaultGeoChainError – Det går inte att skapa sekundär sekundär (en process som kallas länkning) när transparent datakryptering aktiveras med hjälp av Azure Key Vault (BYOK).
400 FailoverGroupCreateOrUpdatePartiallySucceeded – Vissa databaser kunde inte läggas till eller tas bort.
404 OperationIdNotFound – Åtgärden med ID finns inte.
404 ResourceNotFound – Den begärda resursen hittades inte.
404 OperationIdNotFound – Åtgärden med ID finns inte.
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.
404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen.
404 SourceDatabaseNotFound – källdatabasen finns inte.
405 UnsupportedReplicationOperation – En replikeringsåtgärd som inte stöds initierades i databasen.
409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.
409 OperationCancelled – Åtgärden har avbrutits av användaren.
409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.
409 ConflictingServerOperation – En åtgärd pågår för närvarande för servern.
409 SubscriptionDisabled – Prenumerationen är inaktiverad.
409 ConflictingSystemOperationInProgress – En systemunderhållsåtgärd pågår i databasen och ytterligare åtgärder måste vänta tills den har slutförts.
409 GeoReplicationCannotBecomePrimaryDuringUndo – Användaren försökte redundanshantera eller tvinga fram en geo-länk medan den sekundära är i ett tillstånd där den kanske inte är fysiskt konsekvent och därför inte kan ange den primära rollen.
409 ServerKeyNameAlreadyExists – servernyckeln finns redan på servern.
409 ServerKeyUriAlreadyExists – Servernyckelns URI finns redan på servern.
409 ServerKeyDoesNotExists – servernyckeln finns inte.
409 UpdateSloInProgress – Användaren försökte initiera en inkompatibel åtgärd medan en SLO-uppdatering pågick.
409 AzureKeyVaultKeyNameNotFound – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-nyckelnamnet inte finns.
409 AzureKeyVaultKeyInUse – Nyckeln används för närvarande av servern.
409 FailoverGroupAlreadyExists – Redundansgruppen finns redan på en viss server. Använd ett annat namn på redundansklustergruppen.
409 FailoverGroupBusy – redundansgruppen är upptagen med en annan åtgärd.
409 DatabaseBelongsToOtherFailoverGroup – databasen tillhör en annan redundansgrupp och kan inte betraktas som en del av den här.
409 DatabaseBeingAddedToFailoverGroup – Databasen läggs för närvarande till i redundansgruppen, kunden måste vänta tills åtgärden har slutförts för att problemet ska tas bort.
409 DatabaseBeingRemovedFromFailoverGroup – Databasen tas för närvarande bort från redundansgruppen, kunden måste vänta tills åtgärden har slutförts för att lägga till problemet.
409 FailoverGroupDnsRecordInUse – Det finns en duplicerad DNS-post för den begärda slutpunkten.
409 InvalidFailoverGroupName – Ogiltigt redundansgruppnamn angavs.
409 InvalidOperationForDatabaseNotInReplicationRelationship – En replikeringsåtgärd utfördes på en databas som inte finns i en replikeringsrelation.
409 InvalidDatabaseStateForOperation – Åtgärden tillåts inte för databasen i dess aktuella replikeringstillstånd.
409 DuplicateGeoDrRelation – databaserna är redan i en replikeringsrelation. Det här är en duplicerad begäran.
409 RemoteDatabaseExists – måldatabasnamnet finns redan på målservern.
409 FailoverGroupUnableToPerformGroupOperationOnDatabases – listan över databaser som ska läggas till/ta bort till/från redundansgruppen innehåller fel som förhindrar att åtgärden slutförs.
429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.
429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.
500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen.
503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
503 AzureKeyVaultConnectionFailed – Det gick inte att slutföra åtgärden på servern eftersom det inte gick att ansluta till Azure Key Vault
503 AzureKeyVaultGenericConnectionError – Det gick inte att slutföra åtgärden eftersom ett fel uppstod vid försök att hämta Key Vault-information .
503 DatabaseUnavailable – Åtgärden misslyckades eftersom databasen inte är tillgänglig.
504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Add database to failover group with standby secondary on partner server.

Update failover group

Add database to failover group with standby secondary on partner server.

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-1?api-version=2023-08-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1"
    ],
    "secondaryType": "Standby"
  }
}

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

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/FailoverGroupUpdateStandbySecondary.json
// this example is just showing the usage of "FailoverGroups_Update" 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 FailoverGroupResource created on azure
// for more information of creating FailoverGroupResource, please refer to the document of FailoverGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
string serverName = "failover-group-primary-server";
string failoverGroupName = "failover-group-test-1";
ResourceIdentifier failoverGroupResourceId = FailoverGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, failoverGroupName);
FailoverGroupResource failoverGroup = client.GetFailoverGroupResource(failoverGroupResourceId);

// invoke the operation
FailoverGroupPatch patch = new FailoverGroupPatch
{
    ReadWriteEndpoint = new FailoverGroupReadWriteEndpoint(ReadWriteEndpointFailoverPolicy.Automatic)
    {
        FailoverWithDataLossGracePeriodMinutes = 120,
    },
    FailoverDatabases = { new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1") },
    SecondaryType = FailoverGroupDatabasesSecondaryType.Standby,
};
ArmOperation<FailoverGroupResource> lro = await failoverGroup.UpdateAsync(WaitUntil.Completed, patch);
FailoverGroupResource result = lro.Value;

// the variable result 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
FailoverGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Exempelsvar

Statuskod:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
    },
    "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": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1"
    ]
  }
}

Statuskod:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111

Update failover group

Exempelbegäran

HTTP
dotnet

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-1?api-version=2023-08-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1"
    ]
  }
}

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

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/FailoverGroupUpdate.json
// this example is just showing the usage of "FailoverGroups_Update" 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 FailoverGroupResource created on azure
// for more information of creating FailoverGroupResource, please refer to the document of FailoverGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
string serverName = "failover-group-primary-server";
string failoverGroupName = "failover-group-test-1";
ResourceIdentifier failoverGroupResourceId = FailoverGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, failoverGroupName);
FailoverGroupResource failoverGroup = client.GetFailoverGroupResource(failoverGroupResourceId);

// invoke the operation
FailoverGroupPatch patch = new FailoverGroupPatch
{
    ReadWriteEndpoint = new FailoverGroupReadWriteEndpoint(ReadWriteEndpointFailoverPolicy.Automatic)
    {
        FailoverWithDataLossGracePeriodMinutes = 120,
    },
    FailoverDatabases = { new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1") },
};
ArmOperation<FailoverGroupResource> lro = await failoverGroup.UpdateAsync(WaitUntil.Completed, patch);
FailoverGroupResource result = lro.Value;

// the variable result 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
FailoverGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Exempelsvar

Statuskod:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
    },
    "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": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1"
    ]
  }
}

Statuskod:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
FailoverGroup	En redundansgrupp.
FailoverGroupDatabasesSecondaryType	Databasers sekundära typ på partnerservern.
FailoverGroupReadOnlyEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
FailoverGroupReadWriteEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
FailoverGroupReplicationRole	Den lokala replikeringsrollen för redundansklusterinstansen.
FailoverGroupUpdate	En begäran om uppdatering av redundansgrupper.
PartnerInfo	Partnerserverinformation för redundansgruppen.
ReadOnlyEndpointFailoverPolicy	Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.
ReadWriteEndpointFailoverPolicy	Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

FailoverGroup

Objekt

En redundansgrupp.

Name	Typ	Description
id	string	Resurs-ID.
location	string	Resursplats.
name	string	Resursnamn.
properties.databases	string[] (arm-id)	Lista över databaser i redundansgruppen.
properties.partnerServers	PartnerInfo[]	Lista över partnerserverinformation för redundansgruppen.
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
properties.replicationRole	FailoverGroupReplicationRole	Den lokala replikeringsrollen för redundansklusterinstansen.
properties.replicationState	string	Replikeringstillstånd för redundansklusterinstansen.
properties.secondaryType	FailoverGroupDatabasesSecondaryType	Databasers sekundära typ på partnerservern.
tags	object	Resurstaggar.
type	string	Resurstyp.

FailoverGroupDatabasesSecondaryType

Uppräkning

Databasers sekundära typ på partnerservern.

Värde	Description
Geo
Standby

FailoverGroupReadOnlyEndpoint

Objekt

Skrivskyddad slutpunkt för redundansklusterinstansen.

Name	Typ	Description
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.
targetServer	string (arm-id)	Målpartnerservern där den skrivskyddade slutpunkten pekar på.

FailoverGroupReadWriteEndpoint

Objekt

Skrivskyddad slutpunkt för redundansklusterinstansen.

Name	Typ	Description
failoverPolicy	ReadWriteEndpointFailoverPolicy	Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.
failoverWithDataLossGracePeriodMinutes	integer (int32)	Respitperiod före redundansväxling med dataförlust görs för läs- och skrivslutpunkten. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.

FailoverGroupReplicationRole

Uppräkning

Den lokala replikeringsrollen för redundansklusterinstansen.

Värde	Description
Primary
Secondary

FailoverGroupUpdate

Objekt

En begäran om uppdatering av redundansgrupper.

Name	Typ	Description
properties.databases	string[] (arm-id)	Lista över databaser i redundansgruppen.
properties.partnerServers	PartnerInfo[]	Lista över partnerserverinformation för redundansgruppen.
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	Skrivskyddad slutpunkt för redundansklusterinstansen.
properties.secondaryType	FailoverGroupDatabasesSecondaryType	Databasers sekundära typ på partnerservern.
tags	object	Resurstaggar.

PartnerInfo

Objekt

Partnerserverinformation för redundansgruppen.

Name	Typ	Description
id	string (arm-id)	Resursidentifierare för partnerservern.
location	string	Geoplats för partnerservern.
replicationRole	FailoverGroupReplicationRole	Replikeringsrollen för partnerservern.

ReadOnlyEndpointFailoverPolicy

Uppräkning

Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.

Värde	Description
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

Uppräkning

Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.

Värde	Description
Manual
Automatic

Dela via

Failover Groups - Update

URI-parametrar

Begärandetext

Svar

Exempel

Add database to failover group with standby secondary on partner server.

Exempelbegäran

Exempelsvar

Update failover group

Exempelbegäran

Exempelsvar

Definitioner

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FailoverGroup

FailoverGroupDatabasesSecondaryType

FailoverGroupReadOnlyEndpoint

FailoverGroupReadWriteEndpoint

FailoverGroupReplicationRole

FailoverGroupUpdate

PartnerInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy