L'API Cloud Quotas ti consente di modificare in modo programmatico le quote a livello di progetto e di automatizzare le richieste di adeguamento delle quote a livello di progetto. Ad esempio, puoi utilizzare l'API Cloud Quotas per:
Automatizza gli aggiustamenti delle quote: puoi utilizzare l'API Cloud Quotas per richiedere aggiustamenti delle quote in base ai tuoi criteri. Ad esempio, per evitare errori di quota superata, puoi utilizzare l'API per richiedere programmaticamente un aggiustamento della quota quando le risorse Compute Engine raggiungono l'80% della quota disponibile.
Riutilizza le configurazioni delle quote tra i progetti: l'API Cloud Quotas può clonare le configurazioni delle quote da un progetto all'altro. Se esiste un insieme noto di quote che devono essere aumentate per ogni nuovo progetto, puoi utilizzare l'API Cloud Quotas per automatizzare questa operazione nella logica di creazione del progetto. Google Cloud Le richieste di adeguamento delle quote sono soggette ad Google Cloud approvazione.
Gestire le richieste di quota dei clienti: se sei un fornitore SaaS integrato con Google Cloud, potresti ricevere richieste di aumento della quota tramite un portale rivolto ai clienti diverso dalla console Google Cloud. Queste richieste devono essere inoltrate a Google Cloud per l'elaborazione. L'API Cloud Quotas può inoltrare automaticamente le richieste dei clienti.
Abilita il controllo della versione della configurazione del client: l'API Cloud Quotas è declarative. Puoi trattare le configurazioni delle quote come codice e archiviarle nel tuo sistema con controllo della versione per la cronologia e il rollback.
Limitazioni
Le quote Cloud presentano le seguenti limitazioni:
Nella maggior parte dei casi, gli aggiustamenti per l'aumento della quota devono essere apportati a livello di progetto. Un numero limitato di prodotti supporta aggiustamenti dell'aumento della quota a livello di organizzazione. Per sapere se un Google Cloud prodotto supporta aggiustamenti dell'aumento della quota a livello di organizzazione, consulta la documentazione relativa al prodotto.
Puoi richiedere aggiustamenti di riduzione delle quote per le quote a livello di progetto, organizzazione e cartella.
L'API Cloud Quotas supporta solo le operazioni a livello di progetto. Le operazioni a livello di cartella e di organizzazione non sono supportate.
Endpoint di servizio
L'endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint. Il servizio API Cloud Quotas ha il seguente endpoint e tutti gli URI sono relativi a questo:
https://cloudquotas.googleapis.com
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per accedere alle risorse cloudquotas_quotaPreferences
, cloudquotas_quotaInfos
e cloudquotas_quotaAdjusterSettings
,
chiedi all'amministratore di concederti il ruolo IAM Amministratore delle quote Cloud (cloudquotas.admin
)
nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene
le autorizzazioni necessarie per accedere alle risorse cloudquotas_quotaPreferences
, cloudquotas_quotaInfos
e cloudquotas_quotaAdjusterSettings
. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per accedere alle risorse cloudquotas_quotaPreferences
, cloudquotas_quotaInfos
e cloudquotas_quotaAdjusterSettings
sono necessarie le seguenti autorizzazioni:
-
cloudquotas.quotas.update
-
cloudquotas.quotas.get
-
monitoring.timeSeries.list
-
resourcemanager.projects.get
-
resourcemanager.projects.list
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Modello di risorse API
Il modello di risorse dell'API Cloud Quotas è costituito da due risorse:
QuotaPreference
e QuotaInfo
.
Preferenza quota
La risorsa QuotaPreference
rappresenta la tua preferenza per la quota per una determinata
combinazione di dimensioni. Utilizza
questa risorsa per modificare le quote nei progetti, nelle cartelle o nelle organizzazioni.
Impostare un valore preferito per una regione
L'esempio seguente mostra una risorsa QuotaPreference
in un metodo CreateQuotaPreference
.
{ "service": "compute.googleapis.com", "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region", "quotaConfig": { "preferredValue": 100 }, "dimensions": { "region": "us-central1" } }
Il valore preferredValue
pari a 100 indica che il richiedente vuole che la quota GPUS-PER-GPU-FAMILY-per-project-region
sia impostata su quel valore. Il campo delle dimensioni indica che la preferenza si applica solo alla regione
us-central1
.
Verificare il valore concesso
Visualizza la preferenza per la quota e controlla il campo grantedValue
per verificare il valore concesso.
Per visualizzare la preferenza per le quote utilizzando Google Cloud CLI, esegui quanto segue nel tuo terminale:
gcloud alpha quotas preferences describeQUOTA_PREFERENCE_ID --project=PROJECT
Sostituisci quanto segue:
QUOTA_PREFERENCE_ID
: l'ID della preferenza di quota. Si tratta del valore specificato al momento della creazione della preferenza di quota.PROJECT
: l'ID o il numero del Google Cloud progetto.
Se hai inviato una richiesta di variazione della quota e la richiesta è stata approvata parzialmente, accanto al campo grantedValue
viene visualizzato un campo stateDetail
. grantedValue
mostra l'aggiustamento apportato e il campo stateDetail
descrive lo stato di approvazione parziale.
Per vedere se il valore concesso è il valore finale approvato, controlla il
reconciling
campo. Se la tua richiesta è ancora in fase di valutazione, il
reconciling
campo è impostato su true
. Se il campo reconciling
è impostato su
false
o viene omesso, il valore concesso è il valore finale approvato.
I seguenti snippet di codice mostrano esempi dell'oggetto preferenza quota. Utilizzano una preferenza per la quota demo con l'ID
compute_googleapis_com-gpus-us-central1
.
Se visualizzi la preferenza di quota utilizzando gcloud CLI, il risultato sarà simile al seguente:
createTime: '2023-01-15T01:30:15.01Z' dimensions: region: us-central1 name: projects/PROJECT_NUMBER /locations/global/quotaPreferences/compute_googleapis_com-gpus-us-central1 quotaConfig: granteddValue: '100' preferredValue: '100' traceId: 123acd-345df23 requestOrigin: ORIGIN_UNSPECIFIED service: compute.googleapis.com quotaId: GPUS-PER-GPU-FAMILY-per-project-region updateTime: '2023-01-16T02:35:16.01Z'
Se visualizzi la preferenza di quota utilizzando l'API Cloud Quotas, il risultato sarà simile al seguente:
{ "name": "projects/PROJECT_NUMBER /locations/global/quotaPreferences/compute_googleapis_com-gpus-us-central1", "service": "compute.googleapis.com", "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region", "quotaConfig": { "preferredValue": 100, "grantedValue": 100, "traceId": "123acd-345df23", "requestOrigin": "ORIGIN_UNSPECIFIED" }, "dimensions": { "region": "us-central1" }, "createTime": "2023-01-15T01:30:15.01Z", "updateTime": "2023-01-16T02:35:16.01Z" }
Questo output include i seguenti valori:
PROJECT_NUMBER
: un identificatore unico generato automaticamente per il progetto.
La risposta mostra un valore grantedValue
pari a 100, il che significa che il preferredValue
dell'esempio precedente è stato approvato e soddisfatto.
Le preferenze per dimensioni diverse sono risorse QuotaPreference
diverse. Ad esempio, QuotaPreference
per la CPU nelle regioni us-central1
e
us-east1
sono due risorse distinte.
La preferenza per le quote è obbligatoria
Le risorse QuotaPreference
vengono utilizzate per indicare il valore preferito per una determinata quota. Il valore corrente di una determinata quota si basa su:
QuotaPreference
richieste da te.Richieste di aumento della quota approvate entro il giorno Google Cloud.
Modifiche alle quote avviate da Google Cloud.
La possibilità di eliminare un QuotaPreference
non è supportata. Tuttavia, puoi impostare un valore di quota preferito inferiore al valore Google Cloud approvato per aggiungere ulteriori guardrail.
Per ulteriori informazioni sulla risorsa QuotaPreference
, consulta la documentazione di riferimento dell'API Cloud Quotas.
Per ulteriori informazioni sulle query QuotaPreference
, consulta
Implementare casi d'uso comuni.
Informazioni sulla quota
QuotaInfo
è una risorsa di sola lettura che fornisce informazioni su una determinata quota per un determinato progetto, una cartella o organizzazioni. Mostra le informazioni relative alle quote definite dai servizi Google Cloud e a eventuali aggiustamenti delle quote soddisfatte avviati dai clienti. La risorsa QuotaInfo
contiene informazioni come metadati, tipo di contenitore e dimensione.
Impostare valori di quota diversi per regione
Il seguente esempio di risorsa QuotaInfo
mostra che la quota CPU per il progetto è pari a 200 per la regione us-central1
e a 100 per tutte le altre regioni.
{ "name": "projects/PROJECT_NUMBER /locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region", "quotaId": "CPUS-per-project-region", "metric": "compute.googleapis.com/cpus", "containerType": "PROJECT", "dimensions": [ "region" ], "isPrecise": true, "quotaDisplayName": "CPUs per project per region", "metricDisplayName": "CPUs", "dimensionsInfo": [ { "dimensions": { "region": "us-central1" }, "details": { "quotaValue": 200, "resetValue": 200 }, "applicableLocations": [ "us-central1", ] }, { "details": { "quotaValue": 100, "resetValue": 100 }, "applicableLocations": [ "us-central2", "us-west1", "us-east1" ] } ] }
Questo output include i seguenti valori:
PROJECT_NUMBER
: un identificatore unico generato automaticamente per il progetto.
Impostare una quota globale
Il seguente esempio di risorsa QuotaInfo
mostra una quota tariffaria con un intervallo di aggiornamento
minuto. Le dimensioni sono vuote, il che indica che si tratta di una quota globale. Tutte le quote senza una dimensione regione o zona sono globali.
{ "name": "projects/PROJECT_NUMBER /locations/global/services/compute.googleapis.com/quotaInfos/ReadRequestsPerMinutePerProject", "quotaId": "ReadRequestsPerMinutePerProject", "metric": "compute.googleapis.com/read_requests", "refreshInterval": "minute", "containerType": "PROJECT", "dimensions": [], "isPrecise": false, "quotaDisplayName": "Read Requests per Minute", "metricDisplayName": "Read Requests", "dimensionsInfo": [ { "details": { "quotaValue": 100, "resetValue": 200 }, "applicableLocations": [ "global" ] } ] }
Questo output include i seguenti valori:
PROJECT_NUMBER
: un identificatore unico generato automaticamente per il progetto.
Per ulteriori dettagli sulla risorsa QuotaInfo
, consulta la documentazione di riferimento dell'API Cloud Quotas.
Per ulteriori dettagli sulle query QuotaPreference
, consulta
Implementare casi d'uso comuni.
Impostazioni di aggiustamento delle quote
La risorsa QuotaAdjusterSettings
(Anteprima) rappresenta le impostazioni di aggiustamento della quota per un determinato progetto. Se abilitato,
l'aggiustamento delle quote monitora l'utilizzo delle risorse specificate e invia
richieste di aggiustamento della quota quando l'utilizzo delle risorse si avvicina al valore della quota.
Per visualizzare le impostazioni attuali dell'aggiustamento della quota per un progetto, utilizza un'operazione GET per recuperare la risorsa
QuotaAdjusterSettings
.Per attivare l'aggiustamento della quota per un progetto, utilizza un'operazione PATCH per impostare le seguenti opzioni della risorsa
QuotaAdjusterSettings
:"quota_adjuster_settings" :{ "name": "projects/
PROJECT_NUMBER /locations/global/quotaAdjusterSettings", "enablement": ENABLED, }Sostituisci
PROJECT_NUMBER
con l'identificatore univoco del tuo progetto.
Per informazioni dettagliate, consulta Attivare l'aggiustamento della quota e Disattivare l'aggiustamento della quota.
Nomi delle risorse
Le risorse sono entità denominate e sono identificate dai relativi nomi. I nomi delle risorse vengono utilizzati in tutte le richieste e le risposte e ogni risorsa deve avere un nome univoco. Ogni nome della risorsa è codificato da un insieme di campi.
Risorsa preferenza quota
La convenzione di denominazione per una risorsa QuotaPreference
utilizza il seguente pattern:
projects/PROJECT_NUMBER /locations/global/quotaPreferences/QUOTA_PREFERENCE_ID
Puoi impostare quotaPreferenceId
quando crei una preferenza di quota, altrimenti viene generato un ID. È consigliabile che uno schema di denominazione quotaPreferenceId
codifichi il nome del servizio, l'ID quota, la località e altre dimensioni. quotaPreferenceId
deve essere univoco per il progetto, la cartella o le organizzazioni.
Ad esempio, quotaPreference
un pattern per codificare l'ID preferenza quota è il seguente:
SERVICE _LOCATION _DIMENSION1-VALUES-IN-ORDER
L'esempio seguente mostra questo pattern:
compute_us-central1_nvidia-200
Con un nome della risorsa, devi utilizzare il metodo
GET
per recuperare un QuotaPreference
. Puoi anche chiamare il metodo
PATCH
con l'opzione allow_missing
abilitata per creare o aggiornare un
QuotaPreference
.
Risorsa di informazioni sulla quota
La convenzione di denominazione per una risorsa QuotaInfo
utilizza il seguente pattern:
projects/PROJECT_NUMBER /locations/global/services/SERVICE_NAME /quotaInfos/QUOTA_ID
Risorsa per le impostazioni di Aggiustamento delle quote
La convenzione di denominazione per una risorsa QuotaAdjusterSettings
utilizza il seguente pattern:
projects/PROJECT_NUMBER /locations/global/quotaAdjusterSettings
Passaggi successivi
Documentazione di riferimento dell'API Cloud Quotas
Informazioni sulle quote