Trigger di Cloud Storage (1ª generazione.)

In Cloud Functions, un trigger di Cloud Storage consente di chiamare una funzione in risposta ai cambiamenti in Cloud Storage. Quando un trigger Cloud Storage per una funzione, scegli un evento digita e specifica un bucket Cloud Storage. La tua funzione verrà chiamata ogni volta che si verifica una modifica su un oggetto (file) all'interno del bucket specificato.

Sono supportati i seguenti tipi di eventi di Cloud Storage:

Evento Tipo di evento Descrizione
Oggetto finalizzato
  • google.storage.object.finalize
 Si verifica quando viene creato un nuovo oggetto o quando un oggetto esistente sovrascritto e ne viene creata una nuova generazione.
Oggetto eliminato
  • google.storage.object.delete
 Si verifica quando un oggetto viene eliminato definitivamente.
Oggetto archiviato
  • google.storage.object.archive
 Si verifica quando una versione live di un oggetto diventa una versione non corrente. Consulta Controllo delle versioni degli oggetti per ulteriori informazioni.
Metadati dell'oggetto aggiornati
  • google.storage.object.metadataUpdate
 Si verifica quando i metadati di un modifiche esistenti all'oggetto.

Affinché una funzione utilizzi un trigger di Cloud Storage, deve essere implementata come funzione basata su evento:

La Google Eventi contiene risorse aggiuntive per l'uso dei dati sugli eventi.

Deployment

Puoi specificare un trigger di Cloud Storage quando esegui il deployment di una funzione. Consulta Esegui il deployment di una funzione Cloud Functions per istruzioni generali su come eseguire il deployment di una funzione e vedi quanto segue per Informazioni aggiuntive specifiche per la configurazione dei trigger di Cloud Storage durante il deployment.

gcloud

Se con gcloud CLI, puoi utilizzare il tipo di evento Oggetto finalizzato di Cloud Storage con i seguenti flag:

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-bucket=YOUR_STORAGE_BUCKET \
[--retry] \
...
  • La --trigger-bucket specifica il bucket Cloud Storage che il trigger monitoraggio. Gli eventi finali dell'oggetto all'interno di questo bucket attiveranno le chiamate al tuo personalizzata.
  • La Controlli flag --retry se le chiamate di funzione non riuscite vengono ritentate automaticamente. Consulta Ripetere le funzioni basate su eventi per ulteriori informazioni.

Per utilizzare tipi di eventi diversi da Oggetto finalizzato, usa i seguenti flag:

  gcloud functions deploy YOUR_FUNCTION_NAME 

  --trigger-event=EVENT_TYPE 

  --trigger-resource=YOUR_STORAGE_BUCKET 

  ...

Eventi Cloud Storage legacy

Le funzioni legacy in Cloud Functions (1ª generazione.) utilizzano le applicazioni notifiche di modifica degli oggetti per i trigger di Cloud Storage:

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-event=providers/cloud.storage/eventTypes/object.change \
--trigger-resource=YOUR_STORAGE_BUCKET \
...

Questo tipo di evento è supportato per le funzioni legacy che già utilizzano questi eventi. Tuttavia, sconsigliamo di utilizzare questo tipo di evento perché potrebbe essere rimosso in una data futura.

Console

Se tramite la console Google Cloud, puoi configurare un trigger di Cloud Storage nella sezione Trigger:

  1. Nel campo Tipo di trigger, seleziona Cloud Storage.
  2. Nel campo Tipo di evento, seleziona un tipo di evento.
  3. Nel campo Bucket, fai clic su Sfoglia per selezionare una Bucket Cloud Storage da monitorare con il trigger. Modifiche a all'interno di questo bucket attiveranno le chiamate alla tua funzione.
  4. Seleziona o deseleziona la casella di controllo Riprova in caso di errore per controllare se le chiamate di funzione non riuscite vengono ritentate automaticamente. Consulta Ripetere le funzioni basate su eventi per ulteriori informazioni.

Consegna di eventi

I trigger di Cloud Storage sono implementati Notifiche Pub/Sub per Cloud Storage. Gli eventi sono soggetti a Garanzie di consegna delle notifiche Pub/Sub.

Un bucket Cloud Storage può avere fino a 10 configurazioni di notifica per un evento specifico. Superamento dei limiti di notifiche del bucket causerà l'errore di ulteriori deployment della funzione, con un errore come il seguente:

Cloud Storage bucket ...: Pub/Sub notification limit reached

Per saperne di più, consulta Quote e limiti di Cloud Storage.

Passaggi successivi