Questa pagina mostra come caricare e scaricare oggetti nei bucket di archiviazione dell'appliance air-gap di Google Distributed Cloud (GDC) e da questi.
Prima di iniziare
Uno spazio dei nomi del progetto gestisce le risorse bucket nel server API Management. Devi avere un progetto per lavorare con bucket e oggetti.
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
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
Il seguente comando carica tutti i file di testo dalla directory locale a un bucket:
gdcloud storage cp *.txt s3://BUCKET
Il seguente comando carica più file dalla directory locale a un bucket:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
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://BUCKET --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
Per ottenere gli oggetti dal bucket:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
Per scaricare tutti i file di testo da un bucket nella directory corrente:
gdcloud storage cp s3://BUCKET/*.txt .
Per scaricare il file di testo abc.txt
da un bucket nella directory corrente:
gdcloud storage cp s3://BUCKET/abc.txt .
Per scaricare una versione precedente del file, elenca prima tutte le versioni del file:
gdcloud storage ls s3://BUCKET/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://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .