Carregue e transfira objetos de armazenamento

Esta página mostra-lhe como carregar e transferir objetos para e a partir de contentores de armazenamento 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

Consola

  1. No menu de navegação, clique em Object Storage.
  2. Clique no nome do contentor para o qual quer carregar o objeto.
  3. Opcional: se quiser criar uma pasta para armazenar o objeto, clique em Criar pasta > introduza um nome para a pasta > clique em Criar.
  4. Clique diretamente em Carregar ficheiro ou navegue para a pasta que acabou de criar e, em seguida, clique em Carregar ficheiro.
  5. Selecione o ficheiro pretendido e clique em Abrir.
  6. Aguarde pela mensagem de confirmação de que o carregamento foi bem-sucedido.

CLI

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

Os seguintes comandos requerem o FULLY_QUALIFIED_BUCKET_NAME. Use o comando GET ou DESCRIBE na secção Ver configuração do contentor para obter o nome totalmente qualificado do contentor.

O comando seguinte carrega todos os ficheiros de texto do diretório local para um contentor:

gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME

O comando seguinte carrega vários ficheiros do diretório local para um contentor:

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

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://FULLY_QUALIFIED_BUCKET_NAME --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

Consola

  1. No menu de navegação, clique em Object Storage.
  2. Clique no nome do contentor que contém os objetos.
  3. Selecione a caixa de verificação junto ao nome do objeto a transferir.
  4. Clique em Transferir.

CLI

Para obter objetos do contentor:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/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://FULLY_QUALIFIED_BUCKET_NAME/*.txt .

Para transferir o ficheiro de texto abc.txt de um contentor para o seu diretório atual:

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

Para transferir uma versão mais antiga do ficheiro, comece por listar todas as versões do ficheiro:

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/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://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .

Use AEADKey personalizado

Para uma maior personalização, pode criar a sua própria AEADKey e usá-la diretamente ao encriptar objetos no seu contentor. Isto dá-lhe controlo total sobre a chave de encriptação, ignorando a predefinição. Siga os passos em Crie uma chave para criar uma nova AEADKey e certifique-se de que está no mesmo Namespace que o contentor que pretende usar. Em seguida, sempre que enviar o pedido, certifique-se de que o HEADER está configurado com x-amz-server-side-encryption: SSE-KMS e x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME