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

locationName
path True
  • string

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

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.

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 Type Description
200 OK

Úspěšně se načetla zadaná skupina převzetí služeb při selhání.

Other Status Codes

Chybové odpovědi: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary – dané primární pole v textu žádosti o vytvoření nebo aktualizaci skupiny převzetí služeb při selhání instance je prázdné nebo neplatné.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner – Jeden nebo více poskytovaný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 dané partnerské servery jsou jedinečné.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion – zadaná oblast instance spravované partnerem 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 se vyžaduje pro žádosti o vytvoření nebo aktualizaci.

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

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Hodnota období odkladu koncového bodu 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{0} minimálnímu období odkladu minut

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – Vlastnost převzetí služeb při selháníWithDataLossGracePeriodMinutes musí být zadána, když je pro koncový bod pro čtení 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 příručka zásad převzetí služeb při selhání.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – Text požadavku skupiny převzetí služeb při selhání instance vytvoření nebo aktualizace instance 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 partnerový server 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 FailoverGroupRegionMismatch – Partnerský region zadaný ve skupině převzetí služeb při selhání musí odpovídat oblasti uvedené v partnerské spravované instanci.

  • 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 Azure není ve spárované oblasti Azure.

  • 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 instančního certifikátu 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ě není správná. Provoz replikace primárního serveru nemůže dosáhnout sekundárního serveru.

  • 400 NesprávnýReplicationLinkState – 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 k klíčovým materiálům používaným 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 DNS.

  • 400 SameKeyUriNotFoundOnRemoteServer – Sekundární server nemá materiál klíče ze stejného trezoru klíčů jako ochrana šifrování primárního serveru s povoleným automatickým otočením 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íčový materiál ochrany šifrování primárního serveru.

  • 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í instance musí být umístěny v různých oblastech, aby bylo zajištěna izolace.

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

  • 400 InvalidAddSecondaryPermission – Uživatel nemá dostatečná oprávnění přidat sekundární 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 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ě Služby 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ího objektu knihovny Azure Active Directory.

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

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

  • 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 Nepodporovaná operaceReplicationOperation – 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 – právě 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ěna 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, kde nemusí být fyzicky konzistentní a proto nemůže zadat primární roli.

  • 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 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 ConflictingSystemOperationInProgress – Probíhá operace údržby systému v databázi a další operace musí čekat na dokončení.

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

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

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

  • 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=2022-02-01-preview

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

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

InstanceFailoverGroup

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

Name Type Description
id
  • string

ID prostředku.

name
  • string

Název prostředku.

properties.managedInstancePairs

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

properties.partnerRegions

Informace o oblasti partnera 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í

type
  • string

Typ prostředku.

InstanceFailoverGroupReadOnlyEndpoint

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í

InstanceFailoverGroupReadWriteEndpoint

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.

InstanceFailoverGroupReplicationRole

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

Name Type Description
Primary
  • string
Secondary
  • string

ManagedInstancePairInfo

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

Name Type Description
partnerManagedInstanceId
  • string

ID partnerské spravované instance v páru.

primaryManagedInstanceId
  • string

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

PartnerRegionInfo

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

Name Type Description
location
  • string

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

replicationRole

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