Cloud Storage supporta lo streaming di dati in un bucket senza richiedere che i dati vengano prima salvati in un file. Questa opzione è utile quando vuoi caricare dati, ma non conosci le dimensioni finali all'inizio del caricamento, ad esempio quando generi i dati di caricamento da un processo o quando comprimi un oggetto in tempo reale.
Utilizzo della convalida del checksum durante lo streaming
Poiché un checksum può essere fornito solo nella richiesta iniziale di un caricamento, spesso non è possibile utilizzare la convalida del checksum di Cloud Storage durante lo streaming. Ti consigliamo di utilizzare sempre la convalida del checksum e puoi farlo manualmente al termine di un caricamento in streaming. Tuttavia, se esegui la convalida al termine del trasferimento, gli eventuali dati danneggiati sono accessibili durante il tempo necessario per confermare la corruzione e rimuoverla.
Se hai bisogno della convalida del checksum prima del completamento del caricamento e della disponibilità dei dati, non devi utilizzare un caricamento in streaming. Devi utilizzare un'opzione di caricamento diversa che esegua la convalida del checksum prima di finalizzare l'oggetto.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per lo streaming dei caricamenti, chiedi all'amministratore di concederti uno dei seguenti ruoli:
Per i caricamenti che includono un blocco di conservazione degli oggetti, chiedi all'amministratore di concederti il ruolo IAM Amministratore oggetti Storage (
roles/storage.objectAdmin
) per il bucket.In tutti gli altri casi, chiedi all'amministratore di concederti il ruolo IAM Utente oggetti archiviazione (
roles/storage.objectUser
) per il bucket.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire lo streaming dei caricamenti su Cloud Storage. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.objects.create
storage.objects.delete
- Questa autorizzazione è necessaria solo per i caricamenti che sovrascrivono un oggetto esistente.
storage.objects.list
- Questa autorizzazione è necessaria solo per utilizzare lGoogle Cloud CLI per eseguire le istruzioni riportate in questa pagina.
storage.objects.setRetention
- Questa autorizzazione è obbligatoria solo per i caricamenti che includono un blocco della conservazione degli oggetti.
Puoi anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per informazioni sulla concessione dei ruoli ai bucket, consulta Utilizzare IAM con i bucket.
Caricare un video in streaming
Gli esempi riportati di seguito mostrano come eseguire un caricamento in streaming da un processo a un oggetto Cloud Storage:
Console
La console Google Cloud non supporta i caricamenti in streaming. Utilizza invece gcloud CLI.
Riga di comando
Invia i dati al comando
gcloud storage cp
e utilizza un trattino per l'URL di origine:PROCESS_NAME | gcloud storage cp - gs://BUCKET_NAME/OBJECT_NAME
Dove:
PROCESS_NAME
è il nome del processo da cui stai raccogliendo i dati. Ad esempio,collect_measurements
.BUCKET_NAME
è il nome del bucket contenente l'oggetto. Ad esempio,my_app_bucket
.OBJECT_NAME
è il nome dell'oggetto creato dai dati. Ad esempio,data_measurements
.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
API REST
API JSON
Per eseguire un caricamento in streaming, utilizza uno dei seguenti metodi:
Un caricamento ripristinabile, con le seguenti modifiche:
Quando carichi i dati del file, utilizza un caricamento in più blocchi.
Poiché non conosci le dimensioni totali del file finché non arrivi al frammento finale, utilizza un
*
per le dimensioni totali del file nell'intestazioneContent-Range
dei frammenti intermedi.Ad esempio, se il primo chunk che carichi ha una dimensione di 512 KiB, l'intestazione
Content-Range
del chunk èbytes 0-524287/*
. Se al termine del primo chunk rimangono 64000 byte da caricare, invia un chunk finale contenente i byte rimanenti e con un'intestazioneContent-Range
con il valorebytes 524288-588287/588288
.
Un caricamento con una singola richiesta, con i seguenti aggiustamenti:
Includi un'intestazione
Transfer-Encoding: chunked
ed escludi l'intestazioneContent-Length
.Costruisci la richiesta in base alla specifica, inviando i dati dell'oggetto a blocchi man mano che diventano disponibili.
API XML
Per eseguire un caricamento in streaming, utilizza uno dei seguenti metodi:
Un caricamento ripristinabile, con le seguenti modifiche:
Quando carichi i dati del file, utilizza un caricamento in più blocchi.
Poiché non conosci le dimensioni totali del file finché non arrivi al frammento finale, utilizza un
*
per le dimensioni totali del file nell'intestazioneContent-Range
dei frammenti intermedi.Ad esempio, se il primo chunk che carichi ha una dimensione di 512 KiB, l'intestazione
Content-Range
del chunk èbytes 0-524287/*
. Se al termine del primo chunk rimangono 64000 byte da caricare, invia un chunk finale contenente i byte rimanenti e con un'intestazioneContent-Range
con il valorebytes 524288-588287/588288
.
Un caricamento con una singola richiesta, con i seguenti aggiustamenti:
Includi un'intestazione
Transfer-Encoding: chunked
ed escludi l'intestazioneContent-Length
.Costruisci la richiesta in base alla specifica, inviando i dati dell'oggetto a blocchi man mano che diventano disponibili.
Tieni presente che non puoi eseguire un caricamento in streaming utilizzando questo metodo se la richiesta utilizza una firma nell'intestazione
Authorization
.
Passaggi successivi
- Riproduci in streaming un download.
- Scopri di più sulla transcodifica decompressiva.
- Scopri di più su caricamenti e download.