Una sottoscrizione Cloud Storage è un tipo di sottoscrizione di esportazione che scrive i messaggi man mano che vengono ricevuti in un bucket Cloud Storage esistente. Non è necessario configurare un client abbonato separato. Utilizza la console Google Cloud, Google Cloud CLI, le librerie client o l'API Pub/Sub per creare, aggiornare, elencare, scollegare o eliminare un abbonamento a Cloud Storage.
Senza il tipo di sottoscrizione Cloud Storage, è necessaria una sottoscrizione pull o push e un sottoscrittore (ad esempio 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 ulteriori elaborazioni prima dell'archiviazione in un bucket Cloud Storage. Puoi utilizzare una sottoscrizione Cloud Storage.
Tuttavia, è comunque consigliata una pipeline Dataflow per i sistemi Pub/Sub in cui è necessaria una trasformazione dei dati prima che i dati vengano archiviati in un bucket Cloud Storage.
Per scoprire come trasmettere flussi di dati da Pub/Sub a Cloud Storage con la trasformazione utilizzando Dataflow, vedi Trasmettere messaggi da Pub/Sub utilizzando Dataflow.
Prima di iniziare
Prima di leggere questo documento, assicurati di acquisire familiarità con quanto segue:
Come funziona Pub/Sub e i diversi termini di Pub/Sub.
Quali sono i diversi tipi di abbonamenti e perché potresti utilizzare un abbonamento Cloud Storage.
Come funziona Cloud Storage.
Flusso di lavoro della 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. Dopo il completamento 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 creazione dell'oggetto.
Il flusso di lavoro per scrivere un oggetto in un bucket Cloud Storage richiede due risposte
OK
. La prima rispostaOK
viene inviata quando un messaggio viene scritto in un oggetto. La seconda rispostaOK
viene inviata quando l'oggetto contenente il messaggio è stato finalizzato. Un messaggio diventa visibile nel bucket solo dopo che l'oggetto Cloud Storage che lo contiene è stato finalizzato correttamente.In caso di errori durante l'operazione di scrittura, il messaggio Pub/Sub stesso viene confermato negativamente. Il messaggio viene quindi inviato di nuovo. Se l'operazione di scrittura del messaggio ha esito negativo per un certo numero 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 a Cloud Storage, devi specificare alcune proprietà aggiuntive. Queste proprietà includono proprietà di sottoscrizione comuni, requisiti di nome file e formato, requisiti di archiviazione e altro ancora. Per saperne di più su queste proprietà, vedi Proprietà degli abbonamenti Cloud Storage.
Autorizzazioni per gli account di servizio Pub/Sub
Per creare una sottoscrizione Cloud Storage, l'account di servizio Pub/Sub deve disporre dell'autorizzazione per scrivere nel bucket Cloud Storage specifico e leggere i metadati del bucket.
Per maggiori informazioni, consulta Assegnare ruoli di Cloud Storage all'account di servizio Pub/Sub.
Gestire gli errori relativi ai messaggi
Quando un messaggio Pub/Sub non può essere scritto in un bucket Cloud Storage, il messaggio non può essere confermato. Per inoltrare questi messaggi non recapitabili, configura un argomento messaggi non recapitabili nella sottoscrizione Cloud Storage.
Quote
Le limitazioni di quota si applicano alla velocità effettiva dell'abbonato Cloud Storage per ogni regione. Per informazioni sulle quote per gli abbonamenti a Cloud Storage, consulta l'articolo sui limiti delle quote degli abbonati in Quote e limiti di Pub/Sub.
Prezzi
Per informazioni sui prezzi degli abbonamenti a Cloud Storage, consulta la pagina dei prezzi di Pub/Sub.
Passaggi successivi
Crea un abbonamento a Cloud Storage.
Esplora gli strumenti di configurazione di Pub/Sub: