Elastic Pools - Get

Service:

SQL Database

API Version:

2021-11-01

Rugalmas készletet kap.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
elasticPoolName	path	True	string	A rugalmas készlet neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Válaszok

Name	Típus	Description
200 OK	ElasticPool	Sikeres
Other Status Codes		Hibaválaszok: *** 400 ElasticPoolOverStorageUsage – Adatok írása egy adatbázisba, ha elérte a rugalmas készlet tárterületkorlátját. 400 InvalidSku – A felhasználó érvénytelen termékváltozatot adott meg. 400 InvalidTierSkuCombination – A megadott szint nem támogatja a megadott termékváltozatot. 400 ServerQuotaExceeded – A kiszolgáló elérte az engedélyezett adatbázis-átviteli egység korlátját. 400 ElasticPoolAlreadyExists – A kiszolgáló már tartalmaz egy rugalmas készletet a megadott névvel. 400 SubscriptionVcoreQuotaExceeded – Nem sikerült végrehajtani a műveletet, mert az előfizetés túllépné az engedélyezett virtuálismag-kvótát. 400 InvalidInputValueForEdition – A megadott kiadás nem támogatott a rugalmas készlet kiépítéséhez. 400 ElasticPoolDtuBelowLimit – A kért DTU-érték túl alacsony a kért rugalmas készlet szolgáltatási szintjéhez. 400 ElasticPoolDtuAboveLimit – A kért DTU-érték túl magas a kért rugalmas készlet szolgáltatási szintjéhez. 400 InvalidMaxSize – Érvénytelen maximális méret. 400 ElasticPoolDbDtuMaxBelowLimit – A kért adatbázisonkénti DTU-maximális érték túl alacsony a kért rugalmas készlet szolgáltatási szintjéhez. 400 ElasticPoolDbDtuMaxAboveLimit – A kért adatbázisonkénti DTU-maximális érték túl magas a kért rugalmas készlet szolgáltatási szintjéhez. 400 InvalidInputValueForDatabaseDtuMax – Az erőforráskészlet adatbázisonkénti DTU-maximális értékének megkísérlése, amely nem egyezik az engedélyezett értékekkel. 400 ElasticPoolDbDtuMinAboveLimit – A kért DTU-perc adatbázisonként túl magas a kért szolgáltatási szinthez. 400 ElasticPoolOverStorage – Adatok írása egy adatbázisba, ha elérte a rugalmas készlet tárterületkorlátját. 400 InvalidInputValueForDatabaseDtuMin – Az erőforráskészlet adatbázisonkénti DTU-percének megkísérlése, amely nem egyezik az engedélyezett értékekkel. 400 ElasticPoolInconsistentDtuGuaranteeSettings – A rugalmas készlet kért DTU-ját meghaladó, rugalmas készletben lévő adatbázisok DTU-jának megadása. 400 ElasticPoolDtuUnsupported – A felhasználó olyan rugalmas készletet próbált létrehozni vagy frissíteni, amely nem támogatott DTU-kapacitással rendelkezik. 400 ElasticPoolStorageAboveLimitGB – A rugalmas készlet tárterületkorlátjának beállítása a támogatott korlát alá. 400 ElasticPoolsNotEnabled – A rugalmas készletek nincsenek engedélyezve ebben a régióban. 400 ElasticPoolNotEmpty – Nem üres rugalmas készlet törlésének kérése. 400 ElasticPoolStorageBelowLimitGB – A rugalmas készlet tárterületkorlátjának beállítása a támogatott korlát alá. 400 ElasticPoolStorageNotAllowedGB – A rugalmas készlet tárterületkorlátjának gb-ban történő beállítása, amely nem egyezik meg az engedélyezett értékekkel. 400 ElasticPoolDatabaseLimit – A rugalmas készlet elérte az adatbázisok számára vonatkozó korlátot. 400 ElasticPoolDecreaseStorageLimitBelowUsage – A rugalmas készlet tárterületkorlátjának csökkentése a tárterület-használat alatt. 400 InvalidInputValueDatabaseDtuMinLargerThanMax – A DTU-perc adatbázisonkénti beállításának megkísérlése az adatbázisonkénti DTU-maximális értéknél magasabbra. 400 ElasticPoolInconsistentVcoreGuaranteeSettings – Az adatbázisok száma és a virtuális magok száma adatbázisonként nem haladhatja meg a rugalmas készlet kért virtuális magjainak számát. 400 ElasticPoolStorageBelowLimitMB – A rugalmas készlet tárterületkorlátjának beállítása a támogatott korlát alá. 400 ElasticPoolStorageNotAllowedMB – Megkísérli beállítani a rugalmas készlet tárterületkorlátját mb-ban, amely nem egyezik az engedélyezett értékekkel. 400 ElasticPoolCapacityStorageNotAllowedMB – Megkísérli beállítani a rugalmas készlet tárterületkorlátját mb-ban, amely nem egyezik az engedélyezett értékekkel. 400 ElasticPoolStorageAboveLimitMB – Megkísérli beállítani a rugalmas készlet tárterületkorlátját a támogatott korlát alá. 400 RegionDoesNotSupportVersion – Egy felhasználó olyan helyen kísérelt meg létrehozni egy adott verziójú kiszolgálót, ahol a kiszolgáló verziója nem támogatott. 400 InvalidTier – A felhasználó érvénytelen szintet adott meg. 400 SourceDatabaseEditionCouldNotBeUpgraded – A forrásadatbázis nem rendelkezhet magasabb kiadással, mint a céladatbázis. 400 TargetDatabaseEditionCouldNotBeDowngraded – A céladatbázis nem rendelkezhet alacsonyabb kiadással, mint a forrásadatbázis. 400 ElasticPoolUpdateHkNotAllowed – A rugalmas készlet nem tudja prémiumról Standardra vagy Alapszintűre csökkenteni a szolgáltatási szintjét, mivel egy vagy több adatbázisa memóriaoptimalizált objektumokat használ. 400 UpdateNotAllowedIfGeoDrOperationInProgress – A művelet nem engedélyezett, mert a(z) "{1}" kiszolgálón lévő adatbázis{0} másolási vagy feladatátvételi művelete folyamatban van. 400 RegionDoesNotAllowProvisioning – A kijelölt hely nem fogadja el az új Windows Azure SQL adatbázis-kiszolgálókat. Ez később változhat. 400 ElasticPoolOverFileSpace – Nincs elegendő fájlterület a rugalmas készletben. 400 ElasticPoolDbDtuMinBelowLimit – A kért adatbázisonkénti DTU-perc túl alacsony a kért rugalmas készlet szolgáltatási szintjéhez. 400 ElasticPoolDbVcoreMaxBelowLimit – A kért adatbázisonkénti virtuális mag maximális száma túl alacsony a kért rugalmas készlet szolgáltatási szintjéhez. 400 ElasticPoolDbVcoreMaxAboveLimit – A kért adatbázisonkénti virtuális mag maximális száma túl magas a kért rugalmas készlet szolgáltatási szintjéhez. 400 InvalidInputValueForDatabaseVcoreMax – Az erőforráskészlet adatbázisonkénti maximális virtuális magjának beállítása, amely nem egyezik az engedélyezett értékekkel. 400 ElasticPoolDbVcoreMinBelowLimit – A kért adatbázisonkénti virtuális mag minimális száma túl alacsony a kért rugalmas készlet szolgáltatási szintjéhez. 400 InvalidInputValueForDatabaseVcoreMin – Az erőforráskészlet adatbázisonkénti virtuálismag-percének megkísérlése, amely nem egyezik az engedélyezett értékekkel. 400 PartnerDBNotCompatibleForSGXEnclave – A GeoDR-kapcsolat beállítására vagy az SLO frissítésére tett kísérlet csak akkor támogatott, ha mindkét adatbázis DC sorozatú hardveren fut. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – Megkísérli adatbázisonként a virtuális mag minimális értékét az adatbázisonkénti virtuális mag maximális értékénél magasabbra állítani. 400 InvalidLicenseType – A felhasználó nem támogatott licenctípusú adatbázist vagy rugalmas készletet próbált létrehozni vagy frissíteni. 400 ProvisioningDisabled – Hibaüzenetet jelenít meg az erőforrásművelet-engedélyezőtől, ahogyan van, módosítások nélkül 400 InvalidPublicMaintenanceConfiguration – A felhasználó olyan nyilvános karbantartási konfigurációt próbált megadni, amely nem konvertálható belső azonosítóvá (helytelen formátumú vagy nem megfelelő régió). 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben. 404 ElasticPoolNotFound – A megadott rugalmas készlet nem létezik a megadott kiszolgálóhoz. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 404 ResourceNotFound – A kért erőforrás nem található. 405 Nem támogatott – Ez a funkció nem támogatott. 409 ElasticPoolBusy – Felügyeleti műveletet kíséreltek meg egy rugalmas készleten, amely foglalt. 409 ServerDisabled – A kiszolgáló le van tiltva. 409 SimultaneousSkuChangeNotAllowed – A szolgáltatási célkitűzés módosítási műveletei nem futtathatók egyszerre egy replikációs kapcsolat mindkét adatbázisán. 409 ElasticPoolUpdateLinksNotInCatchup – Nem frissíthető a rugalmas készlet, amíg az egyik adatbázisa másolási vagy georeplikációs feladatátvételi műveletet hajt végre. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 500 ElasticPoolFailedMoveDbToElasticPool – Belső erőforrás-korlátozások miatt nem sikerült áthelyezni az adatbázist a rugalmas készletbe. Ez átmeneti feltétel lehet, próbálkozzon újra. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 ServiceTemporarilyUnavailable – A szolgáltatás átmenetileg nem érhető el. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Get a Hyperscale elastic pool

Get an elastic pool

Get a Hyperscale elastic pool

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ElasticPools Get. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/HyperscaleElasticPoolGet.json
     */
    /**
     * Sample code: Get a Hyperscale elastic pool.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAHyperscaleElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().getWithResponse("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", 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

Sample Response

Status code:

200

{
  "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": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}

Get an elastic pool

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ElasticPools Get. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolGet.json
     */
    /**
     * Sample code: Get an elastic pool.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAnElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().getWithResponse("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", 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

Sample Response

Status code:

200

{
  "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": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Definíciók

Name	Description
ElasticPool	Egy rugalmas készlet.
ElasticPoolLicenseType	A rugalmas készletre alkalmazandó licenctípus.
ElasticPoolPerDatabaseSettings	Rugalmas készlet adatbázis-beállításai szerint.
ElasticPoolState	A rugalmas készlet állapota.
Sku	ARM-erőforrás-termékváltozat.

ElasticPool

Egy rugalmas készlet.

Name	Típus	Description
id	string	Erőforrás-azonosító.
kind	string	A rugalmas készlet típusa. Ez a Azure Portal élményhez használt metaadatok.
location	string	Erőforrás helye.
name	string	Erőforrás neve.
properties.creationDate	string	A rugalmas készlet létrehozási dátuma (ISO8601 formátum).
properties.highAvailabilityReplicaCount	integer	A rugalmas készlethez társított másodlagos replikák száma, amelyek magas rendelkezésre állást biztosítanak. Csak rugalmas skálázású rugalmas készletekre alkalmazható.
properties.licenseType	ElasticPoolLicenseType	A rugalmas készletre alkalmazandó licenctípus.
properties.maintenanceConfigurationId	string	A rugalmas készlethez rendelt karbantartási konfiguráció azonosítója. Ez a konfiguráció határozza meg a karbantartási frissítések bekövetkezési idejét.
properties.maxSizeBytes	integer	Az adatbázis rugalmas készletének tárterületkorlátja bájtban.
properties.minCapacity	number	Minimális kapacitás, amelyet a kiszolgáló nélküli készlet nem zsugorodik alább, ha nincs szüneteltetve
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	A rugalmas készlet adatbázisonkénti beállításai.
properties.state	ElasticPoolState	A rugalmas készlet állapota.
properties.zoneRedundant	boolean	Azt jelzi, hogy ez a rugalmas készlet zónaredundáns-e, ami azt jelenti, hogy a rugalmas készlet replikái több rendelkezésre állási zónában lesznek elosztva.
sku	Sku	A rugalmas készlet termékváltozata. A termékváltozatok listája régiónként és támogatási ajánlatonként változhat. Az Előfizetéséhez egy Azure-régióban elérhető termékváltozatok (beleértve a termékváltozat nevét, szintjét/kiadását, családját és kapacitását) meghatározásához használja a Capabilities_ListByLocation REST API-t vagy a következő parancsot: az sql elastic-pool list-editions -l <location> -o table
tags	object	Erőforráscímkék.
type	string	Erőforrástípus.

ElasticPoolLicenseType

A rugalmas készletre alkalmazandó licenctípus.

Name	Típus	Description
BasePrice	string
LicenseIncluded	string

ElasticPoolPerDatabaseSettings

Rugalmas készlet adatbázis-beállításai szerint.

Name	Típus	Description
maxCapacity	number	Egy adatbázis maximális kapacitása.
minCapacity	number	Az összes adatbázis minimális kapacitása garantált.

ElasticPoolState

A rugalmas készlet állapota.

Name	Típus	Description
Creating	string
Disabled	string
Ready	string

Sku

ARM-erőforrás-termékváltozat.

Name	Típus	Description
capacity	integer	Az adott termékváltozat kapacitása.
family	string	Ha a szolgáltatás eltérő hardvergenerációval rendelkezik ugyanahhoz a termékváltozathoz, akkor az itt rögzíthető.
name	string	A termékváltozat neve, általában egy betű + szám kód, például P3.
size	string	Az adott termékváltozat mérete
tier	string	Az adott termékváltozat szintje vagy kiadása, például Alapszintű, Prémium.