Azure Quota API

  • Articolo

L'API Quota è un'API REST che è possibile usare per visualizzare e gestire le quote per i servizi di Azure.

Importante

Disponibilità generale dell'API Quota

L'API Quota di Azure è ora disponibile a livello generale. Attualmente supporta macchine virtuali di Azure (core/vCPU) e servizi di Azure Machine Learning (dedicati/vCPU).

Nota: Una nuova versione dell'API REST Quota è disponibile in anteprima pubblica nell'API REST del servizio quota di Azure. Usa il provider di risorse Microsoft.Quota e supporta macchine virtuali di Azure (core/vCPU), Azure Machine Learning, rete di Azure, azure Cache HPC e i servizi di Azure Purview.

Le quote sono i valori massimi per risorse, azioni ed elementi nella sottoscrizione di Azure. Ogni servizio di Azure definisce le quote e ne determina i valori predefiniti. A seconda delle esigenze aziendali, potrebbe essere necessario aumentare i valori di quota.

Per altre informazioni sui limiti più comuni di Microsoft Azure, vedere Sottoscrizione di Azure e limiti, quote e vincoli dei servizi.

Uso dell'API Quota

Con l'API Quota è possibile:

  • Ottenere le quote e gli utilizzi correnti di una risorsa.
  • Ottenere un elenco delle quote e degli utilizzi correnti di tutte le risorse.
  • Creare o aggiornare le quote di una risorsa.
  • Ottenere lo stato delle richieste di quota per una risorsa.
  • Ottenere l'elenco di tutte le richieste di quota di una risorsa per un anno.

Operazioni REST

L'API Quota di Azure semplifica la ricerca delle quote e l'aumento delle richieste usando queste operazioni REST:

Prerequisiti

Importante

Prima di poter usare l'API Quota, è necessario:

Registrazione del provider di risorse di capacità Microsoft

Per registrare il provider di risorse capacità Microsoft, usare questo comando di PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Restituisce risultati simili a questo output:

ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes     : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations         : {West Europe, East US, South Central US...}

Dopo aver registrato il provider di risorse Microsoft.Capacity, verrà RegistrationState impostato su Registered. Per altre informazioni sulla gestione dei provider di risorse di Azure, vedere Provider di risorse di Azure.

Ruolo Operatore richiesta quota

Il ruolo Operatore richiesta quota è un ruolo predefinito di Azure personalizzato per le operazioni di quota. Concede le autorizzazioni per leggere e creare richieste di quota, ottenere lo stato della richiesta di quota e creare ticket di supporto. Assegnare questo ruolo a utenti, gruppi, entità servizio, identità gestite e applicazioni che eseguono operazioni di quota. Per riferimento, l'ID ruolo Operatore richiesta quota è 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Quote vCPU

È possibile usare l'API Quota per gestire le quote per questi due tipi di quote vCPU:

  • Quota vCPU standard per le macchine virtuali con pagamento in base al consumo e le istanze di vm riservate .
  • Quota vCPU spot per le macchine virtuali spot .

Per altre informazioni sui limiti e sulle quote di Azure, vedere Sottoscrizione di Azure e limiti dei servizi, quote e vincoli.

Quote di Azure Machine Learning

È possibile usare l'API Quota per gestire le quote per le aree di lavoro e il calcolo di Azure Machine Learning. Per altre informazioni, vedere l'articolo Gestire e aumentare le quote per le risorse con Azure Machine Learning :

  • Limiti predefiniti per le risorse di Azure correlate ad Azure Machine Learning.
  • Creazione di quote a livello di area di lavoro.
  • Visualizzazione delle quote e dei limiti.
  • Aumento della quota richiesta.
  • Quote di endpoint privato e DNS.

Regioni

La maggior parte delle quote è specifica per un carico di lavoro in qualsiasi area. Richiedere quote separate per ogni area in cui si vuole distribuire un servizio. Per elencare tutte le aree di Azure in cui è presente il servizio, usare l'operazione Elenca per aree del servizio .

Limitazione

Ogni chiamata API a livello di sottoscrizione e a livello di tenant può essere limitata se si inviano troppe richieste API. Se la chiamata API è limitata, verrà visualizzato un messaggio di errore che informa che il server ha rifiutato la richiesta API. È possibile ripetere la chiamata API dopo che è trascorso del tempo.

Per informazioni dettagliate sulla limitazione delle richieste delle API, su come risolvere i problemi di limitazione e su come evitare la limitazione, vedere Risoluzione degli errori di limitazione delle richieste in Azure.

Risoluzione degli errori dell'API Quota

Usare le tabelle seguenti per risolvere gli errori che potrebbero verificarsi durante l'uso dell'API Quota.

Codice di errore Come risolverlo
ContactSupport Aprire una nuova richiesta di supporto nel portale di Azure. In Selezionare un tipo di problema scegliere Limiti di servizio e sottoscrizione (quote). È anche possibile aprirlo a livello di codice usando l'API REST del supporto di Azure.
InternalServerError Errore interno del server. Ripetere la chiamata API in un secondo momento.
MissingRegistration Registrare il provider di risorse Microsoft.Capacity per ognuna delle sottoscrizioni. Per informazioni sulla risoluzione dei problemi, vedere Risolvere gli errori per la registrazione del provider di risorse.
QuotaNotAvailableForResource La quota non è attualmente disponibile nel percorso della risorsa richiesta. Aprire una nuova richiesta di supporto nel portale di Azure. In Selezionare un tipo di problema scegliere Limiti di servizio e sottoscrizione (quote). È anche possibile aprirlo a livello di codice usando l'API REST del supporto di Azure.
QuotaReductionNotSupported Il limite di quota corrente è superiore alla quota richiesta o l'utilizzo corrente è superiore alla quota richiesta. La riduzione delle quote non è supportata. La quota non può essere ridotta.
RequestThrottled Ogni richiesta api a livello di sottoscrizione e a livello di tenant può essere limitata per facilitare le prestazioni complessive del servizio. Il numero di richieste ha superato la frequenza massima consentita delle richieste API. Riprovare più tardi.
ResourceNotAvailableForOffer La risorsa non è attualmente disponibile nella posizione per il tipo di offerta. Per l'elenco delle offerte correnti e ritirati, vedere la pagina Dei dettagli dell'offerta di Microsoft Azure . Per modificare il tipo di offerta, vedere la pagina Modificare la sottoscrizione di Azure in un'offerta diversa . È anche possibile aprire una nuova richiesta di supporto nel portale di Azure. In Selezionare un tipo di problema scegliere Limiti di servizio e sottoscrizione (quote). È anche possibile aprirlo a livello di codice usando l'API REST del supporto di Azure.
ResourceNotAvailableForSubscription La risorsa non è attualmente disponibile nel percorso della sottoscrizione richiesta. Aprire una nuova richiesta di supporto nel portale di Azure. In Selezionare un tipo di problema scegliere Limiti di servizio e sottoscrizione (quote). È anche possibile aprirlo a livello di codice usando l'API REST del supporto di Azure.
UnableToIncreaseQuota Impossibile aumentare le quote per le sottoscrizioni richieste. Aprire una nuova richiesta di supporto nella portale di Azure. In Selezionare un tipo di problema scegliere Limiti di servizio e sottoscrizione (quote).

Supporto in altri linguaggi e interfacce

L'API REST Quota è disponibile negli SDK specifici del linguaggio di Microsoft Azure seguenti:

Uso di portale di Azure e API di supporto per gestire le quote

Azure consente di creare e gestire richieste di supporto, note anche come ticket di supporto. È possibile: