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 de e para buckets do Cloud Storage que usam namespace hierárquico. Para transferir as pastas e os 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 de Leitor de objetos do Storage (roles/storage.objectViewer), que é necessário para todas as transferências. Nenhuma função extra é 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 de Usuário de objetos do Storage (roles/storage.objectUser). Conceda essa função além das listadas em Permissões de transferência sem agente.

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

Comportamento de transferência

Ao transferir entre dois buckets de namespace hierárquico:

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

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

  • Os objetos e os metadados deles são transferidos.
  • As pastas são transferidas como prefixos de objetos. 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 deles são transferidos.
  • Os prefixos de objetos são usados para criar pastas ausentes. Por exemplo, ao transferir folderA/object1, o serviço de transferência do Cloud Storage cria uma nova pasta chamada folderA e transfere object1 para essa pasta.
  • Não é possível excluir pastas no coletor.