Quote

Questo documento descrive i limiti di quota per le funzioni Cloud Run.

Per aumentare le quote oltre i valori predefiniti elencati qui, vai alla pagina Quote di Cloud Run, seleziona le quote che vuoi modificare, fai clic su Modifica quote, fornisci le tue informazioni utente se richieste e immetti il nuovo limite per ogni quota selezionata.

Le quote per le funzioni Cloud Run comprendono quattro aree:

• Limiti di risorse

  Riguardano la quantità totale di risorse che le tue funzioni possono consumare.

• Limiti di tempo

  Riguardano i tempi di esecuzione.

• Limitazioni di frequenza

  Questi parametri influiscono sulla frequenza con cui puoi chiamare l'API Cloud Run Functions per gestire le tue funzioni.

• Limiti di rete

  Questi influiscono sui limiti di istanze e connessioni in uscita.

I diversi tipi di limiti sono descritti più dettagliatamente di seguito. Le differenze tra i limiti per le funzioni Cloud Run (1ª generazione) e le funzioni Cloud Run (2ª generazione.) sono indicate, se applicabili.

Limiti di risorse

I limiti di risorse influiscono sulla quantità totale di risorse che le tue funzioni possono consumare. L'ambito regionale è per progetto e ogni progetto ha i propri limiti.

Quota	Descrizione	Limit (1ª gen.)	Limit (2ª gen.)	Aumentabile	Ambito
Numero di funzioni	Il numero totale di funzioni di cui può essere eseguito il deployment per area geografica	1000	1000 meno il numero di servizi Cloud Run di cui è stato eseguito il deployment	No	per area geografica
Dimensione massima del deployment	La dimensione massima di un singolo deployment di funzioni	100 MB (compressi) per origini. 500 MB (non compressi) per origini più moduli.	N/D	No	per funzione
Dimensione massima della richiesta HTTP non compressa	Dati inviati a funzioni HTTP in una richiesta HTTP	10 MB	32 MB	No	per chiamata
Dimensione massima della risposta HTTP non compressa	Dati inviati da funzioni HTTP in una risposta HTTP	10 MB	10 MB per le risposte dinamiche. 32 MB per le risposte non dinamiche.	No	per chiamata
Dimensione massima dell'evento per le funzioni basate su eventi	Dati inviati in eventi alle funzioni in background	10 MB	512 KB per gli eventi Eventarc. 10 MB per gli eventi precedenti.	No	per evento
Memoria massima della funzione	Quantità di memoria utilizzabile da ogni istanza di funzione	8 GB	32 GB	No	per funzione
Memoria massima del progetto	Quantità di memoria, in byte, che un progetto può utilizzare. Viene misurata dalla somma totale della memoria richiesta dagli utenti nelle istanze di funzione in un periodo di 1 minuto.	Dipende dalla regione selezionata. Questo limite potrebbe essere maggiore nelle regioni ad alta capacità o inferiore nelle regioni aperte di recente.	N/D	Sì	per progetto e regione
CPU massima del progetto	Quantità di CPU, in milli vCPU, che un progetto può utilizzare. Viene misurata dalla somma totale della CPU richiesta dagli utenti nelle istanze di funzione in un periodo di 1 minuto.	Dipende dalla regione selezionata. Questo limite potrebbe essere maggiore nelle regioni ad alta capacità o inferiore nelle regioni aperte di recente.	N/D	Sì	per progetto e regione

Nota: se attivi una funzione utilizzando Pub/Sub, tramite funzioni basate su eventi o come target HTTP di un abbonamento push, tieni presente che i messaggi Pub/Sub sono codificati in base64. Un messaggio Pub/Sub di 10 MB, ovvero la dimensione massima supportata, è più grande di 10 MB dopo la codifica e può quindi superare il limite di dimensione massima delle funzioni Cloud Run.

Limiti di tempo

Quota	Descrizione	Limit (1ª gen.)	Limit (2ª gen.)	Aumentabile	Ambito
Durata massima della funzione	La quantità massima di tempo in cui una funzione può essere eseguita prima di essere interrotta forzatamente	540 secondi	60 minuti per le funzioni HTTP. 9 minuti per le funzioni basate su eventi.	No	per chiamata

Limitazioni di frequenza

Quota	Descrizione	Limit (1ª gen.)	Limit (2ª gen.)	Aumentabile	Ambito
Chiamate API (READ)	Chiamate per descrivere o elencare le funzioni tramite l'API Cloud Run Functions	5000 per 100 secondi	1200 per 60 secondi	Solo per la 1ª gen.	per progetto (1ª gen.) per regione (2ª gen.)
Chiamate API (WRITE)	Chiamate per eseguire il deployment o eliminare funzioni tramite l'API Cloud Run Functions	80 per 100 secondi	60 per 60 secondi	No ^1	per progetto (1ª gen.) per regione (2ª gen.)
Chiamate API (CALL)	Chiamate all'API "call"	16 per 100 secondi	N/D	No ^2	per progetto

¹Non puoi aumentare la quota WRITE. Una quota insufficiente è in genere dovuta a una delle seguenti cause:

• Utilizzo di un sistema CI/CD che esegue il deployment di molte funzioni contemporaneamente o sequenzialmente ad alta frequenza.
• Utilizzo dell'interfaccia a riga di comando di Firebase per eseguire il deployment di più funzioni contemporaneamente.

In ogni caso, è possibile evitare di raggiungere questa quota modificando la frequenza dei deployment. Ad esempio, se esegui il deployment utilizzando l'interfaccia a riga di comando di Firebase, utilizza il flag --only per eseguire il deployment delle singole funzioni.

² L'API CALL si applica solo alle funzioni Cloud Run (1ª generazione.). Non puoi aumentare la quota CALL. Una quota insufficiente è in genere dovuta all'uso errato di questa API per richiamare le funzioni in produzione. Tieni presente che questa API è progettata per i test con la console Google Cloud o l'interfaccia a riga di comando gcloud functions call e non può gestire il traffico intenso.

Limiti di rete

Per informazioni sui limiti di larghezza di banda e sulle richieste di rete di Cloud Run Functions (2ª generazione.), consulta Limiti di rete.

I seguenti limiti di rete si applicano alle funzioni Cloud Run (1ª generazione.):

• Connessioni in uscita al secondo per istanza: 500 (non possono essere aumentate)
• Risoluzioni DNS in uscita al secondo per istanza: 100 (non può essere aumentato)

Scalabilità

Le funzioni Cloud Run richiamate da HTTP fanno lo scale up per gestire il traffico in entrata in tempi rapidi, mentre le funzioni in background lo fanno in modo più graduale. La capacità di una funzione di fare lo scale up è determinata da alcuni fattori, tra cui:

• Il tempo necessario per completare l'esecuzione di una funzione (le funzioni a breve esecuzione possono in genere scalare verticalmente per gestire più richieste in parallelo).
• Il tempo necessario per inizializzare una funzione con avvio a freddo.
• La frequenza di errori della tua funzione.

• Fattori temporanei, come il carico a livello di area geografica e la capacità del data center.

• La configurazione come definita da istanze minime, istanze massime e contemporaneità (la contemporaneità è solo di 2ª generazione.).

Le funzioni in background hanno limiti aggiuntivi, come illustrato di seguito.

Questi limiti non si applicano alle funzioni HTTP di 1ª generazione. Il limite massimo di istanze predefinito per le funzioni HTTP di 2ª generazione è 100 e può essere aumentato a 1000. Non esiste un limite predefinito per il numero massimo di istanze per le funzioni HTTP di 1ª generazione. Per evitare eventi di ridimensionamento illimitati con le funzioni HTTP di 1ª generazione, ti consigliamo di impostare un limite, ad esempio 3000.

Quote aggiuntive per le funzioni in background

Quota	Descrizione	Limite	Aumentabile	Ambito	Versione del prodotto
Numero massimo di chiamate simultanee	Il numero massimo di chiamate simultanee di una singola funzione Esempio: se la gestione di ogni evento richiede 100 secondi, la frequenza di chiamata sarà limitata in media a 30 al secondo	3000	Sì	per funzione	Solo 1ª gen.
Frequenza di chiamata massima	La frequenza massima di eventi gestiti da una singola funzione Esempio: se la gestione di un evento richiede 100 ms, la frequenza di chiamata sarà limitata a 1000 al secondo anche se in media vengono gestite in parallelo solo 100 richieste	1000 al secondo	No	per funzione	Solo 1ª gen.
Dimensione massima dei dati degli eventi simultanei	La dimensione totale massima degli eventi in entrata per le chiamate simultanee di una singola funzione Esempio: se gli eventi hanno una dimensione di 1 MB e la loro elaborazione richiede 10 secondi, la frequenza media sarà di 1 evento al secondo, perché l'undicesimo evento non verrà elaborato fino a quando non terminerà l'elaborazione di uno dei primi 10 eventi	10 MB	No	per funzione	1ª e 2ª gen.
Velocità effettiva massima degli eventi in entrata	La velocità effettiva massima degli eventi in entrata in una singola funzione Esempio: se gli eventi hanno una dimensione di 1 MB, la frequenza di chiamata può essere al massimo di 10 al secondo, anche se le funzioni terminano entro 100 ms	10 MB al secondo	No	per funzione	1ª e 2ª gen.

Raggiungimento di un limite di quota

Quando una funzione consuma completamente una risorsa allocata, questa non sarà più disponibile fino a quando la quota non viene aggiornata o aumentata. Ciò può causare il blocco della funzione e di tutte le altre funzioni dello stesso progetto fino all'aggiornamento o all'aumento della quota. Una funzione restituisce un codice di errore HTTP 500 quando una delle risorse ha superato la quota e la funzione non può essere eseguita.

Per aumentare le quote oltre i valori predefiniti elencati qui, vai alla pagina Quote di Cloud Run, seleziona le quote che vuoi modificare, fai clic su Modifica quote, fornisci le tue informazioni utente se richieste e immetti il nuovo limite per ogni quota selezionata.