Caricare e scaricare oggetti di archiviazione nei progetti

Questa pagina mostra come caricare e scaricare oggetti da e verso i bucket di archiviazione isolati di Google Distributed Cloud (GDC).

Prima di iniziare

Uno spazio dei nomi del progetto gestisce le risorse bucket nel server API Management. Per utilizzare bucket e oggetti, devi disporre di un progetto.

Devi inoltre disporre delle autorizzazioni del bucket appropriate per eseguire la seguente operazione. Consulta Concedere l'accesso al bucket.

Linee guida per la denominazione degli oggetti

Segui queste linee guida per assegnare un nome agli oggetti:

  • Utilizza i caratteri UTF-8 per denominare gli oggetti.
  • Evita di includere informazioni che consentono l'identificazione personale (PII).

Caricare oggetti nei bucket di archiviazione

Console

  1. Nel menu di navigazione, fai clic su Object Storage.
  2. Fai clic sul nome del bucket in cui vuoi caricare l'oggetto.
  3. (Facoltativo) Se vuoi creare una cartella per archiviare l'oggetto, fai clic su Crea cartella > inserisci un nome per la cartella > fai clic su Crea.
  4. Fai clic direttamente su Carica file oppure vai alla cartella che hai appena creato e poi fai clic su Carica file.
  5. Seleziona il file che ti interessa e fai clic su Apri.
  6. Attendi il messaggio di conferma che indica che il caricamento è stato eseguito correttamente.

Interfaccia a riga di comando

Per caricare un oggetto, esegui questi comandi:

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH

I seguenti comandi richiedono FULLY_QUALIFIED_BUCKET_NAME. Utilizza il comando GET o DESCRIBE della sezione Visualizza configurazione bucket per ottenere il nome completo del bucket.

Il seguente comando carica tutti i file di testo dalla directory locale a un bucket:

gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME

Il seguente comando carica più file dalla directory locale a un bucket:

gdcloud storage cp abc1.txt abc2.txt s3://FULLY_QUALIFIED_BUCKET_NAME

Per caricare una cartella in un bucket, utilizza l'opzione --recursive per copiare un intero albero di directory. Il comando seguente carica la struttura ad albero della directory dir:

gdcloud storage cp dir s3://FULLY_QUALIFIED_BUCKET_NAME --recursive

Esegui caricamenti multiparte per oggetti di grandi dimensioni o utilizza caricamenti multiparte automaticamente quando devi caricare un file di dimensioni superiori a 15 MB. In questo caso, il file viene suddiviso in più parti, ciascuna di 15 MB. L'ultima parte è più piccola. Ogni parte viene caricata separatamente e ricostruita nella destinazione al termine del trasferimento.

Se il caricamento di una parte non va a buon fine, puoi riavviarlo senza influire sulle altre parti già caricate.

Esistono due opzioni relative ai caricamenti in più parti:

  • --disable-multipart: disattiva i caricamenti in più parti per tutti i file.
  • --multipart-chunk-size-mb=SIZE: imposta la dimensione di ogni blocco di un caricamento in più parti.

I file più grandi di SIZE vengono caricati automaticamente come multipart multithread. I file più piccoli vengono caricati utilizzando il metodo tradizionale. SIZE è in megabyte. La dimensione predefinita del segmento è 15 MB. La dimensione minima consentita del blocco è 5 MB e quella massima è 5 GB.

Scaricare oggetti dai bucket di archiviazione

Console

  1. Nel menu di navigazione, fai clic su Object Storage.
  2. Fai clic sul nome del bucket contenente gli oggetti.
  3. Seleziona la casella di controllo accanto al nome dell'oggetto da scaricare.
  4. Fai clic su Scarica.

Interfaccia a riga di comando

Per ottenere gli oggetti dal bucket:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/OBJECT LOCAL_FILE_TO_SAVE

Per scaricare tutti i file di testo da un bucket nella directory corrente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/*.txt .

Per scaricare il file di testo abc.txt da un bucket nella directory corrente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt .

Per scaricare una versione precedente del file, elenca prima tutte le versioni del file:

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt --all-versions

Output di esempio:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

Quindi, scarica una versione specifica del file di testo abc.txt dal bucket nella directory corrente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .

Utilizzare AEADKey personalizzata

Per una maggiore personalizzazione, puoi creare la tua AEADKey e utilizzarla direttamente durante la crittografia degli oggetti nel bucket. In questo modo avrai il pieno controllo della chiave di crittografia, ignorando quella predefinita. Segui la procedura descritta in Crea una chiave per creare una nuova AEADKey e assicurati che si trovi nello stesso Namespace del bucket che intendi utilizzare. Poi, ogni volta che invii la richiesta, assicurati che HEADER sia configurato con x-amz-server-side-encryption: SSE-KMS e x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME.