Quote e limiti

Questa pagina descrive i limiti di quota per API Gateway.

Limiti relativi ad API, configurazioni API e gateway

API Gateway applica i seguenti limiti alle API, alle configurazioni API e ai gateway:

  • API - 50 in totale
  • Configurazioni API - 100 per API
  • Gateway - 50 per regione

Se tenti di creare una seconda configurazione API prima che venga completata la creazione della prima configurazione API per la stessa API, una o entrambe le configurazioni potrebbero non essere disponibili per un utilizzo successivo in un gateway.

Limiti di frequenza delle richieste

Per impostazione predefinita si applica una limitazione di frequenza di 10.000.000 di unità di quota ogni 100 secondi per progetto di producer di servizi. Viene consumata un'unità di quota per ogni chiamata a services.check e per ogni operazione segnalata tramite services.report.

Limiti di dimensione del payload

I seguenti limiti si applicano in modo specifico alla dimensione massima del payload per il traffico tramite gateway di cui è stato eseguito il deployment:

Limite Quantità
Dimensioni richiesta 32 megabyte
Dimensione della risposta 32 megabyte
Dimensioni della risposta di transcodifica gRPC 1 megabyte
Dimensioni della richiesta di transcodifica gRPC 1 megabyte

Lo streaming non è supportato.

Limiti di dimensione delle intestazioni

I seguenti limiti si applicano in modo specifico alla dimensione massima dell'intestazione per il traffico tramite gateway di cui è stato eseguito il deployment:

Limite Importo
Dimensioni delle intestazioni delle richieste 60 kilobyte

Il servizio di backend chiamato da API Gateway potrebbe avere limiti inferiori.

Come aumentare la quota

Le richieste di adeguamento delle quote cloud sono soggette a revisione. Se la richiesta di adeguamento della quota richiede la revisione, riceverai un'email di conferma della ricezione della richiesta. Se hai bisogno di ulteriore assistenza, rispondi all'email. Dopo aver esaminato la richiesta, riceverai una notifica via email indicante se la richiesta è stata approvata. Puoi richiedere un aggiustamento della quota utilizzando la console Google Cloud , l'API Cloud Quotas o Google Cloud CLI. Le seguenti istruzioni mostrano come richiedere un nuovo valore di quota utilizzando la console Google Cloud o effettuando una richiesta REST all'API Cloud Quotas.

Console

Per richiedere una modifica della quota:

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

    Vai a Quote e Limiti di sistema

    Se ti viene chiesto di selezionare un progetto, seleziona quello che vuoi modificare.

  2. Trova la quota che vuoi modificare e apri la finestra di dialogo Modifiche alla quota:

    • Quote non presenti nella tabella:

      • Cerca la quota nella casella di ricerca Filtra. Non specificare la regione o la zona (se applicabile) perché le quote che non hanno valori di utilizzo o aggiustati non vengono visualizzate nella tabella.
      • Individua eventuali voci relative alla tua quota nella tabella. Può essere la voce predefinita o qualsiasi voce con cronologia, indipendentemente dalla regione o dalla zona.
      • Nella riga della voce, fai clic su Altre azioni > Configura regioni/zone aggiuntive.
      • Seleziona la regione o la zona che vuoi regolare. Fai clic su Modifica.

    • Tutte le altre quote:

      • Cerca la quota nella casella di ricerca Filtra.
      • Nella riga relativa alla voce, seleziona la casella di controllo per la quota.
      • Fai clic su Modifica.

    Viene visualizzata la finestra di dialogo Modifiche alla quota.

  3. Se sopra il campo Nuovo valore vedi un link a Richiedi una quota più alta e vuoi aumentare il valore della quota oltre il numero indicato sullo schermo, segui il link. Compila il modulo, invialo e salta i passaggi rimanenti. In caso contrario, continua a seguire questa guida.

  4. Nel campo Nuovo valore, inserisci il valore della quota aumentata che vuoi. Se viene visualizzato un campo Descrizione della richiesta, inserisci una descrizione. Fai clic su Fine.

    • Se vedi una casella di controllo con il testo "Sono consapevole che questa richiesta rimuoverà eventuali override", il valore della quota è impostato al di sotto del valore predefinito. Se il valore della quota viene impostato su un valore uguale o superiore a quello predefinito, l'override viene rimosso. Per continuare, seleziona la casella di controllo. Scopri di più sugli override della quota.

    Se viene visualizzato un pulsante Avanti, fai clic su Avanti e compila i dati di contatto nella schermata successiva.

  5. Fai clic su Invia richiesta.

Se non riesci a richiedere un adeguamento dalla console, richiedi l'aumento all'assistenza clienti Google Cloud.

Per scoprire di più su come funziona la procedura di aumento della quota, vedi Informazioni sugli aggiustamenti delle quote.

Creazione di batch di richieste per gli aggiustamenti delle quote

Puoi creare richieste batch per gli aggiustamenti delle quote selezionando la casella di controllo per ogni quota da includere. Tuttavia, la creazione di richieste batch può aumentare il tempo necessario a Google Cloud per esaminare la tua richiesta.

Per ridurre i tempi di revisione, raggruppa le richieste di adeguamento della quota per prodotto e area. Ad esempio, se vuoi richiedere adeguamenti alle quote di networking e di VM di Compute Engine, crea una richiesta per le quote di networking e un'altra per le quote di VM di Compute Engine.

REST

Per richiedere un aggiustamento della quota dall'API Cloud Quotas, utilizza il seguente esempio di codice. Compila i segnaposto modificabili con i tuoi valori. Per informazioni sui campi segnaposto, consulta le descrizioni che seguono l'esempio di codice.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Sostituisci quanto segue:

  • PROJECT_NUMBER: il tuo numero di progetto Google Cloud . Puoi trovare il numero di progetto nella pagina Benvenuto della console Google Cloud o eseguendo il seguente comando gcloud CLI:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID: l'ID della preferenza di quota che stai aggiornando.

  • QUOTA_ID: l'ID della quota che stai aggiornando.

  • SERVICE_ID: l'ID di Google Cloud a cui appartiene la quota che stai modificando. Di solito ha il formato SERVICE_NAME.googleapis.com. Ad esempio, il nome del servizio Compute Engine è compute.googleapis.com.

  • DIMENSION_1: il tipo di dimensione che vuoi modificare, ad esempio region o zone. Puoi includere più dimensioni. Separa ogni dimensione seguendo il suo valore, ad esempio VALUE_1, con una virgola. Per modificare tutte le dimensioni della quota, ometti questa riga.

  • VALUE_1: Il valore della dimensione precedente. Ad esempio, se la dimensione precedente è region, inserisci una regione come us-central1.

  • JUSTIFICATION: Il motivo di questa richiesta.

  • EMAIL: un indirizzo email che può essere utilizzato come contatto, nel caso in cui Google Cloud abbia bisogno di ulteriori informazioni per prendere una decisione prima di poter concedere una quota aggiuntiva.

Esempio di richiesta

Di seguito è riportato un esempio di richiesta di aumento del valore della quota per la quota di Compute Engine PUS-PER-GPU-FAMILY-per-project-region. Richiede un valore di quota di 100 per le macchine della famiglia di GPU NVIDIA_H100 che si trovano nella regione us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}