Failover Groups - Create Or Update

Vytvoří nebo aktualizuje skupinu převzetí služeb při selhání.

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

Parametry identifikátoru URI

Name In Required Type Description
failoverGroupName
path True
  • string

Název skupiny převzetí služeb při selhání.

resourceGroupName
path True
  • string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API služby Azure Resource Manager nebo portálu.

serverName
path True
  • string

Název serveru obsahujícího skupinu převzetí služeb při selhání.

subscriptionId
path True
  • string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True
  • string

Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name Required Type Description
properties.partnerServers True

Seznam informací o partnerském serveru pro skupinu převzetí služeb při selhání

properties.readWriteEndpoint True

Koncový bod pro čtení a zápis instance skupiny převzetí služeb při selhání

properties.databases
  • string[]

Seznam databází ve skupině převzetí služeb při selhání

properties.readOnlyEndpoint

Koncový bod jen pro čtení instance skupiny převzetí služeb při selhání

tags
  • object

Značky prostředků

Odpovědi

Name Type Description
200 OK

Skupina převzetí služeb při selhání byla úspěšně aktualizována.

201 Created

Skupina převzetí služeb při selhání byla úspěšně vytvořena.

202 Accepted

Přijato

Other Status Codes

Chybové odpovědi: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – Zadané ID id databází nejsou správně vytvořené ID prostředků databáze. Příklad správného formátování najdete v tématu https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner – dané pole partnerů v textu žádosti o vytvoření nebo aktualizaci skupiny převzetí služeb při selhání je prázdné nebo neplatné. Zadejte platnou hodnotu tohoto pole. Příklady správně formátovaných požadavků najdete v tématu https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – Jeden nebo více poskytovaných partnerských serverů už je součástí skupiny převzetí služeb při selhání. Ujistěte se, že primární server a všechny dané partnerské servery jsou jedinečné.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – Jedna nebo více zadaných databází na primárním serveru skupiny převzetí služeb při selhání neexistuje. Ujistěte se, že na primárním serveru existují všechny databáze.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – podporuje se pouze jeden partnerový server pro skupinu převzetí služeb při selhání. Upravte svoji žádost odpovídajícím způsobem. Příklady platných požadavků najdete v tématu . https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – pole readWriteEndpoint se vyžaduje pro žádosti o vytvoření nebo aktualizaci.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid – text žádosti o vytvoření nebo aktualizaci skupiny převzetí služeb při selhání je prázdný nebo neplatný.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Změny skupiny převzetí služeb při selhání nejsou na sekundárním serveru povolené. Spusťte požadavek na primárním serveru.

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Hodnota období odkladu koncového bodu pro čtení a zápis musí být nezáporná.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Vlastnost převzetí služeb při selháníWithDataLossGracePeriodMinutes musí být zadána, když je pro koncový bod pro čtení a zápis vybrána zásada převzetí služeb při selhání Automaticky.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – pole failoverPolicy pro koncový bod pro čtení a zápis se vyžaduje pro žádosti o vytvoření nebo aktualizaci.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – Hodnota období odkladu by neměla být zadána, pokud je pro koncový bod pro čtení a zápis vybrána příručka zásad převzetí služeb při selhání. Odeberte ho z požadavku.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Text žádosti o vytvoření nebo aktualizaci skupiny převzetí služeb při selhání by neměl upravovat vlastnost{0} jen pro čtení.

  • 400 FailoverGroupFailoverRequestOnPrimary – Požadavek na převzetí služeb při selhání by měl být zahájen na sekundárním serveru skupiny převzetí služeb při selhání.

  • 400 FailoverGroupPartnerServerFromDifferentSubscription – primární server a partnerské servery skupiny převzetí služeb při selhání pocházejí z různých předplatných. Křížové předplatné pro servery skupiny převzetí služeb při selhání není povolené.

  • 400 InvalidAddSecondaryPermission – Uživatel nemá dostatečná oprávnění přidat sekundární server.

  • 400 InvalidSku – Uživatel zadal neplatnou skladovou položku.

  • 400 ServerNotFound – Požadovaný server nebyl nalezen.

  • 400 FeatureDisabledOnSelectedEdition – Uživatel se pokusil použít funkci, která je zakázaná v aktuální edici databáze.

  • 400 TokenTooLong – Zadaný token je příliš dlouhý.

  • 400 InvalidTargetSubregion – cílový server nečitelné sekundární oblasti Azure není ve spárované oblasti Azure.

  • 400 PartnerServerNotCompatible – Uživatel se pokouší zkopírovat databázi ze serveru SAWA V1 na server Sterling nebo naopak.

  • 400 NesprávnýReplicationLinkState – Operace očekává, že databáze bude v očekávaném stavu na odkazu replikace.

  • 400 ResourcePoolNotFound – Zadaný elastický fond neexistuje na zadaném logickém serveru.

  • 400 AzureKeyVaultKeyDisabled – Operaci nelze dokončit na serveru, protože klíč Azure Key Vault je zakázaný.

  • 400 AzureKeyVaultInvalidExpirationDate – operaci nelze dokončit, protože datum vypršení platnosti klíče azure Key Vault je neplatné.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – operaci nelze dokončit, protože identifikátor URI Key Vault Azure je null nebo prázdný.

  • 400 AzureKeyVaultNoServerIdentity – Identita serveru není správně nakonfigurovaná.

  • 400 AzureKeyVaultInvalidUri – neplatná odpověď z Azure Key Vault. Použijte platný identifikátor URI služby Azure Key Vault.

  • 400 AzureKeyVaultMissingPermissions – Na serveru chybí požadovaná oprávnění k azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName – operaci nelze dokončit kvůli neplatnému názvu klíče serveru.

  • 400 PlannedFailoverTimedOutForDatabase – Uživatel vyvolal plánované převzetí služeb při selhání, vypršel časový limit a zdá se, že je na vině konkrétní databáze.

  • 400 PlannedFailoverTimedOut – Uživatel vyvolal plánované převzetí služeb při selhání a vypršel časový limit při pokusu o kontaktování služby pro správu partnerů.

  • 400 AdalGenericError – Operaci nelze dokončit, protože došlo k chybě Azure Active Directory.

  • 400 AdalServicePrincipalNotFound – Operaci nelze dokončit, protože došlo k chybě instančního objektu knihovny Azure Active Directory.

  • 400 AzureKeyVaultMalformedVaultUri – zadaný identifikátor URI Key Vault není platný.

  • 400 CannotUseReservedDatabaseName – V této operaci nelze použít vyhrazený název databáze.

  • 400 InvalidFailoverGroupRegion – Servery zadané ve skupině převzetí služeb při selhání se musí nacházet v různých oblastech, aby byla zajištěna izolace.

  • 400 FailoverGroupDoesNotExist – skupina převzetí služeb při selhání na serveru neexistuje.

  • 400 FailoverGroupNotSecondary – Převzetí služeb při selhání nejde zahájit z primárního serveru ve skupině převzetí služeb při selhání.

  • 400 InvalidServerName – zadaný neplatný název serveru.

  • 400 DatabaseInFailoverGroupNotPrimary – odkaz GeoDR pro databázi již existuje, ale jeho role není primární nebo není propojení průběžného kopírování.

  • 400 SecurityAdalPrincipalCertExpiredError – operaci nelze dokončit, protože vypršela platnost instančního certifikátu Azure Key Vault.

  • 400 CannotToCreateFailoverGroupDueToTableAuditing – Skupinu převzetí služeb při selhání nelze vytvořit pro server se zapnutým auditováním tabulek.

  • 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup – Databáze s povoleným auditováním tabulek nebude přístupná prostřednictvím koncového bodu skupiny převzetí služeb při selhání.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – zadaný identifikátor URI Key Vault není platný.

  • 400 KeyMaterialNotFoundOnRemoteServer – Vzdálený server nemá přístup k klíčovým materiálům používaným jako ochrana transparentním šifrováním dat.

  • 400 LimitOfFailoverGroupsPerServerExceededed – Vytvoření nové skupiny převzetí služeb při selhání překročí povolený počet skupin převzetí služeb při selhání na server.

  • 400 AzureKeyVaultMismatchError – Neočekávaná oblast Key Vault nalezená v odpovědi http.

  • 400 AzureKeyVaultRsaKeyNotSupported – Zadaný trezor klíčů používá nepodporovanou velikost klíče RSA nebo typ klíče. Podporovaná velikost klíče RSA je 2048 nebo 3072 a typ klíče je RSA nebo RSA-HSM.

  • 400 GeoReplicationDatabaseNotSecondary – operace očekává, že databáze bude cílem replikace.

  • 400 GeoReplicaLimitReached – Dosáhli jsme limitu replikace pro jednotlivé repliky.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported – Skupiny převzetí služeb při selhání nakonfigurované pomocí zásad automatického převzetí služeb při selhání se v současné době nepodporují na serverech nakonfigurovaných s pravidly brány firewall virtuální sítě. Nakonfigurujte skupinu převzetí služeb při selhání pomocí zásad ručního převzetí služeb při selhání.

  • 400 UnableToResolveRemoteServer – Název vzdáleného partnerského serveru se nepodařilo vyřešit kvůli neplatnému názvu serveru nebo problémům s připojením k DNS.

  • 400 RemoteDatabaseCopyPermission – Uživatel nemá dostatečná oprávnění k vytvoření kopie databáze na zadaném serveru.

  • 400 SecurityAzureKeyVaultGeoChainError – Při povolování transparentní šifrování dat pomocí Azure Key Vault (BYOK) se nepodporuje vytváření sekundárních sekundárních objektů (proces označovaný jako řetězení).

  • 400 FailoverGroupCreateOrUpdatePartiallySucceeded – Některé databáze nelze přidat ani odebrat.

  • 404 OperationIdNotFound – Operace s ID neexistuje.

  • 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen.

  • 404 OperationIdNotFound – Operace s ID neexistuje.

  • 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.

  • 404 ServerNotInSubscription – Zadaný server v zadaném předplatném neexistuje.

  • 404 SourceDatabaseNotFound – Zdrojová databáze neexistuje.

  • 405 UnsupportedReplicationOperation – v databázi byla zahájena nepodporovaná operace replikace.

  • 409 OperationCancelled – operace byla zrušena uživatelem.

  • 409 OperationInterrupted – operaci prostředku nebylo možné dokončit, protože ji přerušila jiná operace stejného prostředku.

  • 409 ConflictingServerOperation – právě probíhá operace pro server.

  • 409 SubscriptionDisabled – Předplatné je zakázané.

  • 409 ConflictingSystemOperationInProgress – Probíhá operace údržby systému v databázi a další operace musí čekat na dokončení.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – uživatel se pokusil o převzetí služeb při selhání nebo vynucení ukončení geografického propojení, zatímco sekundární je ve stavu, kde nemusí být fyzicky konzistentní a proto nemůže zadat primární roli.

  • 409 ServerKeyNameAlreadyExists – klíč serveru již na serveru existuje.

  • 409 ServerKeyUriAlreadyExists – identifikátor URI klíče serveru již na serveru existuje.

  • 409 ServerKeyDoesNotExists – klíč serveru neexistuje.

  • 409 UpdateSloInProgress – uživatel se pokusil inicializovat nekompatibilní operaci, když probíhá aktualizace SLO.

  • 409 AzureKeyVaultKeyNameNotFound – operaci nelze dokončit, protože název klíče Azure Key Vault neexistuje.

  • 409 AzureKeyVaultKeyInUse – Klíč aktuálně používá server.

  • 409 FailoverGroupAlreadyExists – skupina převzetí služeb při selhání již na daném serveru existuje. Použijte jiný název skupiny převzetí služeb při selhání.

  • 409 FailoverGroupBusy – Skupina převzetí služeb při selhání je zaneprázdněna jinou operací.

  • 409 DatabaseBelongsToOtherFailoverGroup – Databáze patří do jiné skupiny převzetí služeb při selhání a nelze ji vzít v úvahu.

  • 409 DatabaseBeingAddedToFailoverGroup – Databáze se právě přidává do skupiny převzetí služeb při selhání, zákazník musí počkat, až se tato operace dokončí, aby se problém odstranil.

  • 409 DatabaseBeingRemovedFromFailoverGroup – Databáze je aktuálně odebrána ze skupiny převzetí služeb při selhání, zákazník musí počkat, až se tato operace dokončí, aby se přidala.

  • 409 FailoverGroupDnsRecordInUse – Pro požadovaný koncový bod existuje duplicitní záznam DNS.

  • 409 InvalidFailoverGroupName – Byl zadán neplatný název skupiny převzetí služeb při selhání.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Operace počáteční replikace byla provedena v databázi, která je již v relaci replikace.

  • 409 InvalidDatabaseStateForOperation – Operace není povolena v databázi v aktuálním stavu replikace.

  • 409 DuplicateGeoDrRelation – databáze jsou již ve vztahu replikace. Jedná se o duplicitní požadavek.

  • 409 RemoteDatabaseExists – název cílové databáze již na cílovém serveru existuje.

  • 409 FailoverGroupUnableToPerformGroupOperationOnDatabases – seznam databází, které se mají přidat nebo odebrat do nebo ze skupiny převzetí služeb při selhání, obsahuje chyby, které brání dokončení operace.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které lze zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které lze zpracovávat dostupnými prostředky.

  • 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Opakujte operaci.

  • 503 TooManyRequests – Požadavky nad rámec maximálního počtu požadavků, které lze zpracovávat dostupnými prostředky.

  • 503 AzureKeyVaultConnectionFailed – Operaci nelze na serveru dokončit, protože pokusy o připojení k Azure Key Vault selhaly.

  • 503 AzureKeyVaultGenericConnectionError – Operaci nelze dokončit, protože při pokusu o načtení informací o Key Vault došlo k chybě.

  • 503 DatabaseUnavailable – Operace selhala, protože databáze není k dispozici.

  • 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

Příklady

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"
    ]
  }
}

Definice

FailoverGroup

Skupina převzetí služeb při selhání.

FailoverGroupReadOnlyEndpoint

Koncový bod jen pro čtení instance skupiny převzetí služeb při selhání

FailoverGroupReadWriteEndpoint

Koncový bod pro čtení a zápis instance skupiny převzetí služeb při selhání

FailoverGroupReplicationRole

Role místní replikace instance skupiny převzetí služeb při selhání

PartnerInfo

Informace o partnerském serveru pro skupinu převzetí služeb při selhání

ReadOnlyEndpointFailoverPolicy

Zásady převzetí služeb při selhání koncového bodu jen pro čtení pro skupinu převzetí služeb při selhání

ReadWriteEndpointFailoverPolicy

Zásady převzetí služeb při selhání koncového bodu pro čtení a zápis pro skupinu převzetí služeb při selhání Pokud je převzetí služeb při selhání Automatické, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.

FailoverGroup

Skupina převzetí služeb při selhání.

Name Type Description
id
  • string

ID prostředku.

location
  • string

Umístění prostředku.

name
  • string

Název prostředku.

properties.databases
  • string[]

Seznam databází ve skupině převzetí služeb při selhání

properties.partnerServers

Seznam informací o partnerském serveru pro skupinu převzetí služeb při selhání

properties.readOnlyEndpoint

Koncový bod jen pro čtení instance skupiny převzetí služeb při selhání

properties.readWriteEndpoint

Koncový bod pro čtení a zápis instance skupiny převzetí služeb při selhání

properties.replicationRole

Role místní replikace instance skupiny převzetí služeb při selhání

properties.replicationState
  • string

Stav replikace instance skupiny převzetí služeb při selhání

tags
  • object

Značky prostředků

type
  • string

Typ prostředku.

FailoverGroupReadOnlyEndpoint

Koncový bod jen pro čtení instance skupiny převzetí služeb při selhání

Name Type Description
failoverPolicy

Zásady převzetí služeb při selhání koncového bodu jen pro čtení pro skupinu převzetí služeb při selhání

FailoverGroupReadWriteEndpoint

Koncový bod pro čtení a zápis instance skupiny převzetí služeb při selhání

Name Type Description
failoverPolicy

Zásady převzetí služeb při selhání koncového bodu pro čtení a zápis pro skupinu převzetí služeb při selhání Pokud je převzetí služeb při selhání Automatické, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.

failoverWithDataLossGracePeriodMinutes
  • integer

Období odkladu před převzetím služeb při selhání se ztrátou dat se pokusí o koncový bod pro čtení a zápis. Pokud je převzetí služeb při selhání Automatické, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.

FailoverGroupReplicationRole

Role místní replikace instance skupiny převzetí služeb při selhání

Name Type Description
Primary
  • string
Secondary
  • string

PartnerInfo

Informace o partnerském serveru pro skupinu převzetí služeb při selhání

Name Type Description
id
  • string

Identifikátor prostředku partnerského serveru.

location
  • string

Geografické umístění partnerského serveru

replicationRole

Role replikace partnerského serveru

ReadOnlyEndpointFailoverPolicy

Zásady převzetí služeb při selhání koncového bodu jen pro čtení pro skupinu převzetí služeb při selhání

Name Type Description
Disabled
  • string
Enabled
  • string

ReadWriteEndpointFailoverPolicy

Zásady převzetí služeb při selhání koncového bodu pro čtení a zápis pro skupinu převzetí služeb při selhání Pokud je převzetí služeb při selhání Automatické, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.

Name Type Description
Automatic
  • string
Manual
  • string