Transferir buckets de namespace hierárquicos do Cloud Storage

O namespace hierárquico do Cloud Storage armazena dados em uma estrutura lógica de sistema de arquivos, usando pastas para organizar objetos. Para mais detalhes, consulte Namespace hierárquico.

O Serviço de transferência do Cloud Storage pode transferir dados de e para buckets do Cloud Storage que usam namespace hierárquico. Para transferir pastas e metadados delas, é necessário conceder permissões adicionais ao agente de serviço do Serviço de transferência do Cloud Storage.

Permissões necessárias

Além das permissões padrão necessárias para uma transferência, o agente de serviço do Serviço de transferência do Cloud Storage precisa receber as seguintes permissões do IAM.

Quando a origem é um bucket de namespace hierárquico:

  • storage.folders.list no bucket de origem. Essa permissão está incluída no papel Leitor de objetos do Storage (roles/storage.objectViewer), que é obrigatório para todas as transferências. Nenhuma outra função é necessária.

Quando o destino é um bucket de namespace hierárquico:

  • storage.folders.create no bucket de destino. Essa permissão está incluída no papel Usuário de objetos do Storage (roles/storage.objectUser). Conceda esse papel além dos listados em Permissões de transferência sem agente.

Para instruções sobre como adicionar papéis ao agente de serviço, consulte:

Comportamento de transferência

Ao transferir entre dois buckets de namespace hierárquicos:

  • Os objetos e os metadados de objetos são transferidos.
  • As pastas e os metadados delas são transferidos.
  • Não é possível excluir pastas na origem ou no destino.

Ao transferir de um bucket de namespace hierárquico para um bucket de namespace simples:

  • Os objetos e os metadados de objetos são transferidos.
  • As pastas são transferidas como prefixos de objeto. Por exemplo, object1 em folderA é transferido para o destino como folderA/object1.
  • Os metadados da pasta não são transferidos.
  • Não é possível excluir pastas na origem.

Ao transferir de um bucket de namespace simples para um bucket de namespace hierárquico:

  • Os objetos e os metadados de objetos são transferidos.
  • Os prefixos de objeto são usados para criar pastas ausentes. Por exemplo, ao transferir folderA/object1, o serviço de transferência do Cloud Storage cria uma pasta chamada folderA e transfere object1 para ela.
  • Não é possível excluir pastas no coletor.