Nesta página, mostramos como fazer upload e download de objetos para e de buckets de armazenamento de dispositivos isolados do Google Distributed Cloud (GDC).
Antes de começar
Um namespace de projeto gerencia recursos de bucket no servidor da API Management. Você precisa ter um projeto para trabalhar com buckets e objetos.
Você também precisa ter as permissões de bucket adequadas para realizar a seguinte operação. Consulte Conceder acesso ao bucket.
Diretrizes de nomenclatura de objetos
Siga estas diretrizes para nomear objetos:
- Use caracteres UTF-8 ao nomear objetos.
- Não inclua informações de identificação pessoal (PII).
Fazer upload de objetos para buckets de armazenamento
Para fazer upload de um objeto, execute os seguintes comandos:
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
O comando a seguir faz upload de todos os arquivos de texto do diretório local para um bucket:
gdcloud storage cp *.txt s3://BUCKET
O comando a seguir faz upload de vários arquivos do diretório local para um bucket:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
Para fazer upload de uma pasta para um bucket, use a opção "--recursive" para copiar uma árvore de diretórios inteira. O comando a seguir faz upload da árvore de diretórios dir:
gdcloud storage cp dir s3://BUCKET --recursive
Faça uploads de várias partes para objetos grandes ou use uploads de várias partes automaticamente quando tiver um arquivo maior que 15 MB para enviar. Nesse caso, o arquivo é dividido em várias partes, cada uma com 15 MB. A última parte é menor. Cada parte é enviada separadamente e reconstruída no destino quando a transferência é concluída.
Se o upload de uma parte falhar, você poderá reiniciar o processo sem afetar nenhuma das outras partes já enviadas.
Há duas opções relacionadas a uploads em várias partes:
--disable-multipart: desativa os uploads de várias partes para todos os arquivos.--multipart-chunk-size-mb=SIZE: define o tamanho de cada parte de um upload em várias partes.
Arquivos maiores que SIZE são enviados automaticamente como multithreaded-multipart. Arquivos menores são enviados usando o método tradicional. SIZE está em megabytes. O tamanho padrão do bloco é de 15 MB. O tamanho mínimo permitido de um bloco é de 5 MB, e o máximo é de 5 GB.
Baixar objetos de buckets de armazenamento
Para receber objetos do bucket:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
Para fazer o download de todos os arquivos de texto de um bucket para o diretório atual:
gdcloud storage cp s3://BUCKET/*.txt .
Para fazer o download do arquivo de texto abc.txt de um bucket para o diretório atual:
gdcloud storage cp s3://BUCKET/abc.txt .
Para fazer o download de uma versão mais antiga do arquivo, primeiro liste todas as versões dele:
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
Exemplo de saída:
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
Em seguida, baixe uma versão específica do arquivo de texto abc.txt do bucket para o diretório atual:
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .