Instance Failover Groups - Get

Získá skupinu převzetí služeb při selhání.

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

Zadanou skupinu převzetí služeb při selhání se úspěšně načetla.

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 vytvoření nebo aktualizace je prázdné nebo neplatné.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner – dané pole partnerů v textu žádosti skupiny převzetí služeb při selhání 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 spravované instance partnera v textu žádosti skupiny převzetí služeb při selhání instance je prázdná nebo neplatná.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – podporuje se pouze jedna partnerský region.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – pole readWriteEndpoint je vyžadováno pro požadavky na vytvoření nebo aktualizaci.

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

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – hodnota období odkladu pro koncový bod pro čtení a 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 minimálnímu období odkladu v{0} minutách.

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

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – hodnota období odkladu by neměla být zadána, pokud je pro koncový bod pro čtení a zápis vybrána zásada převzetí služeb při selhání Ručně.

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

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

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription – primární server a partnerská skupina 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 FailoverGroupRegionMismatch – partnerský region zadaný ve skupině převzetí služeb při selhání se musí shodovat s oblastí uvedené 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 zotavení po havárii.

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

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

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

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration – Konfigurace sítě je nesprávná. 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íčovému materiálu používanému 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 nelze vyřeš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á materiál klíče 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 musí nacházet v různých oblastech, aby byly izolované.

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

  • 400 InstanceFailoverGroupNotSecondary – Převzetí služeb při selhání nelze 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 null nebo neplatný znak unicode.

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

  • 400 AzureKeyVaultKeyDisabled – Operaci nelze 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 nelze 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 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í na Key Vault Azure.

  • 400 SecurityAzureKeyVaultInvalidKeyName – operaci nelze 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 č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 partnerů vypršel č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 nelze dokončit, protože došlo k chybě Instanční objekt knihovny Azure Active Directory nebyl nalezen.

  • 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 ResourceNotFound – požadovaný prostředek nebyl nalezen.

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

  • 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

Get failover group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test?api-version=2021-11-01

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/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 West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Definice

Name Description
InstanceFailoverGroup

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

InstanceFailoverGroupReadOnlyEndpoint

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

InstanceFailoverGroupReadWriteEndpoint

Koncový bod pro čtení a 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

Dvojice 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í a 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á, pak se vyžaduje 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 instance skupiny převzetí služeb při selhání jen pro čtení

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Koncový bod pro čtení a 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 instance 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í

InstanceFailoverGroupReadWriteEndpoint

Koncový bod pro čtení a 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 zásada převzetí služeb při selhání automatická, pak se vyžaduje 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á, pak se vyžaduje 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

Dvojice 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í a 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á, pak se vyžaduje převzetí služeb při selháníWithDataLossGracePeriodMinutes.

Name Typ Description
Automatic

string

Manual

string