Elastic Pools - List By Server

Servizio:

SQL Database

Versione API:

2021-11-01

Ottiene tutti i pool elastici in un server.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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.
$skip	query		integer int64	Numero di elementi nella raccolta da ignorare.

Risposte

Nome	Tipo	Descrizione
200 OK	ElasticPoolListResult	Completato
Other Status Codes		Risposte agli errori: ** 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à velocità effettiva 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 DTU richiesto per database DTU è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDbDtuMaxAboveLimit: il valore massimo DTU richiesto per database DTU è troppo elevato per il livello di servizio del pool elastico richiesto. 400 InvalidInputValueForDatabaseDtuMax - Tentativo di impostare il valore massimo DTU per ogni database per il pool di risorse che non corrisponde ai valori consentiti. 400 ElasticPoolDbDtuMinAboveLimit: il valore DTU richiesto per ogni 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 DTU min per database per il pool di risorse che non corrisponde ai valori consentiti. 400 ElasticPoolInconsistentDtuGuaranteeSettings - Tentativo di fornire il numero minimo 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 - Richiedere di eliminare 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 dell'archiviazione. 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Tentativo di impostare il numero minimo DTU per database superiore al massimo DTU per database. 400 ElasticPoolInconsistentVcoreGuaranteeSettings: il numero di database e VCore min per database non può 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 edizioni superiori 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ò ridurre il livello di servizio da Premium a Standard o Basic perché uno o più dei relativi database usano oggetti ottimizzati per la memoria. 400 UpdateNotAllowedIfGeoDrOperationInProgress - L'operazione non è consentita perché l'operazione di copia o failover per il database '' nel server '{0}{1}' è attualmente in corso. 400 RegionDoesNotAllowProvisioning - La posizione selezionata non accetta nuovi server di database di Windows Azure SQL. Questo può cambiare in un secondo momento. 400 ElasticPoolOverFileSpace - Spazio file insufficiente nel pool elastico. 400 ElasticPoolDbDtuMinBelowLimit : il valore richiesto per DTU del database è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDbVcoreMaxBelowLimit: il valore massimo richiesto per database VCore è troppo basso per il livello di servizio del pool elastico richiesto. 400 ElasticPoolDbVcoreMaxAboveLimit: il valore massimo richiesto per database VCore max è troppo elevato per il livello di servizio del pool elastico richiesto. 400 InvalidInputValueForDatabaseVcoreMax - Tentativo di impostare il valore massimo VCore per ogni database per il pool di risorse che non corrisponde ai valori consentiti. 400 ElasticPoolDbVcoreMinBelowLimit: il valore richiesto per ogni VCore del database è troppo basso per il livello di servizio del pool elastico richiesto. 400 InvalidInputValueForDatabaseVcoreMin - Tentativo di impostare il valore VCore min per database per il pool di risorse che non corrisponde ai valori consentiti. 400 PartnerDBNotCompatibleForSGXEnclave - Tentativo di impostare il collegamento GeoDR o aggiornare SLO per il database abilitato per l'enclave è supportato solo quando entrambi i database vengono eseguiti nell'hardware della serie DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Tentativo di impostare il valore VCore min per database superiore al valore massimo VCore per ogni 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 dall'autorizzazione dell'operazione delle risorse, 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. 405 NotSupported : questa funzionalità non è supportata. 409 ElasticPoolBusy: un'operazione di gestione è stata tentata in un pool elastico occupato. 409 ServerDisabled - Il server è disabilitato. 409 SimultaneEChangeNotAllowed - 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 le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 500 ElasticPoolFailedMoveDbToElasticPool - Impossibile spostare il database nel pool elastico a causa di vincoli di risorse interni. Può trattarsi di una condizione temporanea, riprovare. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. 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 all elastic pools in a server

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
ElasticPool	Un pool elastico.
ElasticPoolLicenseType	Tipo di licenza da applicare per questo pool elastico.
ElasticPoolListResult	Risultato di una richiesta di elenco di pool elastici.
ElasticPoolPerDatabaseSettings	Per ogni impostazione del database di un pool elastico.
ElasticPoolState	Stato del pool elastico.
Sku	SKU di 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 (ISO8601 formato).
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 si verificheranno gli aggiornamenti della manutenzione.
properties.maxSizeBytes	integer	Limite di archiviazione per il pool elastico del database in byte.
properties.minCapacity	number	La capacità minima del pool serverless non verrà ridotta al di sotto, se non sospesa
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 ridondante nella 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 e all'offerta di supporto. Per determinare gli SKU (inclusi il nome 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 di risorse.
type	string	Tipo di risorsa.

ElasticPoolLicenseType

Tipo di licenza da applicare per questo pool elastico.

Nome	Tipo	Descrizione
BasePrice	string
LicenseIncluded	string

ElasticPoolListResult

Risultato di una richiesta di elenco di pool elastici.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	ElasticPool[]	Matrice di risultati.

ElasticPoolPerDatabaseSettings

Per ogni impostazione del database di un pool elastico.

Nome	Tipo	Descrizione
maxCapacity	number	La capacità massima di un database può essere usata.
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 di 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, è possibile acquisire qui.
name	string	Il nome dello SKU, in genere, una lettera + Codice Numero, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Livello o edizione dello SKU specifico, ad esempio Basic, Premium.