Dela via


Elastic Pools - List By Server

Hämtar alla elastiska pooler på en server.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Prenumerations-ID:t som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

$skip
query

integer

int64

Antalet element i samlingen som ska hoppa över.

Svar

Name Typ Description
200 OK

ElasticPoolListResult

Lyckades

Other Status Codes

Felsvar: ***

  • 400 ElasticPoolOverStorageUsage – Försöker skriva data till en databas när lagringsgränsen för den elastiska poolen har nåtts.

  • 400 InvalidSku – Användaren har angett en ogiltig SKU.

  • 400 InvalidTierSkuCombination – Den angivna nivån stöder inte angiven sku.

  • 400 ServerQuotaExceeded – Servern har nått sin gräns för tillåten databasflödesenhet.

  • 400 ElasticPoolAlreadyExists – Servern innehåller redan en elastisk pool med det angivna namnet.

  • 400 SubscriptionVcoreQuotaExceeded – Det gick inte att utföra åtgärden eftersom prenumerationen skulle överskrida den tillåtna kvoten för virtuell kärna.

  • 400 InvalidInputValueForEdition – den angivna utgåvan stöds inte för etablering av elastisk pool.

  • 400 ElasticPoolDtuBelowLimit – det begärda DTU-värdet är för lågt för den begärda elastiska pooltjänstnivån.

  • 400 ElasticPoolDtuAboveLimit – det begärda DTU-värdet är för högt för den begärda elastiska pooltjänstnivån.

  • 400 InvalidMaxSize – ogiltig maxstorlek.

  • 400 ElasticPoolDbDtuMaxBelowLimit – det begärda DTU-maxvärdet per databas är för lågt för den begärda elastiska pooltjänstnivån.

  • 400 ElasticPoolDbDtuMaxAboveLimit – det begärda DTU-maxvärdet per databas är för högt för den begärda tjänstnivån för elastisk pool.

  • 400 InvalidInputValueForDatabaseDtuMax – Försöker ange DTU:ens maxvärde per databas för resurspoolen som inte matchar de tillåtna värdena.

  • 400 ElasticPoolDbDtuMinAboveLimit – den begärda DTU:en min per databas är för hög för den begärda tjänstnivån.

  • 400 ElasticPoolOverStorage – Försöker skriva data till en databas när lagringsgränsen för den elastiska poolen har nåtts.

  • 400 InvalidInputValueForDatabaseDtuMin – Försöker ange DTU:en min per databas för resurspoolen som inte matchar de tillåtna värdena.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings – Försöker ange DTU min för databaser i den elastiska poolen som överskrider begärda DTU:er för den elastiska poolen.

  • 400 ElasticPoolDtuUnsupported – Användaren försökte skapa eller uppdatera en elastisk pool med en DTU-kapacitet som inte stöds.

  • 400 ElasticPoolStorageAboveLimitGB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds.

  • 400 ElasticPoolsNotEnabled – Elastiska pooler har inte aktiverats i den här regionen.

  • 400 ElasticPoolNotEmpty – Begäran om att ta bort en elastisk pool som inte är tom.

  • 400 ElasticPoolStorageBelowLimitGB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds.

  • 400 ElasticPoolStorageNotAllowedGB – Försöker ange den elastiska poollagringsgränsen i GB som inte matchar de tillåtna värdena.

  • 400 ElasticPoolDatabaseLimit – Den elastiska poolen har nått sin gräns för antalet databaser.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage – Försöker minska lagringsgränsen för den elastiska poolen under dess lagringsanvändning.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax – Försöker ställa in DTU min per databas högre än DTU-maxvärdet per databas.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings – Antalet databaser och virtuella kärnor min per databas får inte överskrida begärda virtuella kärnor i den elastiska poolen.

  • 400 ElasticPoolStorageBelowLimitMB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds.

  • 400 ElasticPoolStorageNotAllowedMB – Försöker ange lagringsgränsen för elastisk pool i MB som inte matchar de tillåtna värdena.

  • 400 ElasticPoolCapacityStorageNotAllowedMB – Försöker ange lagringsgränsen för elastisk pool i MB som inte matchar de tillåtna värdena.

  • 400 ElasticPoolStorageAboveLimitMB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds.

  • 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds.

  • 400 InvalidTier – Användaren har angett en ogiltig nivå.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded – Källdatabasen får inte ha en högre utgåva än måldatabasen.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded – Måldatabasen får inte ha en lägre utgåva än källdatabasen.

  • 400 ElasticPoolUpdateHkNotAllowed – Den elastiska poolen kan inte sänka tjänstnivån från Premium till Standard eller Basic eftersom en eller flera av databaserna använder minnesoptimerade objekt.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress – Åtgärden tillåts inte eftersom kopierings- eller redundansåtgärd för databasen på{0} servern{1} pågår.

  • 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database-servrar. Detta kan ändras vid ett senare tillfälle.

  • 400 ElasticPoolOverFileSpace – Otillräckligt filutrymme i den elastiska poolen.

  • 400 ElasticPoolDbDtuMinBelowLimit – den begärda DTU-min per databas är för låg för den begärda tjänstnivån för elastisk pool.

  • 400 ElasticPoolDbVcoreMaxBelowLimit – det begärda maxvärdet per databas för virtuell kärna är för lågt för den begärda tjänstnivån för elastisk pool.

  • 400 ElasticPoolDbVcoreMaxAboveLimit – det begärda maxvärdet per databas för virtuell kärna är för högt för den begärda tjänstnivån för elastisk pool.

  • 400 InvalidInputValueForDatabaseVcoreMax – Försöker ange maxvärdet för virtuell kärna per databas för resurspoolen som inte matchar de tillåtna värdena.

  • 400 ElasticPoolDbVcoreMinBelowLimit – den begärda virtuella kärnan per databas min är för låg för den begärda tjänstnivån för elastisk pool.

  • 400 InvalidInputValueForDatabaseVcoreMin – Försöker ange den virtuella kärnan min per databas för resurspoolen som inte matchar de tillåtna värdena.

  • 400 PartnerDBNotCompatibleForSGXEnclave – Försök att ange GeoDR-länk eller uppdatera SLO för enklavaktiverad databas stöds bara när båda databaserna körs på dc-seriens maskinvara.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – Försöker ange den virtuella kärnan min per databas som är högre än det högsta antalet virtuella kärnor per databas.

  • 400 InvalidLicenseType – Användaren försökte skapa eller uppdatera en databas eller elastisk pool med en licenstyp som inte stöds.

  • 400 ProvisioningDisabled – visar felmeddelandet från resursåtgärden authorizer som den är, utan ändringar

  • 400 InvalidPublicMaintenanceConfiguration – Användaren försökte ange konfigurationen för offentligt underhåll som inte kan konverteras till internt ID (felaktigt eller fel region).

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 ElasticPoolNotFound – den angivna elastiska poolen finns inte för den angivna servern.

  • 404 OperationIdNotFound – åtgärden med ID finns inte.

  • 405 NotSupported – den här funktionen stöds inte.

  • 409 ElasticPoolBusy – ett hanteringsförsök gjordes på en elastisk pool som är upptagen.

  • 409 ServerDisabled – Servern är inaktiverad.

  • 409 SimultaneousSkuChangeNotAllowed – Ändringsåtgärder för tjänstmål kan inte köras på båda databaserna i en replikeringsrelation samtidigt.

  • 409 ElasticPoolUpdateLinksNotInCatchup – Det går inte att uppdatera elastisk pool när en av databaserna utför en redundansåtgärd för kopiering eller geo-replikering.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 500 ElasticPoolFailedMoveDbToElasticPool – Det gick inte att flytta databasen till elastisk pool på grund av interna resursbegränsningar. Detta kan vara ett tillfälligt villkor. Försök igen.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen.

  • 503 ServiceTemporarilyUnavailable – Funktionen är inte tillgänglig för tillfället.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Get all elastic pools in a server

Sample Request

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

Sample Response

{
  "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
        }
      }
    }
  ]
}

Definitioner

Name Description
ElasticPool

En elastisk pool.

ElasticPoolLicenseType

Licenstypen som ska gälla för den här elastiska poolen.

ElasticPoolListResult

Resultatet av en begäran om en lista över elastiska pooler.

ElasticPoolPerDatabaseSettings

Per databasinställningar för en elastisk pool.

ElasticPoolState

Status för den elastiska poolen.

Sku

En ARM-resurs-SKU.

ElasticPool

En elastisk pool.

Name Typ Description
id

string

Resurs-ID.

kind

string

Typ av elastisk pool. Det här är metadata som används för Azure Portal upplevelse.

location

string

Resursplats.

name

string

Resursnamn.

properties.creationDate

string

Skapandedatumet för den elastiska poolen (ISO8601 format).

properties.highAvailabilityReplicaCount

integer

Antalet sekundära repliker som är associerade med den elastiska poolen som används för att tillhandahålla hög tillgänglighet. Gäller endast för elastiska pooler i Hyperskala.

properties.licenseType

ElasticPoolLicenseType

Licenstypen som ska gälla för den här elastiska poolen.

properties.maintenanceConfigurationId

string

Underhållskonfigurations-ID som tilldelats den elastiska poolen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.

properties.maxSizeBytes

integer

Lagringsgränsen för databasens elastiska pool i byte.

properties.minCapacity

number

Minimal kapacitet som den serverlösa poolen inte krymper under, om den inte är pausad

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Inställningarna per databas för den elastiska poolen.

properties.state

ElasticPoolState

Status för den elastiska poolen.

properties.zoneRedundant

boolean

Oavsett om den här elastiska poolen är zonredundant eller inte, vilket innebär att replikerna i den elastiska poolen sprids över flera tillgänglighetszoner.

sku

Sku

SKU:n för elastisk pool.

Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure-region använder Capabilities_ListByLocation du REST-API:et eller följande kommando:

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

object

Resurstaggar.

type

string

Resurstyp.

ElasticPoolLicenseType

Licenstypen som ska gälla för den här elastiska poolen.

Name Typ Description
BasePrice

string

LicenseIncluded

string

ElasticPoolListResult

Resultatet av en begäran om en lista över elastiska pooler.

Name Typ Description
nextLink

string

Länk för att hämta nästa sida med resultat.

value

ElasticPool[]

Matris med resultat.

ElasticPoolPerDatabaseSettings

Per databasinställningar för en elastisk pool.

Name Typ Description
maxCapacity

number

Den maximala kapaciteten som en databas kan använda.

minCapacity

number

Den minsta kapaciteten som alla databaser garanteras.

ElasticPoolState

Status för den elastiska poolen.

Name Typ Description
Creating

string

Disabled

string

Ready

string

Sku

En ARM-resurs-SKU.

Name Typ Description
capacity

integer

Kapacitet för den specifika SKU:n.

family

string

Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.

name

string

Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.

size

string

Storleken på den specifika SKU:n

tier

string

Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.