Sdílet prostřednictvím


Instance Failover Groups - Force Failover Allow Data Loss

Převzetí služeb při selhání z aktuální primární spravované instance na tuto spravovanou instanci Tato operace může vést ke ztrátě dat.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{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í.

locationName
path True

string

Název oblasti, ve které se prostředek nachází.

resourceGroupName
path True

string

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

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

InstanceFailoverGroup

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 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary – dané primární pole v textu požadavku skupiny převzetí služeb při selhání instance pro vytvoření nebo aktualizaci je prázdné nebo neplatné.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner – dané pole partnerů v textu požadavku skupiny převzetí služeb při selhání pro vytvoření nebo aktualizaci instance je prázdné nebo neplatné.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion – zadaná oblast partnerské spravované instance v textu požadavku skupiny převzetí služeb při selhání instance je prázdná nebo neplatná.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – podporuje se jenom jedna oblast partnera.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount – podporuje se pouze jeden pár spravovaných instancí.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid – text požadavku skupiny převzetí služeb při selhání vytvoření nebo aktualizace instance je prázdný nebo neplatný.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary – Úpravy skupiny převzetí služeb při selhání instance nejsou na sekundárním serveru povoleny. Spusťte požadavek na primárním serveru.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – hodnota období odkladu pro koncový bod pro čtení i zápis musí být nezáporná.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – vlastnost failoverWithDataLossGracePeriodMinutes musí 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í Automaticky.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – 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ě.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Text žádosti skupiny převzetí služeb při selhání instance vytvoření nebo aktualizace by neměl měnit vlastnost{0} jen pro čtení.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary – 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í instance.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription – Primární server a partnerská skupina převzetí služeb při selhání jsou z různých předplatných. Servery skupiny převzetí služeb při selhání mezi předplatnými nejsou povoleny.

  • 400 FailoverGroupRegionMismatch – oblast partnera zadaná ve skupině převzetí služeb při selhání se musí shodovat s uvedenou oblastí spravované instance partnera.

  • 400 ServerEditionMismatch – Edice musí být stejná jako primární server při vytváření serveru repliky.

  • 400 DnsZoneMismatch – dnsZone na partnerském serveru se liší od DNSZone na zdrojovém serveru. Tím se přeruší funkce InstanceFailoverGroup.

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

  • 400 GeoDrInstanceSizeMismatch – Primární spravovaná instance a spravovaná instance partnera nemají stejnou velikost úložiště.

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

  • 400 GeoDrSecondaryInstanceNotEmpty – sekundární spravovaná instance obsahuje uživatelské databáze. Aby bylo možné vytvořit skupinu převzetí služeb při selhání instance, musí být sekundární spravovaná instance prázdná.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration – nesprávná konfigurace sítě. Provoz replikace primárního serveru nemůže dosáhnout sekundárního serveru.

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

  • 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 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 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 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 RemoteDatabaseCopyPermission – Uživatel nemá dostatečná oprávnění k vytvoření kopie databáze na zadaném serveru.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – Sekundární server nemá klíč ochrany šifrování primárního serveru.

  • 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í instance se kvůli izolaci musí nacházet v různých oblastech.

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

  • 400 InstanceFailoverGroupNotSecondary – 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í instance.

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

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

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

  • 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 InvalidSku – Uživatel zadal neplatnou skladovou položku.

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

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

  • 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 GeoReplicationDatabaseNotSecondary – operace očekává, že databáze bude cílem replikace.

  • 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 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná.

  • 404 OperationIdNotFound – operace s ID neexistuje.

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

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 404 SourceDatabaseNotFound – zdrojová databáze neexistuje.

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

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

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

  • 409 ManagedInstanceHasHybridLink – uživatel se pokusil zahájit operaci, která není podporována, pokud má spravovaná instance nakonfigurované hybridní propojení.

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

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

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

  • 409 InstanceFailoverGroupAlreadyExists – skupina převzetí služeb při selhání již na daném serveru existuje.

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

  • 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, kdy nemusí být fyzicky konzistentní, a proto nemůže vstoupit do primární role.

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

  • 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 InvalidFailoverGroupName – byl zadán neplatný název skupiny převzetí služeb při selhání instance.

  • 409 UpdateSloInProgress – uživatel se pokusil zahájit nekompatibilní operaci v době, kdy probíhala 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 ConflictingSystemOperationInProgress – v databázi probíhá operace údržby systému a další operace musí počkat na dokončení.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – U databáze, která je již v relaci 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ž v relaci replikace. Jedná se o duplicitní požadavek.

  • 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu 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 rámec maximálního počtu 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 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í Key Vault informací došlo k chybě .

  • 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/locations/Japan West/instanceFailoverGroups/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/locations/JapanWest/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance"
      }
    ]
  }
}

Definice

Name Description
InstanceFailoverGroup

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

InstanceFailoverGroupReadOnlyEndpoint

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

InstanceFailoverGroupReadWriteEndpoint

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

InstanceFailoverGroupReplicationRole

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

ManagedInstancePairInfo

Páry spravovaných instancí ve skupině převzetí služeb při selhání

PartnerRegionInfo

Informace o partnerské oblasti 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.

InstanceFailoverGroup

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

Name Typ Description
id

string

ID prostředku.

name

string

Název prostředku.

properties.managedInstancePairs

ManagedInstancePairInfo[]

Seznam párů spravovaných instancí ve skupině převzetí služeb při selhání

properties.partnerRegions

PartnerRegionInfo[]

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

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

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

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

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

properties.replicationRole

InstanceFailoverGroupReplicationRole

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í

type

string

Typ prostředku.

InstanceFailoverGroupReadOnlyEndpoint

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

InstanceFailoverGroupReadWriteEndpoint

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.

InstanceFailoverGroupReplicationRole

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

Name Typ Description
Primary

string

Secondary

string

ManagedInstancePairInfo

Páry spravovaných instancí ve skupině převzetí služeb při selhání

Name Typ Description
partnerManagedInstanceId

string

ID partnerské spravované instance v páru.

primaryManagedInstanceId

string

ID primární spravované instance v páru

PartnerRegionInfo

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

Name Typ Description
location

string

Geografické umístění instancí spravovaných partnerem

replicationRole

InstanceFailoverGroupReplicationRole

Role replikace partnerských spravovaných instancí

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