Copiar, modificar e mover objetos de armazenamento

Nesta página, mostramos como copiar, modificar e mover objetos em buckets de armazenamento isolados do Google Distributed Cloud (GDC).

Antes de começar

Os buckets de armazenamento são recursos com escopo para um projeto específico. O projeto funciona como um contêiner, agrupando seus buckets e permitindo o gerenciamento deles pelo servidor da API Management. Antes de executar as operações nesta página, crie um projeto ou selecione um em que você tenha permissões suficientes.

Papéis do IAM obrigatórios

Entre em contato com o administrador do projeto do IAM para solicitar os seguintes papéis no namespace do projeto:

  • Administrador de buckets do projeto (project-bucket-admin): cria, atualiza e exclui buckets de armazenamento.
  • Leitor de objetos de buckets do projeto (project-bucket-object-viewer): visualiza e verifica detalhes de buckets e objetos de armazenamento.

Para mais informações, consulte Conceder acesso ao bucket.

Preparar o ambiente

Para executar comandos no servidor da API Management ou no servidor da API global, faça o seguinte:

  1. Faça login e gere o arquivo kubeconfig para o servidor da API Management zonal, se você não tiver um.
  2. Para buckets de duas zonas, faça o seguinte:
    • Verifique com o operador de infraestrutura (IO, na sigla em inglês) se o recurso personalizado BucketLocationConfig foi criado para as zonas pareadas.
    • Gere o arquivo kubeconfig para o servidor da API global.

Copiar, modificar e mover objetos

Copiar um objeto:

gdcloud storage cp FILE  [FILE...] s3://FULLY_QUALIFIED_BUCKET_NAME [/PREFIX ]

Modificar os metadados de um objeto:

gdcloud storage objects update s3://FULLY_QUALIFIED_BUCKET_NAME1/OBJECT --custom-metadata=Key1=Value1

Mover um objeto:

Ao mover um objeto, uma cópia dele é movida para outro local, no mesmo bucket ou para outro caminho no mesmo bucket. Depois, o objeto original é excluído.

gdcloud storage mv s3://FULLY_QUALIFIED_BUCKET_NAME1/OBJECT1 s3://FULLY_QUALIFIED_BUCKET_NAME2[/OBJECT2]