Sdílet prostřednictvím


Elastic Pools - List By Server

Získá všechny elastické fondy na serveru.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools?$skip={$skip}&api-version=2021-11-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
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.

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.

$skip
query

integer

int64

Počet prvků v kolekci, které se mají přeskočit.

Odpovědi

Name Typ Description
200 OK

ElasticPoolListResult

Úspěšný

Other Status Codes

Chybové odpovědi: ***

  • 400 ElasticPoolOverStorageUsage – pokus o zápis dat do databáze při dosažení limitu úložiště elastického fondu.

  • 400 InvalidSku – uživatel zadal neplatnou skladovou položku.

  • 400 InvalidTierSkuCombination – zadaná úroveň nepodporuje zadanou skladovou položku.

  • 400 ServerQuotaExceeded – server dosáhl svého limitu povolené jednotky propustnosti databáze.

  • 400 ElasticPoolAlreadyExists – server již obsahuje elastický fond se zadaným názvem.

  • 400 SubscriptionVcoreQuotaExceeded – Operaci nelze provést, protože předplatné by překročilo povolenou kvótu virtuálních jader.

  • 400 InvalidInputValueForEdition – Zadaná edice se nepodporuje pro zřizování elastického fondu.

  • 400 ElasticPoolDtuBelowLimit – požadovaná hodnota DTU je pro požadovanou úroveň služby elastického fondu příliš nízká.

  • 400 ElasticPoolDtuAboveLimit – požadovaná hodnota DTU je pro požadovanou úroveň služby elastického fondu příliš vysoká.

  • 400 InvalidMaxSize – neplatná maximální velikost.

  • 400 ElasticPoolDbDtuMaxBelowLimit – požadovaná maximální hodnota DTU na databázi je pro požadovanou úroveň služby elastického fondu příliš nízká.

  • 400 ElasticPoolDbDtuMaxAboveLimit – požadovaná maximální hodnota DTU na databázi je pro požadovanou úroveň služby elastického fondu příliš vysoká.

  • 400 InvalidInputValueForDatabaseDtuMax – Pokus o nastavení maximálního počtu DTU na databázi pro fond zdrojů, který neodpovídá povoleným hodnotám.

  • 400 ElasticPoolDbDtuMinAboveLimit – požadovaná minimální hodnota DTU na databázi je pro požadovanou úroveň služby příliš vysoká.

  • 400 ElasticPoolOverStorage – pokus o zápis dat do databáze při dosažení limitu úložiště elastického fondu.

  • 400 InvalidInputValueForDatabaseDtuMin – Pokus o nastavení minimální hodnoty DTU na databázi pro fond zdrojů, který neodpovídá povoleným hodnotám.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings – Pokus o poskytnutí minimální hodnoty DTU pro databáze v elastickém fondu, které překračují požadované jednotky DTU elastického fondu.

  • 400 ElasticPoolDtuUnsupported – Uživatel se pokusil vytvořit nebo aktualizovat elastický fond s kapacitou DTU, která není podporovaná.

  • 400 ElasticPoolStorageAboveLimitGB – pokus o nastavení limitu úložiště elastického fondu pod podporovaný limit.

  • 400 ElasticPoolsNotEnabled – Elastické fondy nejsou v této oblasti povolené.

  • 400 ElasticPoolNotEmpty – žádost o odstranění elastického fondu, který není prázdný.

  • 400 ElasticPoolStorageBelowLimitGB – pokus o nastavení limitu úložiště elastického fondu pod podporovaný limit.

  • 400 ElasticPoolStorageNotAllowedGB – pokus o nastavení limitu úložiště elastického fondu v GB, který neodpovídá povoleným hodnotám.

  • 400 ElasticPoolDatabaseLimit – elastický fond dosáhl limitu počtu databází.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage – Pokus o snížení limitu úložiště elastického fondu pod jeho využití úložiště.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax – pokus o nastavení minimální hodnoty DTU na databázi vyšší než maximální hodnota DTU na databázi.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings – počet databází a minimální počet virtuálních jader na databázi nesmí překročit požadovaná virtuální jádra elastického fondu.

  • 400 ElasticPoolStorageBelowLimitMB – pokus o nastavení limitu úložiště elastického fondu pod podporovaný limit.

  • 400 ElasticPoolStorageNotAllowedMB – pokus o nastavení limitu úložiště elastického fondu v MB, který neodpovídá povoleným hodnotám.

  • 400 ElasticPoolCapacityStorageNotAllowedMB – pokus o nastavení limitu úložiště elastického fondu v MB, který neodpovídá povoleným hodnotám.

  • 400 ElasticPoolStorageAboveLimitMB – pokus o nastavení limitu úložiště elastického fondu pod podporovaný limit.

  • 400 RegionDoesNotSupportVersion – uživatel se pokusil vytvořit server zadané verze v umístění, kde se tato verze serveru nepodporuje.

  • 400 InvalidTier – uživatel zadal neplatnou úroveň.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded – zdrojová databáze nemůže mít vyšší edici než cílová databáze.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded – cílová databáze nemůže mít nižší edici než zdrojová databáze.

  • 400 ElasticPoolUpdateHkNotAllowed – elastický fond nemůže snížit úroveň služby z Úrovně Premium na Standard nebo Basic, protože jedna nebo více jeho databází používá objekty optimalizované pro paměť.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress – operace je zakázána, protože právě probíhá operace kopírování nebo převzetí služeb při selhání databáze{0} na serveru{1}.

  • 400 RegionDoesNotAllowProvisioning – vybrané umístění nepřijímá nové databázové servery windows Azure SQL. To se může později změnit.

  • 400 ElasticPoolOverFileSpace – nedostatek místa v souboru v elastickém fondu.

  • 400 ElasticPoolDbDtuMinBelowLimit – minimální požadovaná hodnota DTU pro databázi je pro požadovanou úroveň služby elastického fondu příliš nízká.

  • 400 ElasticPoolDbVcoreMaxBelowLimit – požadovaný maximální počet virtuálních jader na databázi je pro požadovanou úroveň služby elastického fondu příliš nízký.

  • 400 ElasticPoolDbVcoreMaxAboveLimit – požadovaný maximální počet virtuálních jader na databázi je pro požadovanou úroveň služby elastického fondu příliš vysoký.

  • 400 InvalidInputValueForDatabaseVcoreMax – Pokus o nastavení maximálního počtu virtuálních jader na databázi pro fond zdrojů, který neodpovídá povoleným hodnotám.

  • 400 ElasticPoolDbVcoreMinBelowLimit – minimální požadovaná hodnota virtuálního jádra pro databázi je pro požadovanou úroveň služby elastického fondu příliš nízká.

  • 400 InvalidInputValueForDatabaseVcoreMin – Pokus o nastavení minimálního počtu virtuálních jader na databázi pro fond zdrojů, který neodpovídá povoleným hodnotám.

  • 400 PartnerDBNotCompatibleForSGXEnclave – Pokus o nastavení propojení GeoDR nebo aktualizace SLO pro databázi s povolenou enklávou je podporován pouze v případě, že obě databáze běží na hardwaru řady DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – Pokouší se nastavit minimální počet virtuálních jader na databázi vyšší než maximální počet virtuálních jader na databázi.

  • 400 InvalidLicenseType – uživatel se pokusil vytvořit nebo aktualizovat databázi nebo elastický fond s nepodporovaným typem licence.

  • 400 ProvisioningDisabled – zobrazí chybovou zprávu z operace prostředků authorizer tak, jak je, beze změn.

  • 400 InvalidPublicMaintenanceConfiguration – Uživatel se pokusil zadat konfiguraci veřejné údržby, kterou nelze převést na interní ID (poškozenou nebo nesprávnou oblast).

  • 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen.

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

  • 404 ElasticPoolNotFound – zadaný elastický fond neexistuje pro zadaný server.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 405 NotSupported –Tato funkce není podporovaná.

  • 409 ElasticPoolBusy – došlo k pokusu o operaci správy v elastickém fondu, který je zaneprázdněn.

  • 409 ServerDisabled – Server je zakázaný.

  • 409 SimultaneousSkuChangeNotAllowed – Operace změny cíle služby nelze spustit v obou databázích vztahu replikace současně.

  • 409 ElasticPoolUpdateLinksNotInCatchup – Elastický fond nejde aktualizovat, když jedna z jeho databází provádí operaci kopírování nebo geografické replikace převzetí služeb při selhání.

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

  • 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 ElasticPoolFailedMoveDbToElasticPool – Kvůli interním omezením prostředků se nepodařilo přesunout databázi do elastického fondu. Může se jednat o přechodný stav. Zkuste to prosím znovu.

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

  • 503 ServiceTemporarilyUnavailable – Funkce je dočasně nedostupná.

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

Příklady

Get all elastic pools in a server

Ukázkový požadavek

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools?api-version=2021-11-01

Ukázková odpověď

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-2729",
      "name": "sqlcrudtest-2729",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "GP_Gen4_2",
        "tier": "GeneralPurpose",
        "capacity": 2
      },
      "properties": {
        "creationDate": "2017-02-10T01:27:21.32Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0.25,
          "maxCapacity": 1
        },
        "zoneRedundant": true,
        "licenseType": "LicenseIncluded"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-3191",
      "name": "sqlcrudtest-3191",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:26:26.45Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
      "name": "sqlcrudtest-8102",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:25:25.033Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    }
  ]
}

Definice

Name Description
ElasticPool

Elastický fond.

ElasticPoolLicenseType

Typ licence, který se má použít pro tento elastický fond.

ElasticPoolListResult

Výsledek žádosti o seznam elastického fondu.

ElasticPoolPerDatabaseSettings

Nastavení elastického fondu podle databáze.

ElasticPoolState

Stav elastického fondu.

Sku

Skladová položka prostředku ARM.

ElasticPool

Elastický fond.

Name Typ Description
id

string

ID prostředku.

kind

string

Druh elastického fondu. Toto jsou metadata používaná pro Azure Portal prostředí.

location

string

Umístění prostředku.

name

string

Název prostředku.

properties.creationDate

string

Datum vytvoření elastického fondu (formát ISO8601).

properties.highAvailabilityReplicaCount

integer

Počet sekundárních replik přidružených k elastickému fondu, které se používají k zajištění vysoké dostupnosti. Platí jenom pro elastické fondy Hyperscale.

properties.licenseType

ElasticPoolLicenseType

Typ licence, který se má použít pro tento elastický fond.

properties.maintenanceConfigurationId

string

ID konfigurace údržby přiřazené elastickému fondu. Tato konfigurace definuje období, kdy budou probíhat aktualizace údržby.

properties.maxSizeBytes

integer

Limit úložiště pro elastický fond databáze v bajtech.

properties.minCapacity

number

Minimální kapacita, pod kterou se bezserverový fond nezmenší, pokud není pozastavený

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Nastavení elastického fondu podle databáze.

properties.state

ElasticPoolState

Stav elastického fondu.

properties.zoneRedundant

boolean

Jestli je tento elastický fond zónově redundantní, to znamená, že repliky tohoto elastického fondu budou rozložené do několika zón dostupnosti.

sku

Sku

Skladová položka elastického fondu

Seznam skladových položek se může lišit podle oblasti a nabídky podpory. Pokud chcete zjistit skladové položky (včetně názvu skladové položky, úrovně/edice, řady a kapacity), které jsou dostupné pro vaše předplatné v oblasti Azure, použijte Capabilities_ListByLocation rozhraní REST API nebo následující příkaz:

az sql elastic-pool list-editions -l <location> -o table
tags

object

Značky prostředků.

type

string

Typ prostředku.

ElasticPoolLicenseType

Typ licence, který se má použít pro tento elastický fond.

Name Typ Description
BasePrice

string

LicenseIncluded

string

ElasticPoolListResult

Výsledek žádosti o seznam elastického fondu.

Name Typ Description
nextLink

string

Odkaz na načtení další stránky výsledků

value

ElasticPool[]

Pole výsledků

ElasticPoolPerDatabaseSettings

Nastavení elastického fondu podle databáze.

Name Typ Description
maxCapacity

number

Maximální kapacita, kterou může spotřebovat jedna databáze.

minCapacity

number

Minimální kapacita všech databází je zaručena.

ElasticPoolState

Stav elastického fondu.

Name Typ Description
Creating

string

Disabled

string

Ready

string

Sku

Skladová položka prostředku ARM.

Name Typ Description
capacity

integer

Kapacita konkrétní skladové položky.

family

string

Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete to tady zaznamenat.

name

string

Název skladové položky, obvykle písmeno + číselný kód, např. P3.

size

string

Velikost konkrétní skladové položky

tier

string

Úroveň nebo edice konkrétní skladové položky, například Basic, Premium.