Failover Groups - Create Or Update

Skapar eller uppdaterar en redundansgrupp.

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

URI-parametrar

Name In Required Type 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

Prenumerations-ID:t som identifierar en Azure-prenumeration.

api-version
query True
  • string

DEN API-version som ska användas för begäran.

Begärandetext

Name Required Type Description
properties.partnerServers True

Lista över partnerserverinformation för redundansgruppen.

properties.readWriteEndpoint True

Skrivskyddad slutpunkt för redundansklusterinstansen.

properties.databases
  • string[]

Lista över databaser i redundansgruppen.

properties.readOnlyEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

tags
  • object

Resurstaggar.

Svar

Name Type Description
200 OK

Redundansgruppen har uppdaterats.

201 Created

Redundansgruppen har skapats.

202 Accepted

Har godkänts

Other Status Codes

Felsvar: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – De angivna databas-ID:na ä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 angivna 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 redundansklustergruppen ä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 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Egenskapen failoverWithDataLossGracePeriodMinutes måste anges när redundansprincip automatisk väljs för läs-skriv-slutpunkten.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – fältet failoverPolicy för skrivskyddad slutpunkt krävs för att skapa eller uppdatera begäranden.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – Respitperiodvärdet ska inte anges när policyn Manuell för redundans har valts för läs- och skrivslutpunkten. Ta bort den från begäran.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Begärandetexten för att skapa eller uppdatera redundansgrupper bör inte ändra den skrivskyddade egenskapen '{0}'.

  • 400 FailoverGroupFailoverRequestOnPrimary – redundansbegäran bör initieras på den sekundära servern i 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 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 tvärtom.

  • 400 IncorrectReplicationLinkState – Åtgärden förväntar sig att databasen är i ett förväntat tillstånd på replikeringslänken.

  • 400 ResourcePoolNotFound – Angiven elastisk pool 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 – Åtgärden kunde inte slutföras eftersom Azure Key Vault nyckelns förfallodatum är ogiltigt.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – Åtgärden kunde inte slutföras eftersom Azure Key Vault Uri ä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 URI för Azure Key Vault.

  • 400 AzureKeyVaultMissingPermissions – Servern saknar nödvändiga behörigheter för 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änstens huvudnamn inte hittades.

  • 400 AzureKeyVaultMalformedVaultUri – den angivna Key Vault uri är inte giltig.

  • 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade 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 huvudcertifikat har upphört att gälla.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing – Redundansgrupp kan inte skapas för servern som har tabellgranskning aktiverad.

  • 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 är inte giltig.

  • 400 KeyMaterialNotFoundOnRemoteServer – Fjärrservern har inte åtkomst till nyckelmaterial som används som TDE-skydd.

  • 400 LimitOfFailoverGroupsPerServerExceededed – Om du skapar en ny redundansgrupp överskrids det tillåtna antalet redundansgrupper per server.

  • 400 AzureKeyVaultMismatchError – Oväntad Key Vault region som finns i http-svaret.

  • 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 GeoReplicationDatabaseNotSecondary – Åtgärden förväntar sig att databasen är ett replikeringsmål.

  • 400 GeoReplicaLimitReached – replikeringsgränsen per replikering nåddes.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported – Redundansgrupper som konfigurerats med en princip för automatisk redundans 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 – Fjärrpartnerservernamnet kunde inte lösas 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 du aktiverar transparent datakryptering med hjälp av Azure Key Vault (BYOK).

  • 400 FailoverGroupCreateOrUpdatePartiallySucceededed – 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 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 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 redundansväxlara 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 – Åtgärden kunde inte slutföras eftersom Azure Key Vault Nyckelnamn 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 – redundansklustergruppen ä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 namn på redundansgrupp angavs.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – En replikerings seeding-åtgärd utfördes på en databas som redan finns i en replikeringsrelation.

  • 409 InvalidDatabaseStateForOperation – Åtgärden tillåts inte i 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/tas 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 maximalt antal begä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 att utföra åtgärden igen.

  • 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 försök att ansluta till Azure Key Vault misslyckades

  • 503 AzureKeyVaultGenericConnectionError – Det gick inte att slutföra åtgärden eftersom ett fel påträffades när Key Vault information skulle hämtas.

  • 503 DatabaseUnavailable – Åtgärden misslyckades eftersom databasen inte är tillgänglig.

  • 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Create failover group

Sample Request

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

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

Sample Response

{
  "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": 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": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}
{
  "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": 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": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

Definitioner

FailoverGroup

En redundansgrupp.

FailoverGroupReadOnlyEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

FailoverGroupReadWriteEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

FailoverGroupReplicationRole

Den lokala replikeringsrollen för redundansklustergruppens instans.

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.

FailoverGroup

En redundansgrupp.

Name Type Description
id
  • string

Resurs-ID.

location
  • string

Resursplats.

name
  • string

Resursnamn.

properties.databases
  • string[]

Lista över databaser i redundansgruppen.

properties.partnerServers

Lista över partnerserverinformation för redundansgruppen.

properties.readOnlyEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

properties.readWriteEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

properties.replicationRole

Den lokala replikeringsrollen för redundansklustergruppens instans.

properties.replicationState
  • string

Replikeringstillstånd för redundansklustergruppens instans.

tags
  • object

Resurstaggar.

type
  • string

Resurstyp.

FailoverGroupReadOnlyEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

Name Type Description
failoverPolicy

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

FailoverGroupReadWriteEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

Name Type Description
failoverPolicy

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

failoverWithDataLossGracePeriodMinutes
  • integer

Respitperiod före redundansväxling med dataförlust görs för läs- och skrivslutpunkten. Om failoverPolicy är automatisk krävs failoverWithDataLossGracePeriodMinutes.

FailoverGroupReplicationRole

Den lokala replikeringsrollen för redundansklustergruppens instans.

Name Type Description
Primary
  • string
Secondary
  • string

PartnerInfo

Partnerserverinformation för redundansgruppen.

Name Type Description
id
  • string

Resursidentifierare för partnerservern.

location
  • string

Geoplats för partnerservern.

replicationRole

Replikeringsrollen för partnerservern.

ReadOnlyEndpointFailoverPolicy

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

Name Type Description
Disabled
  • string
Enabled
  • string

ReadWriteEndpointFailoverPolicy

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

Name Type Description
Automatic
  • string
Manual
  • string