Sdílet prostřednictvím


Failover Groups - Force Failover Allow Data Loss

Převzetí služeb 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á prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z 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 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ě naformá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 zadaných partnerských serverů už jsou součástí skupiny převzetí služeb při selhání. Ujistěte se, že primární server a všechny partnerské servery jsou jedinečné.

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

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – pro skupinu převzetí služeb při selhání se podporuje jenom jeden partner. Upravte prosím 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 požadavku na vytvoření nebo aktualizaci skupiny převzetí služeb při selhání je prázdný nebo neplatný.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Na sekundárním serveru nejsou povolené úpravy skupiny převzetí služeb při selhání. 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 v{0} minutách.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – vlastnost failoverWithDataLossGracePeriodMinutes musí být zadána, pokud je pro koncový bod pro čtení i zápis vybraná zásada převzetí služeb při selhání Automaticky.

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

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – hodnota období odkladu by neměla být zadaná, 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 ji prosím z žádosti.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Text požadavku skupiny převzetí služeb při selhání by neměl měnit 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. Servery skupiny převzetí služeb při selhání mezi předplatnými nejsou povoleny.

  • 400 InvalidAddSecondaryPermission – Uživatel nemá dostatečná oprávnění k přidání sekundárního serveru na zadaný 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 v aktuální edici databáze zakázaná.

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

  • 400 InvalidTargetSubregion – cílový server nečitelné sekundární oblasti není ve spárované oblasti Azure pro zotavení 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é na serveru dokončit, 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 nešlo dokončit, protože identifikátor URI Azure Key Vault 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 azure Key Vault.

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

  • 400 SecurityAzureKeyVaultInvalidKeyName – Operaci nebylo možné dokončit kvůli neplatnému názvu klíče serveru.

  • 400 PlannedFailoverTimedOutForDatabase – uživatel vyvolal plánovaný přechod na záložní systém, vypršel jeho časový limit a zdá se, že je na vině konkrétní databáze.

  • 400 PlannedFailoverTimedOut – uživatel vyvolal plánovaný přechod na záložní systém a při pokusu o kontaktování služby pro správu partnera vypršel jeho časový limit.

  • 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í objekt knihovny Azure Active Directory se nenašel.

  • 400 AzureKeyVaultMalformedVaultUri – zadaný identifikátor URI 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 se zajistily 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 se nejedná o propojení průběžného kopírování.

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

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

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

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

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

  • 400 KeyMaterialNotFoundOnRemoteServer – Vzdálený server nemá přístup ke klíčům, které se používají 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íčů ze stejného trezoru klíčů jako ochrana šifrování primárního serveru s povolenou automatickou obměnou klíče.

  • 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íč 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é přelož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ího šifrování dat pomocí Azure Key Vault (BYOK) se nepodporuje vytvoření sekundárního serveru (proces označovaný jako řetězení).

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 404 ResourceNotFound – Požadovaný prostředek se nenašel.

  • 404 OperationIdNotFound – operace s ID neexistuje.

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

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

  • 404 SourceDatabaseNotFound – zdrojová databáze neexistuje.

  • 405 UnsupportedReplicationOperation – Pro 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í se stejným prostředkem.

  • 409 ConflictingServerOperation – aktuálně probíhá operace pro server.

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

  • 409 ConflictingSystemOperationInProgress – V databázi probíhá operace údržby systému a další operace musí počkat na dokončení.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – uživatel se pokusil převzít služby při selhání nebo vynutit ukončení geografického propojení, zatímco sekundární služba je ve stavu, kdy nemusí být fyzicky konzistentní, a proto nemůže vstoupit do primární role.

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

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

  • 409 ServerKeyDoesNotExists – klíč serveru neexistuje.

  • 409 UpdateSloInProgress – uživatel se pokusil zahájit nekompatibilní operaci, zatímco probíhala aktualizace SLO.

  • 409 AzureKeyVaultKeyNameNotFound – Operaci nebylo možné 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í už 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ěná jinou operací.

  • 409 DatabaseBelongsToOtherFailoverGroup – Databáze patří do jiné skupiny převzetí služeb při selhání a nelze ji považovat za součást této skupiny.

  • 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 na dokončení této operace, aby došlo k odebrání.

  • 409 DatabaseBeingRemovedFromFailoverGroup – databáze se právě odebírá ze skupiny převzetí služeb při selhání, zákazník musí počkat na dokončení této operace, aby se problém přidal.

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

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

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – U databáze, která je již ve vztahu replikace, byla provedena operace seeding replikace.

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

  • 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 maximální počet požadavků, které je možné zpracovat dostupnými prostředky.

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

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

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

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

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

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

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

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

  • 503 DatabaseUnavailable –Operace se nezdařila, 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 jen pro čtení instance skupiny 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í.

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í i zápis pro skupinu převzetí služeb při selhání. Pokud je zásada převzetí služeb při selhání automatická, vyžaduje se 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[]

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 jen pro čtení instance skupiny převzetí služeb při selhání

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 prostředku.

FailoverGroupReadOnlyEndpoint

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

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í i zápis pro skupinu převzetí služeb při selhání. Pokud je zásada převzetí služeb při selhání automatická, vyžaduje se převzetí služeb při selháníWithDataLossGracePeriodMinutes.

failoverWithDataLossGracePeriodMinutes

integer

Období odkladu před pokusem o převzetí služeb při selhání se ztrátou dat pro koncový bod pro čtení i zápis. Pokud je zásada převzetí služeb při selhání automatická, vyžaduje se 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 Typ Description
Primary

string

Secondary

string

PartnerInfo

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

Name Typ Description
id

string

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

Name Typ Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Zásady převzetí služeb při selhání koncového bodu pro čtení i zápis pro skupinu převzetí služeb při selhání. Pokud je zásada převzetí služeb při selhání automatická, vyžaduje se převzetí služeb při selháníWithDataLossGracePeriodMinutes.

Name Typ Description
Automatic

string

Manual

string