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 outras permissões 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 no bucket de origem. Nenhum outro papel é necessário.

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), que é necessário no bucket de destino. Nenhum outro papel é necessário.

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árquico:

  • 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 coletor.

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 as pastas que estiverem faltando. 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 ela.
  • Não é possível excluir pastas no coletor.