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.listno 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.createno 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,
object1emfolderAé transferido para o destino comofolderA/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 chamadafolderAe transfereobject1para ela. - Não é possível excluir pastas no coletor.