Caricare oggetti da un file system

Questa pagina mostra come caricare oggetti nel bucket Cloud Storage dal file system locale. Un oggetto caricato è costituito dai dati che vuoi archiviare insieme a eventuali metadati associati. Per una panoramica concettuale, inclusa la procedura per scegliere il metodo di caricamento ottimale in base alle dimensioni del file, consulta Caricamenti di oggetti.

Per istruzioni sul caricamento dalla memoria, vedi Caricare oggetti dalla memoria.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per caricare oggetti in un bucket, chiedi all'amministratore di concederti il ruolo IAM Utente oggetti Storage (roles/storage.objectUser) sul bucket. Questo ruolo predefinito contiene le autorizzazioni necessarie per caricare un oggetto in un bucket. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

  • storage.objects.create
  • storage.objects.delete
    • Questa autorizzazione è necessaria solo per i caricamenti che sovrascrivono un oggetto esistente.
  • storage.objects.get
    • Questa autorizzazione è necessaria solo se prevedi di utilizzare Google Cloud CLI per eseguire le attività descritte in questa pagina.
  • storage.objects.list
    • Questa autorizzazione è necessaria solo se prevedi di utilizzare Google Cloud CLI per eseguire le attività descritte in questa pagina. Questa autorizzazione è necessaria anche se vuoi utilizzare la console Google Cloud per verificare gli oggetti che hai caricato.

Se prevedi di utilizzare la console Google Cloud per eseguire le attività descritte in questa pagina, devi disporre anche dell'autorizzazione storage.buckets.list, che non è inclusa nel ruolo Utente oggetti Storage (roles/storage.objectUser). Per ottenere questa autorizzazione, chiedi all'amministratore di concederti il ruolo Storage Admin (roles/storage.admin) nel progetto.

Puoi anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.

Per informazioni sulla concessione dei ruoli sui bucket, consulta Impostare e gestire le policy IAM sui bucket.

Caricare un oggetto in un bucket

Per caricare un oggetto in un bucket:

Console

  1. Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket in cui vuoi caricare un oggetto.

  3. Nella scheda Oggetti del bucket:

    • Trascina i file dal desktop o dal gestore di file nel riquadro principale della console Google Cloud .

    • Fai clic su Carica > Carica file, seleziona i file da caricare nella finestra di dialogo che viene visualizzata, poi fai clic su Apri.

Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud , consulta Risoluzione dei problemi.

Riga di comando

Utilizza il comando gcloud storage cp:

gcloud storage cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME

Dove:

  • OBJECT_LOCATION è il percorso locale dell'oggetto. Ad esempio, Desktop/dog.png.

  • DESTINATION_BUCKET_NAME è il nome del bucket in cui stai caricando l'oggetto. Ad esempio, my-bucket.

Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:

Completed files 1/1 | 164.3kiB/164.3kiB

Puoi impostare i metadati degli oggetti personalizzati e a chiave fissa nell'ambito del caricamento degli oggetti utilizzando i flag dei comandi.

Librerie client

C++

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client. 

namespace gcs = ::google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& file_name,
   std::string const& bucket_name, std::string const& object_name) {
  // Note that the client library automatically computes a hash on the
  // client-side to verify data integrity during transmission.
  StatusOr<gcs::ObjectMetadata> metadata = client.UploadFile(
      file_name, bucket_name, object_name, gcs::IfGenerationMatch(0));
  if (!metadata) throw std::move(metadata).status();

  std::cout << "Uploaded " << file_name << " to object " << metadata->name()
            << " in bucket " << metadata->bucket()
            << "\nFull metadata: " << *metadata << "\n";
}

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage