Sdílet prostřednictvím


Failover Groups - Force Failover Allow Data Loss

Převezme služby při selhání z aktuálního primárního serveru na tento server. Tato operace může vést ke ztrátě dat.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ 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á obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru 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.

Odpovědi

Name Typ Description
200 OK

FailoverGroup

Došlo k úspěšnému převzetí služeb při selhání.

202 Accepted

Přijato

Other Status Codes

Chybové odpovědi: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – Zadané ID databází nejsou správně sestavené ID prostředků databáze. Příklad správného formátování najdete v 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ů je již 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 poskytnutých databází na primárním serveru skupiny převzetí služeb při selhání neexistuje. Ujistěte se, že všechny databáze existují na primárním serveru.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – Podporuje se jenom jeden partnerový server pro skupinu převzetí služeb při selhání. Odpovídajícím způsobem upravte svou žádost. 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 je vyžadováno 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 pro koncový bod pro čtení i zápis musí být nezáporná.

  • 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – Hodnota období odkladu pro skupinu převzetí služeb při selhání musí být větší nebo rovna minimálnímu období odkladu pro{0}minut.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Vlastnost failoverWithDataLossGracePeriodMinutes 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 je vyžadováno 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í i zápis vybrána zásada převzetí služeb při selhání Ručně. Odeberte ho z žádosti.

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

  • 400 FailoverGroupFailoverRequestOnPrimary – Požadavek na převzetí služeb při selhání by se měl zahájit 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. Mezi předplatnými pro servery skupiny převzetí služeb při selhání není povoleno.

  • 400 InvalidAddSecondaryPermission – Uživatel nemá dostatečná oprávnění k přidání sekundární na zadaném serveru.

  • 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 v aktuální edici databáze zakázaná.

  • 400 TokenTooLong - Poskytnutý token je příliš dlouhý.

  • 400 InvalidTargetSubregion – cílový server nečitelné sekundární oblasti Azure není ve spárované oblasti Azure s zotavením po havárii.

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

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

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

  • 400 AzureKeyVaultKeyDisabled – Operaci nebylo možné dokončit na serveru, protože klíč služby Azure Key Vault je zakázaný.

  • 400 AzureKeyVaultInvalidExpirationDate – Operaci nebylo možné dokončit, protože datum vypršení platnosti klíče služby Azure Key Vault je neplatné.

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

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

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

  • 400 AzureKeyVaultMissingPermissions – Na serveru chybí požadovaná oprávnění ke službě 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 konkrétní databáze je obviňována.

  • 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 nebylo možné dokončit, protože došlo k chybě Azure Active Directory.

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

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

  • 400 CannotUseReservedDatabaseName – V této operaci nelze použít název rezervované 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í odkaz pro průběžné kopírování.

  • 400 SecurityAdalPrincipalCertExpiredError – Operaci nebylo možné dokončit, protože vypršela platnost certifikátu objektu zabezpečení služby Azure Key Vault.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing – 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 služby Key Vault není platný.

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

  • 400 LimitOfFailoverGroupsPerServerExceeded – 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 SameKeyUriNotFoundOnRemoteServer – Sekundární server nemá materiál klíče ze stejného trezoru klíčů jako ochrana šifrování primárního serveru s povolenou automatickou obměnou klíčem.

  • 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 SameKeyMaterialNotFoundOnRemoteServer – Sekundární server nemá klíč materiálu ochrany šifrování primárního serveru.

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

  • 400 GeoReplicaLimitReached – Bylo dosaženo limitu replikace na repliku.

  • 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 nebylo možné vyřešit kvůli neplatnému názvu serveru nebo problémům s připojením 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 povolení transparentního šifrování dat pomocí služby Azure Key Vault (BYOK) není podporováno vytváření sekundárních objektů (proces označovaný jako řetězení).

  • 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 s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací na stejném prostředku.

  • 409 ConflictingServerOperation – Aktuálně 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 zahájit nekompatibilní operaci, když probíhá aktualizace SLO.

  • 409 AzureKeyVaultKeyNameNotFound – Operaci nebylo možné dokončit, protože název klíče služby 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 nemůže být součástí této skupiny.

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

  • 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 na dokončení této operace, aby se přidal.

  • 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í v databázi v aktuálním stavu replikace povolena.

  • 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.

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

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

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

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

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

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 503 AzureKeyVaultConnectionFailed – Operaci se nepodařilo dokončit na serveru, protože pokusy o připojení ke službě Azure Key Vault selhaly.

  • 503 AzureKeyVaultGenericConnectionError – Operaci nelze dokončit, protože při pokusu o načtení informací služby 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

Forced failover of a failover group allowing data loss

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
FailoverGroup

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

FailoverGroupReadOnlyEndpoint

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

FailoverGroupReadWriteEndpoint

Koncový bod pro čtení i 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 hodnota failoverPolicy 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 Typ Description
id

string

ID prostředku.

location

string

Umístění prostředku

name

string

Název prostředku

properties.databases

string[] (arm-id)

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

properties.partnerServers

PartnerInfo[]

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

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

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

properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

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

properties.replicationRole

FailoverGroupReplicationRole

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 zdroje.

FailoverGroupReadOnlyEndpoint

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

Name Typ Description
failoverPolicy

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í

FailoverGroupReadWriteEndpoint

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

Name Typ Description
failoverPolicy

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 hodnota failoverPolicy automatická, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.

failoverWithDataLossGracePeriodMinutes

integer (int32)

Období odkladu před převzetím služeb při selhání se ztrátou dat se pokusí o koncový bod pro čtení i zápis. Pokud je hodnota failoverPolicy 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í

Hodnota Description
Primary
Secondary

PartnerInfo

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

Name Typ Description
id

string (arm-id)

Identifikátor prostředku partnerského serveru.

location

string

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

replicationRole

FailoverGroupReplicationRole

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í

Hodnota Description
Disabled
Enabled

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 hodnota failoverPolicy automatická, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.

Hodnota Description
Automatic
Manual