Condividi tramite

API del servizio quota di Azure

  • Articolo

L'API REST del servizio quota di Azure è progettata per la visualizzazione e la gestione delle quote per i provider di risorse di Azure.

Importante

L'API del servizio quota di Azure è anteprima pubblica

Una nuova versione dell'API Quota di Azure è disponibile in anteprima pubblica. Questa API usa il provider di risorse Microsoft.Quota, supporta macchine virtuali di Azure (core/vCPU), Azure Machine Learning (dedicato/vCPU), rete, Cache HPC di Azure, archiviazione e servizi di Azure Purview.

Una quota è il limite o la quantità di servizio impostata su una risorsa nella sottoscrizione di Azure. Ogni servizio di Azure definisce le quote e ne determina i valori predefiniti. Per altre informazioni sulle quote di Microsoft Azure più comuni, vedere Sottoscrizione di Azure e limiti, quote e vincoli dei servizi.

Uso delle API Quota

Con l'API Quota è possibile:

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

Chiamata e ambito DELL'API Quota

La richiesta PUT dell'API Quota include un parametro di "ambito" che può essere personalizzato per allinearsi ai requisiti dei provider di risorse che cercano un aumento della quota, assicurando che la chiamata API rimanga uniforme.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Provider di risorse Ambito
Microsoft.Compute subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{azure location}
Microsoft.HDInsight subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{azure location}
Microsoft.MachineLearningService subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningService/locations/{azure location}
Microsoft.Network subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{azure location}
Microsoft.Purview subscriptions/{subscriptionId}/providers/Microsoft.Purview/locations/{azure location}

Nota: un esempio di chiamata PUT per il calcolo è disponibile qui.

Prerequisiti

Importante

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

Registrazione del provider di risorse Quota Microsoft

Per registrare il provider di risorse Quota Microsoft, usare il comando di PowerShell seguente:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Restituisce risultati simili all'output seguente:

ProviderNamespace : Microsoft.Quota
RegistrationState : Registering
ResourceTypes     : {usages, quotas, quotaRequests, operationsStatus...}
Locations         : {West Europe, East US, South Central US...}

Dopo la registrazione del provider di risorse Microsoft.Quota, verrà RegistrationState impostato su Registered. Per altre informazioni sulla gestione dei provider di risorse di Azure, vedere Provider di risorse di Azure.

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.

Ruolo dell'operatore Quota Request

L'operatore di 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.

Il ruolo Operatore richiesta quota viene esteso per includere le autorizzazioni del provider di risorse quota.

Procedure consigliate per le API quota

  1. Utilizzo della quota di monitoraggio: Usare l'API quota di Azure per tenere traccia dell'utilizzo delle quote in modo efficace. Questa API fornisce informazioni in tempo reale sull'utilizzo corrente e sulla quota disponibile per una combinazione specifica di sottoscrizione, famiglia di macchine virtuali e area. È fondamentale controllare regolarmente l'utilizzo delle quote prima di prendere in considerazione qualsiasi aumento della quota.

  2. Richiesta di aumento della quota: Se l'utilizzo della quota supera la destinazione predefinita, avviare una richiesta di aumento della quota usando l'API quota di Azure per riportare l'utilizzo in linea con gli obiettivi. Il processo è semplice: è sufficiente inviare una richiesta API che delinea l'aumento di quota desiderato. Ad esempio, se l'utilizzo di destinazione per la quota della famiglia di macchine virtuali Dv2 in Europa settentrionale, in "subscription1", è impostato su 80%, mentre il monitoraggio dell'API quota di Azure indica un utilizzo effettivo dell'85%, inviare un aumento della quota del 10% al 20%.

Suggerimento

È consigliabile richiedere un aumento della quota del 10% al 20% dell'utlizzazione delle risorse perché fornisce un buffer risonale per picchi imprevisti nell'utilizzo delle risorse, assicurandosi di non raggiungere immediatamente il nuovo limite di quota dopo un aumento. Questo approccio riduce al minimo la necessità di chiamate API frequenti per richiedere una quota aggiuntiva, migliorando le probabilità di approvazione.

  1. Aumento della quota: Quando si invia una richiesta di aumento della quota, si riceverà una risposta che indica se la richiesta è stata approvata o rifiutata. In caso di rifiuto, è possibile avviare un completamento registrando una richiesta di supporto usando l'API REST del supporto di Azure o usando una nuova richiesta di supporto nel portale di Azure, incluse le specifiche della richiesta di aumento della quota negata e il motivo della richiesta di richiesta di richiesta.

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.Quota 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 nel portale di Azure. In Selezionare un tipo di problema scegliere Limiti di servizio e sottoscrizione (quote).
Autenticazione a più fattori obbligatoria Le richieste di quota devono essere Multi-Factor Authentication. Abilitare Multi-Factor Authentication per il tenant o l'account seguendo le istruzioni riportate in Abilitare MFA e riprovare
RequestPartiallyFulfilled La richiesta di quota viene soddisfatta parzialmente. Per eventuali domande, aprire una nuova richiesta di supporto nel 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 di Microsoft Azure specifici del linguaggio 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: