Instance Pools - List

Servizio:

SQL Database

Versione API:

2023-08-01

Ottiene un elenco di tutti i pool di istanze nella sottoscrizione.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/instancePools?api-version=2023-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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	InstancePoolListResult	È stato recuperato correttamente l'elenco dei pool di istanze in una sottoscrizione.
Other Status Codes	ErrorResponse	Risposte di errore: 404 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

List instance pools in the subscription

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/instancePools?api-version=2023-08-01

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "family": "Gen5"
      },
      "properties": {
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
        "vCores": 8,
        "licenseType": "LicenseIncluded",
        "dnsZone": "1234567890",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
      },
      "location": "japaneast",
      "tags": {
        "a": "b"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
      "name": "testIP",
      "type": "Microsoft.Sql/instancePools"
    },
    {
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "family": "Gen5"
      },
      "properties": {
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group2/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
        "vCores": 8,
        "licenseType": "LicenseIncluded",
        "dnsZone": "1234567890",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
      },
      "location": "japaneast",
      "tags": {
        "a": "b"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group2/providers/Microsoft.Sql/instancePools/testIP2",
      "name": "testIP2",
      "type": "Microsoft.Sql/instancePools"
    }
  ]
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
InstancePool	Un pool di istanze sql di Azure.
InstancePoolLicenseType	Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).
InstancePoolListResult	Elenco dei pool di istanze SQL di Azure.
Sku	SKU della risorsa ARM.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

InstancePool

Oggetto

Un pool di istanze sql di Azure.

Nome	Tipo	Descrizione
id	string	ID risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.dnsZone	string	Zona DNS in cui si trova il pool di istanze gestite.
properties.licenseType	InstancePoolLicenseType	Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).
properties.maintenanceConfigurationId	string (arm-id)	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.
properties.subnetId	string	ID risorsa della subnet in cui inserire il pool di istanze.
properties.vCores	integer (int32)	Numero di vCore appartenenti a questo pool di istanze.
sku	Sku	Nome e livello dello SKU.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa.

InstancePoolLicenseType

Enumerazione

Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).

Valore	Descrizione
LicenseIncluded
BasePrice

InstancePoolListResult

Oggetto

Elenco dei pool di istanze SQL di Azure.

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

Sku

Oggetto

SKU della risorsa ARM.

Nome	Tipo	Descrizione
capacity	integer (int32)	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 numerico, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.