Nesta página, descrevemos como renomear ou mover pastas em um bucket com o namespace hierárquico ativado.
Antes de começar
Verifique se o namespace hierárquico está ativado no bucket. Para instruções detalhadas sobre como ativar o namespace hierárquico em um bucket, consulte Criar buckets com o namespace hierárquico ativado.
Funções exigidas
Para ter as permissões necessárias para renomear ou mover pastas em buckets, peça ao administrador para conceder a você o papel do IAM de Usuário de objetos do Storage (roles/storage.objectUser) no bucket.
Para mais informações sobre como conceder papéis em projetos, consulte Gerenciar acesso a projetos.
Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.folders.rename- Essa permissão é necessária na pasta de origem.
storage.folders.create- Essa permissão é necessária na pasta de destino.
Também é possível receber as permissões anteriores com outros papéis personalizados ou Papéis predefinidos. Para um papel mais abrangente, que permite gerenciar pastas além de renomear pastas, peça para o administrador conceder a você uma das papéis a seguir:
- Administrador de pastas de armazenamento (
roles/storage.folderAdmin) - Administrador de objetos do Storage (
roles/storage.objectAdmin) - Administrador do Storage (
roles/storage.admin)
Para saber quais papéis estão associados a quais permissões, consulte Papéis do IAM para o Cloud Storage.
Renomear ou mover uma pasta
Durante uma operação de renomeação de pasta, é possível ler e listar as pastas que estão sendo renomeadas, mas não é possível executar operações de gravação nelas.
Console
- No Cloud de Confiance console do, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket que contém a pasta que você quer mover ou renomear.
Na página Detalhes do bucket, encontre a pasta que você quer mover ou renomear.
Se você quiser renomear a pasta, faça o seguinte:
Clique no menu Mais ações da pasta.
Clique em Renomear pasta.
Na janela de sobreposição que aparece, insira um novo nome para a pasta.
Clique em Renomear.
Se você quiser mover a pasta para outra pasta, faça o seguinte:
Clique no menu Mais ações da pasta.
Clique em Mover pasta.
Na janela de sobreposição que aparece, clique em Procurar.
Selecione a pasta de destino da pasta que você está movendo. Também é possível clicar em para criar uma nova pasta antes de selecioná-la como pasta de destino.
Clique em Selecionar.
Clique em Mover.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no Cloud de Confiance console, consulte Solução de problemas.
Linha de comando
Para renomear ou mover pastas em um bucket com namespace hierárquico, execute o gcloud storage mv comando:
gcloud storage mv gs://BUCKET_NAME/FOLDER1 gs://BUCKET_NAME/FOLDER2
Em que:
BUCKET_NAMEé o nome do bucket que contém a pasta que você quer renomear ou mover. Por exemplo,my-bucket.FOLDER1é o nome da pasta original que você quer renomear ou mover. Por exemplo,my-src-folder.FOLDER2é o novo nome da pasta de destino. Por exemplo,my-dest-folder. Se o novo nome escolhido já estiver sendo usado por uma pasta existente, a pasta original será movida para dentro da pasta existente, tornando-se uma pasta filha. Por exemplo, se você renomearmy-dest-foldercomomy-dest-folder1(emy-dest-folder1já existir), o resultado serámy-dest-folder1/my-dest-folder/. Se o novo nome escolhido ainda não existir, a pasta original será renomeada para corresponder ao novo nome.
A resposta terá esta aparência:
Copying gs://my-bucket/my-src-folder to gs://my-bucket/my-dest-folder...
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Rust
APIs REST
API JSON
Tenha a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Use
cURLpara chamar a API JSON com uma solicitação para renomear pastas:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/folders/SOURCE_PATH/renameTo/folders/DESTINATION_PATH"
Em que:
BUCKET_NAMEé o nome do bucket que contém a pasta que você quer renomear ou mover. Por exemplo,my-bucket.SOURCE_PATHé o caminho codificado pelo URL da pasta de origem. Por exemplo,my-src-folder/, codificado em URL comomy-src-folder%2F.DESTINATION_PATHé o caminho codificado de URL da pasta de destino. Por exemplo,my-dest-folder/, codificado em URL comomy-dest-folder%2F.