Elastic Pools - List By Server

Pobiera wszystkie elastyczne pule na serwerze.

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

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True

string

Wersja interfejsu API do użycia dla żądania.

$skip
query

integer

int64

Liczba elementów w kolekcji do pominięcia.

Odpowiedzi

Nazwa Typ Opis
200 OK

ElasticPoolListResult

Powodzenie

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 ElasticPoolOverStorageUsage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu puli elastycznej.

  • 400 InvalidSku — użytkownik określił nieprawidłową jednostkę SKU.

  • 400 InvalidTierSkuCombination — określona warstwa nie obsługuje określonej jednostki SKU.

  • 400 ServerQuotaExceeded — serwer osiągnął limit dozwolonej jednostki przepływności bazy danych.

  • 400 ElasticPoolAlreadyExists — serwer zawiera już elastyczną pulę o określonej nazwie.

  • 400 SubscriptionVcoreQuotaExceeded — nie można wykonać operacji, ponieważ subskrypcja przekroczy dozwolony limit przydziału rdzeni wirtualnych.

  • 400 InvalidInputValueForEdition — określona wersja nie jest obsługiwana w przypadku aprowizacji puli elastycznej.

  • 400 ElasticPoolDtuBelowLimit — żądana wartość jednostki DTU jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDtuAboveLimit — żądana wartość jednostki DTU jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidMaxSize — nieprawidłowy maksymalny rozmiar.

  • 400 ElasticPoolDbDtuMaxBelowLimit — żądana maksymalna liczba jednostek DTU bazy danych jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbDtuMaxAboveLimit — żądana maksymalna liczba jednostek DTU bazy danych jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseDtuMax — próba ustawienia maksymalnej liczby jednostek DTU dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolDbDtuMinAboveLimit — żądana minimalna liczba jednostek DTU na bazę danych jest zbyt wysoka dla żądanej warstwy usługi.

  • 400 ElasticPoolOverStorage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu elastycznej puli.

  • 400 InvalidInputValueForDatabaseDtuMin — próba ustawienia wartości DTU min na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings — próba podania wartości DTU min dla baz danych w puli elastycznej, która przekracza żądane jednostki DTU puli elastycznej.

  • 400 ElasticPoolDtuUnsupported — użytkownik próbował utworzyć lub zaktualizować elastyczną pulę z pojemnością jednostki DTU, która nie jest obsługiwana.

  • 400 ElasticPoolStorageAboveLimitGB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolsNotEnabled — pule elastyczne nie zostały włączone w tym regionie.

  • 400 ElasticPoolNotEmpty — żądanie usunięcia puli elastycznej, która nie jest pusta.

  • 400 ElasticPoolStorageBelowLimitGB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolStorageNotAllowedGB — próba ustawienia limitu magazynu elastycznej puli w gb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolDatabaseLimit — pula elastyczna osiągnęła limit liczby baz danych.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage — próba zmniejszenia limitu magazynu puli elastycznej poniżej użycia magazynu.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax — próba ustawienia wartości minimalnej jednostki DTU na bazę danych wyższą niż maksymalna liczba jednostek DTU na bazę danych.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings — liczba baz danych i minimalna liczba rdzeni wirtualnych na bazę danych nie może przekraczać żądanych rdzeni wirtualnych puli elastycznej.

  • 400 ElasticPoolStorageBelowLimitMB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolStorageNotAllowedMB — próba ustawienia limitu magazynu elastycznej puli w mb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolCapacityStorageNotAllowedMB — próba ustawienia limitu magazynu elastycznej puli w mb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolStorageAboveLimitMB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana.

  • 400 InvalidTier — użytkownik określił nieprawidłową warstwę.

  • 400 SourceDatabaseEditionCouldNotBe Upgrade — źródłowa baza danych nie może mieć wyższej wersji niż docelowa baza danych.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded — docelowa baza danych nie może mieć niższej wersji niż źródłowa baza danych.

  • 400 ElasticPoolUpdateHkNotAllowed — pula elastyczna nie może obniżyć warstwy usługi z warstwy Premium do Warstwy Standardowa lub Podstawowa, ponieważ co najmniej jedna z jej baz danych używa obiektów zoptymalizowanych pod kątem pamięci.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress — operacja jest niedozwolona, ponieważ operacja kopiowania lub trybu failover dla bazy danych "" na serwerze "{0}{1}" jest obecnie w toku.

  • 400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów usługi Windows Azure SQL Database. Może to ulec zmianie w późniejszym czasie.

  • 400 ElasticPoolOverFileSpace — niewystarczająca ilość miejsca na plikach w elastycznej puli.

  • 400 ElasticPoolDbDtuMinBelowLimit — żądana liczba jednostek DTU bazy danych jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbVcoreMaxBelowLimit — żądana maksymalna liczba rdzeni wirtualnych bazy danych jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbVcoreMaxAboveLimit — żądana maksymalna liczba rdzeni wirtualnych bazy danych jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseVcoreMax — próba ustawienia maksymalnej liczby rdzeni wirtualnych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolDbVcoreMinBelowLimit — żądana minimalna liczba rdzeni wirtualnych bazy danych jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseVcoreMin — próbuje ustawić minimalną liczbę rdzeni wirtualnych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 PartnerDBNotCompatibleForSGXEnclave — próba ustawienia linku GeoDR lub aktualizacji slo dla bazy danych z włączoną enklawą jest obsługiwana tylko wtedy, gdy obie bazy danych są uruchomione na sprzęcie serii DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax — próbuje ustawić minimalną liczbę rdzeni wirtualnych na bazę danych większą niż maksymalna liczba rdzeni wirtualnych na bazę danych.

  • 400 InvalidLicenseType — użytkownik próbował utworzyć lub zaktualizować bazę danych lub elastyczną pulę z nieobsługiwanym typem licencji.

  • 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów, tak jak to jest, bez zmian

  • 400 InvalidPublicMaintenanceConfiguration — użytkownik próbował określić konfigurację konserwacji publicznej, której nie można przekonwertować na identyfikator wewnętrzny (źle sformułowany lub nieprawidłowy region).

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 ElasticPoolNotFound — określona pula elastyczna nie istnieje dla określonego serwera.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 405 Nieobsługiwane — ta funkcja nie jest obsługiwana.

  • 409 ElasticPoolBusy — operacja zarządzania została podjęta w puli elastycznej, która jest zajęta.

  • 409 ServerDisabled — serwer jest wyłączony.

  • 409 RównoczesneSkuChangeNotAllowed — operacje zmiany celu usługi nie mogą być uruchamiane w obu bazach danych relacji replikacji jednocześnie.

  • 409 ElasticPoolUpdateLinksNotInCatchup — nie można zaktualizować elastycznej puli, podczas gdy jedna z jej baz danych wykonuje operację kopiowania lub trybu failover replikacji geograficznej.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 500 ElasticPoolFailedMoveDbToElasticPool — nie można przenieść bazy danych do puli elastycznej z powodu ograniczeń zasobów wewnętrznych. Może to być stan przejściowy. Ponów próbę.

  • 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji.

  • 503 ServiceTemporarilyUnavailable — funkcja jest tymczasowo niedostępna.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

Nazwa Opis
ElasticPool

Elastyczna pula.

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

ElasticPoolListResult

Wynik żądania listy elastycznej puli.

ElasticPoolPerDatabaseSettings

Na ustawienia bazy danych elastycznej puli.

ElasticPoolState

Stan elastycznej puli.

Sku

Jednostka SKU zasobu usługi ARM.

ElasticPool

Elastyczna pula.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

kind

string

Rodzaj elastycznej puli. Są to metadane używane w środowisku Azure Portal.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.creationDate

string

Data utworzenia elastycznej puli (format ISO8601).

properties.highAvailabilityReplicaCount

integer

Liczba replik pomocniczych skojarzonych z elastyczną pulą, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala.

properties.licenseType

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

properties.maintenanceConfigurationId

string

Identyfikator konfiguracji konserwacji przypisany do puli elastycznej. Ta konfiguracja definiuje okres, w których będą wykonywane aktualizacje konserwacji.

properties.maxSizeBytes

integer

Limit magazynu dla elastycznej puli bazy danych w bajtach.

properties.minCapacity

number

Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Ustawienia poszczególnych baz danych dla elastycznej puli.

properties.state

ElasticPoolState

Stan elastycznej puli.

properties.zoneRedundant

boolean

Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności.

sku

Sku

Jednostka SKU puli elastycznej.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub następującego polecenia:

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

object

Tagi zasobów.

type

string

Typ zasobu.

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

Nazwa Typ Opis
BasePrice

string

LicenseIncluded

string

ElasticPoolListResult

Wynik żądania listy elastycznej puli.

Nazwa Typ Opis
nextLink

string

Link, aby pobrać następną stronę wyników.

value

ElasticPool[]

Tablica wyników.

ElasticPoolPerDatabaseSettings

Na ustawienia bazy danych elastycznej puli.

Nazwa Typ Opis
maxCapacity

number

Maksymalna pojemność, jaką może zużyć dowolna baza danych.

minCapacity

number

Minimalna pojemność wszystkich baz danych jest gwarantowana.

ElasticPoolState

Stan elastycznej puli.

Nazwa Typ Opis
Creating

string

Disabled

string

Ready

string

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa Typ Opis
capacity

integer

Pojemność określonej jednostki SKU.

family

string

Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.

name

string

Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.

size

string

Rozmiar określonej jednostki SKU

tier

string

Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.