Elastic Pools - Get

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Pobiera elastyczną pulę.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
elasticPoolName	path	True	string	Nazwa elastycznej puli.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager 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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ElasticPool	Powodzenie
Other Status Codes		Odpowiedzi na błędy: *** 400 ElasticPoolOverStorageUsage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu elastycznej puli. 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 dozwolonych jednostek przepływności bazy danych. 400 ElasticPoolAlreadyExists — serwer zawiera już pulę elastyczną 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 zbyt niska 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 wartość jednostki DTU bazy danych jest zbyt niska 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 wartości 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 minimalnej liczby jednostek DTU na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami. 400 ElasticPoolInconsistentDtuGuaranteeSettings — próba zapewnienia minimalnej liczby jednostek DTU dla baz danych w elastycznej puli, która przekracza żądane jednostki DTU puli elastycznej. 400 ElasticPoolDtuUnsupported — użytkownik próbował utworzyć lub zaktualizować elastyczną pulę przy użyciu 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 odpowiada dozwolonym wartościom. 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 minimalnej liczby jednostek DTU na bazę danych wyższej 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 elastycznej puli. 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 odpowiada dozwolonym wartościom. 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 — elastyczna pula nie może obniżyć warstwy usługi z warstwy Premium do warstwy Standardowa lub Podstawowa, ponieważ co najmniej jedna baza 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 "{0}" na serwerze "{1}" jest obecnie w toku. 400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów bazy danych systemu Windows Azure SQL. Może to ulec zmianie w późniejszym czasie. 400 ElasticPoolOverFileSpace — niewystarczająca ilość miejsca na plik w elastycznej puli. 400 ElasticPoolDbDtuMinBelowLimit — żądana minimalna liczba jednostek DTU bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli. 400 ElasticPoolDbVcoreMaxBelowLimit — żądana maksymalna wartość rdzenia wirtualnego bazy danych jest zbyt niska 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 na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami. 400 ElasticPoolDbVcoreMinBelowLimit — żądana minimalna liczba rdzeni wirtualnych bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli. 400 InvalidInputValueForDatabaseVcoreMin — próba ustawienia min rdzeni wirtualnych na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami. 400 PartnerDBNotCompatibleForSGXEnclave — próba ustawienia linku GeoDR lub zaktualizowanie celu 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óba ustawienia wartości minimalnej liczby rdzeni wirtualnych na bazę danych wyższej 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 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. 404 ResourceNotFound — żądany zasób nie został znaleziony. 405 NotSupported — ta funkcja nie jest obsługiwana. 409 ElasticPoolBusy — podjęto próbę wykonania operacji zarządzania w elastycznej puli, która jest zajęta. 409 ServerDisabled — serwer jest wyłączony. 409 JednoczesneSkuChangeNotAllowed — operacje zmiany celu usługi nie mogą być jednocześnie uruchamiane w obu bazach danych relacji replikacji. 409 ElasticPoolUpdateLinksNotInCatchup — nie można zaktualizować elastycznej puli, podczas gdy jedna z jej baz danych wykonuje operację kopiowania lub replikacji geograficznej w trybie failover. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — 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 maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 ElasticPoolFailedMoveDbToElasticPool — nie można przenieść bazy danych do elastycznej puli z powodu ograniczeń zasobów wewnętrznych. Może to być warunek przejściowy. Spróbuj ponownie. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. 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 a Hyperscale elastic pool

Get an elastic pool

Get a Hyperscale elastic pool

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/sqlcrudtest-8102?api-version=2021-11-01

Java

/**
 * 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", 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

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

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/sqlcrudtest-8102?api-version=2021-11-01

Java

/**
 * 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", 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

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

Definicje

Nazwa	Opis
ElasticPool	Elastyczna pula.
ElasticPoolLicenseType	Typ licencji do zastosowania dla tej elastycznej puli.
ElasticPoolPerDatabaseSettings	Na ustawienia bazy danych elastycznej puli.
ElasticPoolState	Stan puli elastycznej.
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 pulą elastyczną, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul w warstwie Hiperskala.
properties.licenseType	ElasticPoolLicenseType	Typ licencji do zastosowania dla tej elastycznej puli.
properties.maintenanceConfigurationId	string	Identyfikator konfiguracji konserwacji przypisany do elastycznej puli. Ta konfiguracja określa 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 na bazę danych dla elastycznej puli.
properties.state	ElasticPoolState	Stan puli elastycznej.
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 twojej 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

ElasticPoolPerDatabaseSettings

Na ustawienia bazy danych elastycznej puli.

Nazwa	Typ	Opis
maxCapacity	number	Maksymalna pojemność, jaką może zużywać dowolna baza danych.
minCapacity	number	Minimalna pojemność wszystkich baz danych jest gwarantowana.

ElasticPoolState

Stan puli elastycznej.

Nazwa	Typ	Opis
Creating	string
Disabled	string
Ready	string

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa	Typ	Opis
capacity	integer	Pojemność konkretnej 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 numeryczny, np. P3.
size	string	Rozmiar konkretnej jednostki SKU
tier	string	Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.