API del servizio quota di Azure
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:
- 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
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:
- Registrare il provider di risorse Microsoft.Quota per tutte le sottoscrizioni usando PowerShell.
- Assegnare il ruolo Operatore richiesta quota a tutti gli account utente e le applicazioni che eseguiranno operazioni di quota.
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
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.
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.
- 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:
- Microsoft Azure SDK per .NET: pacchetto NuGet
- Microsoft Azure SDK per Java: pacchetto Java
- Microsoft Azure SDK per Python: pacchetto Py
- Microsoft Azure SDK per JavaScript (NodeJS & Browser): pacchetto JavaScript
- Microsoft Azure SDK per Go: Pacchetto Go
- Estensioni dell'interfaccia della riga di comando di Microsoft Azure: pacchetto dell'interfaccia della riga di comando
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: