Esta página mostra como carregar e transferir objetos para e a partir de contentores de armazenamento de dispositivos isolados do Google Distributed Cloud (GDC).
Antes de começar
Um espaço de nomes do projeto gere os recursos de contentores no servidor da API Management. Tem de ter um projeto para trabalhar com contentores e objetos.
Também tem de ter as autorizações de contentor adequadas para realizar a seguinte operação. Consulte o artigo Conceda acesso ao contentor.
Diretrizes de nomenclatura de objetos
Siga as diretrizes abaixo para atribuir nomes a objetos:
- Use carateres UTF-8 ao atribuir nomes a objetos.
- Abstenha-se de incluir informações de identificação pessoal (IIP).
Carregue objetos para contentores de armazenamento
Para carregar 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 seguinte carrega todos os ficheiros de texto do diretório local para um contentor:
gdcloud storage cp *.txt s3://BUCKET
O comando seguinte carrega vários ficheiros do diretório local para um contentor:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
Para carregar uma pasta para um contentor, use a opção --recursive para copiar uma árvore de diretórios inteira. O seguinte comando carrega a árvore de diretórios dir:
gdcloud storage cp dir s3://BUCKET --recursive
Realize carregamentos multipartes para objetos grandes ou use carregamentos multipartes automaticamente quando tiver um ficheiro para carregar com mais de 15 MB. Nesse caso, o ficheiro é dividido em várias partes, com um tamanho de 15 MB cada. A última parte é mais pequena. Cada parte é carregada separadamente e reconstruída no destino quando a transferência é concluída.
Se o carregamento de uma parte falhar, pode reiniciar o carregamento sem afetar nenhuma das outras partes já carregadas.
Existem duas opções relacionadas com carregamentos multipartes:
--disable-multipart: desativa os carregamentos multipartes para todos os ficheiros.--multipart-chunk-size-mb=SIZE: define o tamanho de cada parte de um carregamento multipartes.
Os ficheiros com mais de SIZE são carregados automaticamente como multipartes com várias linhas. Os ficheiros mais pequenos são carregados através do método tradicional. SIZE está em megabytes. O tamanho do fragmento predefinido é de 15 MB. O tamanho mínimo permitido do fragmento é de 5 MB e o máximo é de 5 GB.
Transfira objetos de contentores de armazenamento
Para obter objetos do contentor:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
Para transferir todos os ficheiros de texto de um contentor para o seu diretório atual:
gdcloud storage cp s3://BUCKET/*.txt .
Para transferir o ficheiro de texto abc.txt de um contentor para o seu diretório atual:
gdcloud storage cp s3://BUCKET/abc.txt .
Para transferir uma versão mais antiga do ficheiro, comece por listar todas as versões do ficheiro:
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, transfira uma versão específica do ficheiro de texto abc.txt do contentor para o seu diretório atual:
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .