Condividi tramite

Usage - List

Servizio:
Compute
Versione API:
2025-04-01

Ottiene, per la posizione specificata, le informazioni sull'utilizzo corrente delle risorse di calcolo e i limiti per le risorse di calcolo incluse nella sottoscrizione.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/usages?api-version=2025-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
location
 path True

string

minLength: 1

Nome dell'area di Azure.
subscriptionId
 path True

string

minLength: 1

ID della sottoscrizione di destinazione.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

ListUsagesResult

La richiesta è andata a buon fine.
Other Status Codes

CloudError

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Usage_List_MaximumSet_Gen
Usage_List_MinimumSet_Gen

Usage_List_MaximumSet_Gen

Esempio di richiesta

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/4_./usages?api-version=2025-04-01

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "unit": "Count",
      "currentValue": 17,
      "limit": 19,
      "name": {
        "value": "aaaaaaaaaaaaaaaaaa",
        "localizedValue": "aaaaaaaaaaaaaa"
      }
    }
  ],
  "nextLink": "a://example.com/aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

Usage_List_MinimumSet_Gen

Esempio di richiesta

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/_--/usages?api-version=2025-04-01

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "unit": "Count",
      "currentValue": 17,
      "limit": 19,
      "name": {}
    }
  ]
}

Definizioni

Nome Descrizione
ApiError

Errore API.
ApiErrorBase

Base di errore API.
CloudError

Risposta di errore dal servizio di calcolo.
InnerError

Dettagli dell'errore interno.
ListUsagesResult

Risposta dell'operazione List Usages.
Usage

Descrive l'utilizzo delle risorse di calcolo.
UsageName

Nomi di utilizzo.

ApiError

Oggetto

Errore API.

Nome Tipo Descrizione
code

string

Codice di errore.
details

ApiErrorBase[]

Dettagli dell'errore Api
innererror

InnerError

L'errore interno dell'API
message

string

Messaggio di errore.
target

string

Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome Tipo Descrizione
code

string

Codice di errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore specifico.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore API.

InnerError

Oggetto

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump di eccezione.
exceptiontype

string

Tipo di eccezione.

ListUsagesResult

Oggetto

Risposta dell'operazione List Usages.

Nome Tipo Descrizione
nextLink

string (uri)

URI per recuperare la pagina successiva delle informazioni sull'utilizzo delle risorse di calcolo. Chiamare ListNext() con this per recuperare la pagina successiva delle informazioni sull'utilizzo delle risorse di calcolo.
value

Usage[]

Elenco degli utilizzi delle risorse di calcolo.

Usage

Oggetto

Descrive l'utilizzo delle risorse di calcolo.

Nome Tipo Descrizione
currentValue

integer (int32)

Utilizzo corrente della risorsa.
limit

integer (int64)

Utilizzo massimo consentito della risorsa.
name

UsageName

Il nome del tipo di utilizzo.
unit enum:

Count

Un'enumerazione che descrive l'unità di misura dell'utilizzo.

UsageName

Oggetto

Nomi di utilizzo.

Nome Tipo Descrizione
localizedValue

string

Nome localizzato della risorsa.
value

string

Nome della risorsa.