Elastic Pools - List By Server

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

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

S volitelnými parametry:

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

HTTP

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

Java

/**
 * Samples for ElasticPools ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolListByServer.json
     */
    /**
     * Sample code: Get all elastic pools in a server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAllElasticPoolsInAServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().listByServer("sqlcrudtest-2369",
            "sqlcrudtest-8069", null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:

200

{
  "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.