En esta página, se describe cómo cambiar el nombre de las carpetas o moverlas dentro de un bucket con espacio de nombres jerárquico habilitado.
Antes de comenzar
Asegúrate de que tu bucket tenga el espacio de nombres jerárquico habilitado. Para obtener instrucciones detalladas sobre cómo habilitar el espacio de nombres jerárquico en un bucket, consulta Crea buckets con espacio de nombres jerárquico habilitado.
Roles obligatorios
Para obtener los permisos necesarios para cambiar el nombre de las carpetas en los buckets o moverlas, pídele a tu administrador que te otorgue el rol de usuario de objeto (roles/storage.objectUser) de IAM en el bucket.
Para obtener información sobre cómo otorgar roles en proyectos, consulta Administra el acceso a los proyectos.
Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:
Permisos necesarios
storage.folders.rename- Este permiso es necesario en la carpeta de origen.
storage.folders.create- Este permiso es necesario en la carpeta de destino.
También puedes obtener los permisos anteriores con otros roles personalizados o roles predefinidos. Para un rol más permisivo que te permita administrar carpetas además de cambiar el nombre de las carpetas, pídele a tu administrador que te otorgue uno de los siguientes roles:
- Administrador de carpetas de almacenamiento (
roles/storage.folderAdmin) - Administrador de objetos de almacenamiento (
roles/storage.objectAdmin) - Administrador de almacenamiento (
roles/storage.admin)
Para ver qué roles están asociados con qué permisos, consulta Roles de IAM para Cloud Storage.
Cambia el nombre de una carpeta o muévela
Durante una operación de cambio de nombre de carpeta, puedes leer y enumerar las carpetas a las que se les cambia el nombre, pero no puedes ejecutar operaciones de escritura en ellas.
Console
- En la Cloud de Confiance consola, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket que contiene la carpeta que quieres mover o a la que quieres cambiarle el nombre.
En la página Detalles del bucket, busca la carpeta que quieres mover o a la que quieres cambiarle el nombre.
Si quieres cambiar el nombre de la carpeta, haz lo siguiente:
Haz clic en el menú Más acciones de la carpeta.
Haz clic en Cambiar nombre de la carpeta.
En la ventana de superposición que aparece, ingresa un nuevo nombre para la carpeta.
Haz clic en Cambiar nombre.
Si quieres mover la carpeta a otra carpeta, haz lo siguiente:
Haz clic en el menú Más acciones de la carpeta.
Haz clic en Mover carpeta.
En la ventana de superposición que aparece, haz clic en Explorar.
Selecciona la carpeta de destino de la carpeta que estás moviendo. También puedes hacer clic en para crear una carpeta nueva antes de seleccionarla como carpeta de destino.
Haz clic en Seleccionar.
Haz clic en Mover.
Para obtener información sobre cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la Cloud de Confiance consola, consulta Solución de problemas.
Línea de comandos
Para cambiar el nombre de las carpetas o moverlas dentro de un bucket con espacio de nombres jerárquico, ejecuta el gcloud storage mv comando:
gcloud storage mv gs://BUCKET_NAME/FOLDER1 gs://BUCKET_NAME/FOLDER2
Donde:
BUCKET_NAMEes el nombre del bucket que contiene la carpeta a la que deseas cambiarle el nombre o moverla. Por ejemplo,my-bucketFOLDER1es el nombre de la carpeta original a la que deseas cambiarle el nombre o moverla. Por ejemplo,my-src-folderFOLDER2es el nombre nuevo de la carpeta de destino. Por ejemplo,my-dest-folderSi una carpeta existente ya usa el nuevo nombre que elegiste, la carpeta original se moverá dentro de la carpeta existente y se convertirá en una carpeta secundaria. Por ejemplo, si cambias el nombre demy-dest-folderamy-dest-folder1(ymy-dest-folder1ya existe), el resultado esmy-dest-folder1/my-dest-folder/. Si el nombre nuevo que eliges aún no existe, se modificará el nombre de la carpeta original para que coincida con el nuevo.
La respuesta se ve como el siguiente ejemplo:
Copying gs://my-bucket/my-src-folder to gs://my-bucket/my-dest-folder...
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Rust
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization.Usa
cURLpara llamar a la API de JSON con una solicitud para cambiar el nombre de las carpetas: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"
Donde:
BUCKET_NAMEes el nombre del bucket que contiene la carpeta a la que deseas cambiarle el nombre o moverla. Por ejemplo,my-bucketSOURCE_PATHes la ruta de acceso codificada en URL de la carpeta de origen. Por ejemplo,my-src-folder/, codificado en URL comomy-src-folder%2F.DESTINATION_PATHes la ruta de acceso codificada en URL de la carpeta de destino. Por ejemplo,my-dest-folder/, codificado en URL comomy-dest-folder%2F.