Elastic Pools - List By Server

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

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

Z parametrami opcjonalnymi:

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

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.