Elastic Pools - Get

Service:

SQL Database

API Version:

2021-11-01

Ottiene un pool elastico.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
elasticPoolName	path	True	string	Nome del pool elastico.
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ElasticPool	Completato
Other Status Codes		Risposte di errore: 400 ElasticPoolOverStorageUsage : tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico. 400 InvalidSku: l'utente ha specificato uno SKU non valido. 400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato. 400 ServerQuotaExceeded: il server ha raggiunto il limite per l'unità elaborate del database consentita. 400 ElasticPoolAlreadyExists: il server contiene già un pool elastico con il nome specificato. 400 SubscriptionVcoreQuotaExceeded- Impossibile eseguire l'operazione perché la sottoscrizione supera la quota vCore consentita. 400 InvalidInputValueForEdition - L'edizione specificata non è supportata per il provisioning del pool elastico. 400 ElasticPoolDtuBelowLimit: il valore DTU richiesto è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDtuAboveLimit: il valore DTU richiesto è troppo elevato per il livello di servizio del pool elastico richiesto. 400 InvalidMaxSize - Dimensioni massime non valide. 400 ElasticPoolDbDtuMaxBelowLimit: il valore massimo richiesto per DTU database è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDbDtuMaxAboveLimit: il valore massimo richiesto per DTU del database è troppo elevato per il livello di servizio del pool elastico richiesto. 400 InvalidInputValueForDatabaseDtuMax- Tentativo di impostare il numero massimo di DTU per database per il pool di risorse che non corrisponde ai valori consentiti. 400 ElasticPoolDbDtuMinAboveLimit: il min DTU richiesto per database è troppo elevato per il livello di servizio richiesto. 400 ElasticPoolOverStorage: tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico. 400 InvalidInputValueForDatabaseDtuMin - Tentativo di impostare il valore minimo DTU per database per il pool di risorse che non corrisponde ai valori consentiti. 400 ElasticPoolInconsistentDtuGuaranteeSettings - Tentativo di fornire il valore minimo di DTU per i database nel pool elastico che supera le DTU richieste del pool elastico. 400 ElasticPoolDtuUnsupported : l'utente ha tentato di creare o aggiornare un pool elastico con una capacità DTU non supportata. 400 ElasticPoolStorageAboveLimitGB: tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato. 400 ElasticPoolsNotEnabled: i pool elastici non sono stati abilitati in questa area. 400 ElasticPoolNotEmpty - Richiesta di eliminazione di un pool elastico non vuoto. 400 ElasticPoolStorageBelowLimitGB : tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato. 400 ElasticPoolStorageNotAllowedGB : tentativo di impostare il limite di archiviazione del pool elastico in gb che non corrisponde ai valori consentiti. 400 ElasticPoolDatabaseLimit: il pool elastico ha raggiunto il limite per il numero di database. 400 ElasticPoolDecreaseStorageLimitBelowUsage - Tentativo di ridurre il limite di archiviazione del pool elastico al di sotto dell'utilizzo di archiviazione. 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Tentativo di impostare il valore minimo DTU per database superiore al numero massimo di DTU per database. 400 ElasticPoolInconsistentVcoreGuaranteeSettings: il numero di database e il numero minimo di VCore per database non possono superare i VCore richiesti del pool elastico. 400 ElasticPoolStorageBelowLimitMB: tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato. 400 ElasticPoolStorageNotAllowedMB - Tentativo di impostare il limite di archiviazione del pool elastico in mb che non corrisponde ai valori consentiti. 400 ElasticPoolCapacityStorageNotAllowedMB - Tentativo di impostare il limite di archiviazione del pool elastico in mb che non corrisponde ai valori consentiti. 400 ElasticPoolStorageAboveLimitMB : tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato. 400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata. 400 InvalidTier: l'utente ha specificato un livello non valido. 400 SourceDatabaseEditionCouldNotBeUpgraded: il database di origine non può avere un'edizione superiore rispetto al database di destinazione. 400 TargetDatabaseEditionCouldNotBeDowngraded: il database di destinazione non può avere un'edizione inferiore rispetto al database di origine. 400 ElasticPoolUpdateHkNotAllowed: il pool elastico non può abbassare il livello di servizio da Premium a Standard o Basic perché uno o più database usano oggetti ottimizzati per la memoria. 400 UpdateNotAllowedIfGeoDrOperationInProgress - L'operazione non è consentita perché l'operazione di copia o failover per il database '{0}' nel server '{1}' è attualmente in corso. 400 RegionDoesNotAllowProvisioning: il percorso selezionato non accetta nuovi server di database di Windows Azure SQL. Questa modifica può essere modificata in un secondo momento. 400 ElasticPoolOverFileSpace - Spazio file insufficiente nel pool elastico. 400 ElasticPoolDbDtuMinBelowLimit: il valore minimo richiesto per DTU del database è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDbVcoreMaxBelowLimit: il valore massimo VCore richiesto per database VCore è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDbVcoreMaxAboveLimit- Il valore massimo VCore richiesto per database VCore è troppo elevato per il livello di servizio del pool elastico richiesto. 400 InvalidInputValueForDatabaseVcoreMax- Tentativo di impostare il valore massimo VCore per database per il pool di risorse che non corrisponde ai valori consentiti. 400 ElasticPoolDbVcoreMinBelowLimit: il valore minimo VCore richiesto per database è troppo basso per il livello di servizio del pool elastico richiesto. 400 InvalidInputValueForDatabaseVcoreMin- Tentativo di impostare il valore minimo VCore per database per il pool di risorse che non corrisponde ai valori consentiti. 400 PartnerDBNotCompatibleForSGXEnclave - Il tentativo di impostare il collegamento GeoDR o aggiornare SLO per il database abilitato per l'enclave è supportato solo quando entrambi i database sono in esecuzione nell'hardware della serie DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax- Tentativo di impostare il valore minimo VCore per database superiore al numero massimo di VCore per database. 400 InvalidLicenseType : l'utente ha tentato di creare o aggiornare un database o un pool elastico con tipo di licenza non supportato. 400 ProvisioningDisabled - Visualizza il messaggio di errore dell'agente di autorizzazione dell'operazione risorse così come è, senza modifiche 400 InvalidPublicMaintenanceConfiguration - L'utente ha tentato di specificare la configurazione di manutenzione pubblica che non può essere convertita in ID interno (area non valida o errata). 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ElasticPoolNotFound: il pool elastico specificato non esiste per il server specificato. 404 OperationIdNotFound- L'operazione con ID non esiste. 404 ResourceNotFound: la risorsa richiesta non è stata trovata. 405 NotSupported : questa funzionalità non è supportata. 409 ElasticPoolBusy - È stata tentata un'operazione di gestione in un pool elastico occupato. 409 ServerDisabled - Il server è disabilitato. 409 SimultaneousSkuChangeNotAllowed- Le operazioni di modifica dell'obiettivo del servizio non possono essere eseguite in entrambi i database di una relazione di replica contemporaneamente. 409 ElasticPoolUpdateLinksNotInCatchup- Impossibile aggiornare il pool elastico mentre uno dei relativi database esegue un'operazione di failover di copia o replica geografica. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 Operazione interrotta- Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 500 ElasticPoolFailedMoveDbToElasticPool- Impossibile spostare il database nel pool elastico a causa di vincoli di risorse interni. Potrebbe trattarsi di una condizione temporanea. Riprovare. 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione. 503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile. 503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

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

Definizioni

Nome	Descrizione
ElasticPool	Un pool elastico.
ElasticPoolLicenseType	Tipo di licenza da applicare per questo pool elastico.
ElasticPoolPerDatabaseSettings	Impostazioni per database di un pool elastico.
ElasticPoolState	Stato del pool elastico.
Sku	SKU della risorsa ARM.

ElasticPool

Un pool elastico.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string	Tipo di pool elastico. Si tratta di metadati usati per l'esperienza di portale di Azure.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.creationDate	string	Data di creazione del pool elastico (formato ISO8601).
properties.highAvailabilityReplicaCount	integer	Numero di repliche secondarie associate al pool elastico utilizzato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale.
properties.licenseType	ElasticPoolLicenseType	Tipo di licenza da applicare per questo pool elastico.
properties.maintenanceConfigurationId	string	ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.
properties.maxSizeBytes	integer	Limite di archiviazione per il pool elastico del database in byte.
properties.minCapacity	number	Capacità minima che il pool serverless non verrà ridotto al di sotto, se non sospeso
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Impostazioni per database per il pool elastico.
properties.state	ElasticPoolState	Stato del pool elastico.
properties.zoneRedundant	boolean	Indipendentemente dal fatto che questo pool elastico sia con ridondanza della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità.
sku	Sku	SKU del pool elastico. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API Capabilities_ListByLocation REST o il comando seguente: az sql elastic-pool list-editions -l <location> -o table
tags	object	Tag delle risorse.
type	string	Tipo di risorsa.

ElasticPoolLicenseType

Tipo di licenza da applicare per questo pool elastico.

Nome	Tipo	Descrizione
BasePrice	string
LicenseIncluded	string

ElasticPoolPerDatabaseSettings

Impostazioni per database di un pool elastico.

Nome	Tipo	Descrizione
maxCapacity	number	Capacità massima che può essere utilizzata da un database.
minCapacity	number	La capacità minima di tutti i database è garantita.

ElasticPoolState

Stato del pool elastico.

Nome	Tipo	Descrizione
Creating	string
Disabled	string
Ready	string

Sku

SKU della risorsa ARM.

Nome	Tipo	Descrizione
capacity	integer	Capacità dello SKU specifico.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, può essere acquisito qui.
name	string	Nome dello SKU, in genere una lettera + codice numerico, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Livello o edizione dello SKU specifico, ad esempio Basic, Premium.