Questa pagina mostra come caricare e scaricare oggetti da e verso i bucket di archiviazione air-gapped di Google Distributed Cloud (GDC).
Prima di iniziare
Uno spazio dei nomi del progetto gestisce le risorse dei bucket nel server dell'API di gestione. Devi avere un progetto per lavorare con bucket e oggetti.
Devi anche disporre delle autorizzazioni del bucket appropriate per eseguire la seguente operazione. Consulta Concedere l'accesso al bucket.
Linee guida per la denominazione degli oggetti
Utilizza le seguenti linee guida per denominare gli oggetti:
- Utilizza i caratteri UTF-8 quando assegni un nome agli oggetti.
- La lunghezza deve essere compresa tra 1 e 55 caratteri.
- Evita di includere informazioni che consentono l'identificazione personale (PII).
Caricare oggetti nei bucket di archiviazione
Console
- Nel menu di navigazione, fai clic su Object Storage.
- Fai clic sul nome del bucket in cui vuoi caricare l'oggetto.
- (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.
- Fai clic direttamente su Carica file oppure vai alla cartella che hai appena creato e poi fai clic su Carica file.
- Seleziona il file che ti interessa e fai clic su Apri.
- Attendi il messaggio di conferma che indica che il caricamento è andato a buon fine.
gdcloud
Per caricare un oggetto, esegui i seguenti comandi:
gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME
gdcloud storage mv s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME
I seguenti comandi richiedono il FULLY_QUALIFIED_BUCKET_NAME. Utilizza il comando GET o DESCRIBE della sezione Visualizzare la configurazione del 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 seguente comando carica l'albero di directory dir:
gdcloud storage cp DIRECTORY_NAME s3://FULLY_QUALIFIED_BUCKET_NAME --recursive
Esegui caricamenti multiparte per oggetti di grandi dimensioni oppure utilizza automaticamente i caricamenti multiparte quando hai un file da caricare di dimensioni superiori a 15 MB. In questo caso, il file viene suddiviso in più parti, ognuna 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 multiparte:
--disable-multipart: disabilita i caricamenti multiparte per tutti i file.--multipart-chunk-size-mb=SIZE: imposta le dimensioni di ogni blocco di un caricamento multiparte.
I file di dimensioni superiori a SIZE vengono caricati automaticamente come multiparte multithread. I file più piccoli vengono caricati utilizzando il metodo tradizionale. SIZE è in megabyte. La dimensione predefinita del blocco è 15 MB. La dimensione minima consentita del blocco è 5 MB, mentre la massima è 5 GB.
Scaricare oggetti dai bucket di archiviazione
Console
- Nel menu di navigazione, fai clic su Object Storage.
- Fai clic sul nome del bucket contenente gli oggetti.
- Seleziona la casella di controllo accanto al nome dell'oggetto da scaricare.
- Fai clic su Scarica.
gdcloud
Per ottenere 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 Creare 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 il 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