Quote

Questo documento descrive i limiti di quota di Google Cloud Functions.

Per aumentare le quote oltre i valori predefiniti elencati qui, vai alla pagina Quote di Cloud Functions, 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 di Google Cloud Functions comprendono tre 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 influiscono sulla frequenza con cui puoi chiamare l'API Cloud Functions per gestire le tue funzioni.

I diversi tipi di limiti sono descritti più dettagliatamente di seguito. Le differenze tra i limiti per Cloud Functions (1ª generazione) e Cloud Functions (2nd gen) sono indicate dove applicabili.

Limiti delle risorse

I limiti delle risorse influiscono sulla quantità totale di risorse che le funzioni possono utilizzare. L'ambito a livello di regione è per progetto e ogni progetto mantiene i propri limiti.

Quota	Descrizione	Limite (1ª generazione)	Limite (2ª generazione)	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/A	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 risposte dinamiche. 32 MB per risposte non in streaming.	No	per chiamata
Dimensione massima degli eventi per le funzioni basate su eventi	Dati inviati in eventi alle funzioni in background	10 MB	512 kB per eventi Eventarc. 10 MB per gli eventi legacy.	No	per evento
Memoria massima della funzione	Quantità di memoria utilizzabile da ciascuna istanza di funzione	8GiB	32GiB	No	per funzione

Nota: se attivi una funzione utilizzando Pub/Sub, tramite funzioni basate su eventi o come destinazione HTTP di una sottoscrizione push, tieni presente che i messaggi Pub/Sub sono con codifica base64. Un messaggio Pub/Sub da 10 MB, le dimensioni massime supportate, supera i 10 MB una volta codificato e può quindi superare il limite di dimensione massima di Cloud Functions.

Limiti di tempo

Quota	Descrizione	Limite (1ª generazione)	Limite (2ª generazione)	Aumentabile	Ambito
Durata massima della funzione	Il periodo di tempo massimo durante il quale una funzione può essere eseguita prima di essere terminata 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	Limite (1ª generazione)	Limite (2ª generazione)	Aumentabile	Ambito
Chiamate API (READ)	Chiamate per descrivere o elencare le funzioni tramite l'API Cloud Functions	5000 per 100 secondi	1200 per 60 secondi	Solo per 1ª generazione	per progetto (1ª generazione) per regione (2ª generazione)
Chiamate API (WRITE)	Chiamate per eseguire il deployment o eliminare funzioni tramite l'API Cloud Functions	80 per 100 secondi	60 ogni 60 secondi	No ^1	per progetto (1ª generazione) per regione (2ª generazione)
Chiamate API (CALL)	Chiamate all'API "call"	16 per 100 secondi	N/A	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 velocità.
• 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 a Cloud Functions (1ª generazione). Non puoi aumentare la quota CALL. Una quota insufficiente in genere si verifica se utilizzi erroneamente questa API per richiamare le tue funzioni in produzione. Tieni presente che questa API è progettata per i test tramite Cloud Console o l'interfaccia a riga di comando gcloud functions call e non può gestire il traffico intenso.

Scalabilità

Le funzioni Cloud Functions 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 fare lo scale up 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 tua configurazione è definita da numero minimo di istanze, numero massimo di istanze e contemporaneità (la contemporaneità è solo di 2ª generazione).

Le funzioni in background hanno limiti aggiuntivi, come spiegato 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 massimo di istanze predefinito per le funzioni HTTP di 1ª generazione. Per evitare un numero illimitato di eventi di scalabilità 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ª generazione.
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ª generazione.
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ª generazione e 2ª generazione
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ª generazione e 2ª generazione

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 Functions, 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.