Una sottoscrizione Cloud Storage è un tipo di sottoscrizione dell'esportazione che scrive i messaggi in un bucket Cloud Storage esistente alla ricezione. Non è necessario configurare un client sottoscrittore separato. Utilizza la console Google Cloud , Google Cloud CLI, le librerie client o l'API Pub/Sub per creare, aggiornare, elencare, scollegare o eliminare una sottoscrizione Cloud Storage.
Senza il tipo di sottoscrizione Cloud Storage, hai bisogno di una sottoscrizione pull o push e di un sottoscrittore (come Dataflow) che legga i messaggi e li scriva in un bucket Cloud Storage. L'overhead dell'esecuzione di un job Dataflow non è necessario quando i messaggi non richiedono un'elaborazione aggiuntiva prima dell'archiviazione in un bucket Cloud Storage. Puoi utilizzare una sottoscrizione Cloud Storage.
Per modifiche leggere a messaggi o attributi, puoi collegare una trasformazione di un singolo messaggio alla tua sottoscrizione Cloud Storage. Tuttavia, una pipeline Dataflow è consigliata per i sistemi Pub/Sub in cui è richiesta una trasformazione dei dati più complessa prima che i dati vengano archiviati in un bucket Cloud Storage, soprattutto se vuoi raggruppare o aggregare i messaggi.
Per scoprire come trasmettere dati in streaming da Pub/Sub a Cloud Storage con trasformazione utilizzando Dataflow, consulta Trasmetti flussi di messaggi da Pub/Sub utilizzando Dataflow.
Prima di iniziare
Prima di leggere questo documento, assicurati di conoscere quanto segue:
Come funziona Pub/Sub e i diversi termini di Pub/Sub.
Quali sono i diversi tipi di sottoscrizioni e perché potresti voler utilizzare una sottoscrizione Cloud Storage.
Come funziona Cloud Storage.
Flusso di lavoro di sottoscrizione Cloud Storage
L'immagine seguente mostra il flusso di lavoro tra un abbonamento Cloud Storage e Cloud Storage.

Figura 1. Flusso di lavoro per una sottoscrizione Cloud Storage
Ecco una breve descrizione del flusso di lavoro che fa riferimento alla Figura 1:
Pub/Sub utilizza l'API Cloud Storage per inviare dati al bucket Cloud Storage. Al termine di un'operazione di scrittura, l'API restituisce una risposta
OK.I messaggi vengono inviati in batch al bucket Cloud Storage. Un singolo batch corrisponde a un oggetto archiviato nel bucket Cloud Storage. Puoi configurare le impostazioni batch in base alle dimensioni dell'oggetto e al tempo trascorso dalla sua creazione.
Il workflow per scrivere un oggetto in un bucket Cloud Storage richiede due risposte
OK. La prima rispostaOKviene inviata quando un messaggio viene scritto correttamente in un oggetto. La seconda rispostaOKviene inviata quando l'oggetto contenente il messaggio viene finalizzato. Un messaggio diventa visibile nel bucket solo dopo che l'oggetto Cloud Storage che lo contiene è stato finalizzato correttamente.Se si verificano errori durante l'operazione di scrittura, il messaggio Pub/Sub stesso viene riconosciuto negativamente. Il messaggio viene quindi inviato di nuovo. Se l'operazione di scrittura del messaggio non va a buon fine un numero sufficiente di volte e hai configurato un argomento messaggi non recapitabili nella sottoscrizione, il messaggio viene spostato nell'argomento messaggi non recapitabili.
Proprietà di una sottoscrizione Cloud Storage
Quando crei una sottoscrizione Cloud Storage, devi specificare alcune proprietà aggiuntive. Queste proprietà includono proprietà comuni dell'abbonamento, requisiti di formato e nome file, requisiti di archiviazione e altro ancora. Per saperne di più su queste proprietà, consulta Proprietà delle sottoscrizioni Cloud Storage.
Gestire gli errori relativi ai messaggi
Quando non è possibile scrivere un messaggio Pub/Sub in un bucket Cloud Storage, non è possibile confermare la ricezione del messaggio. Per inoltrare questi messaggi non recapitabili, configura un argomento messaggi non recapitabili nella sottoscrizione Cloud Storage.
Se Pub/Sub non può scrivere messaggi in Cloud Storage, Pub/Sub ritarda la pubblicazione dei messaggi in modo simile al comportamento di backoff push.
Quote
Si applicano limitazioni di quota alla velocità effettiva del sottoscrittore di Cloud Storage per ogni regione. Per informazioni sulle quote per gli abbonamenti a Cloud Storage, consulta Limiti di quota per gli abbonati all'esportazione in Quote e limiti di Pub/Sub.
Prezzi
Per informazioni sui prezzi degli abbonamenti Cloud Storage, consulta la pagina dei prezzi di Pub/Sub.
Passaggi successivi
- Crea una sottoscrizione Cloud Storage.
Risolvi i problemi relativi a una sottoscrizione Cloud Storage.
Esplora gli strumenti di configurazione di Pub/Sub: