En esta página se explica cómo eliminar segmentos de Cloud Storage. Cuando eliminas un segmento, también se eliminan los recursos que contiene, como los objetos y las carpetas gestionadas.
Si eliminas un segmento que tiene habilitada la eliminación no definitiva, puedes restaurar el segmento o los objetos individuales del segmento durante el periodo de conservación especificado en la política de eliminación no definitiva. Las carpetas gestionadas no se pueden recuperar, aunque el contenedor tenga habilitada la eliminación lógica.
Antes de empezar
Para obtener los permisos necesarios para eliminar un segmento de Cloud Storage, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Storage (roles/storage.admin
) en el segmento.
Este rol predefinido contiene los permisos necesarios para eliminar un segmento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
-
storage.buckets.delete
-
storage.buckets.list
- Este permiso solo es necesario cuando se eliminan segmentos mediante la consola Google Cloud .
-
storage.objects.delete
- Este permiso solo es necesario si hay objetos en el segmento que quieres eliminar.
-
storage.objects.list
- Este permiso solo es necesario para eliminar segmentos con la Google Cloud consola o la CLI de Google Cloud.
También puedes obtener estos permisos con otros roles personalizados o roles predefinidos.
Para obtener instrucciones sobre cómo conceder roles para los contenedores, consulta Usar IAM con contenedores.
Eliminar un segmento
Consola
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
Selecciona la casilla de verificación del segmento que quieras eliminar.
Haz clic en Eliminar.
En la ventana superpuesta que aparece, confirma que quieres eliminar el contenedor y su contenido.
Haz clic en Eliminar.
Para saber cómo obtener información detallada sobre los errores de las operaciones de Cloud Storage en la consola, consulta la sección Solución de problemas. Google Cloud
Línea de comandos
Para eliminar el segmento, junto con todo su contenido, usa el comando gcloud storage rm
de Google Cloud CLI con la marca --recursive
:
gcloud storage rm --recursive gs://BUCKET_NAME
Donde BUCKET_NAME
es el nombre del segmento que se va a eliminar. Por ejemplo, my-bucket
.
Si la acción se realiza correctamente, la respuesta se parecerá al siguiente ejemplo:
Removing gs://my-bucket/...
Si quiere evitar que se eliminen objetos o carpetas gestionadas por error, utilice el comando gcloud storage buckets delete
, que solo elimina un contenedor si está vacío.
Bibliotecas de cliente
proporcionan una marca o función de eliminación forzada.
C++
Para obtener más información, consulta la documentación de referencia de la API C++ de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
C#
Para obtener más información, consulta la documentación de referencia de la API C# de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Go
Para obtener más información, consulta la documentación de referencia de la API Go de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Java
Para obtener más información, consulta la documentación de referencia de la API Java de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Node.js
Para obtener más información, consulta la documentación de referencia de la API Node.js de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
PHP
Para obtener más información, consulta la documentación de referencia de la API PHP de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Python
Para obtener más información, consulta la documentación de referencia de la API Python de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Ruby
Para obtener más información, consulta la documentación de referencia de la API Ruby de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
APIs REST
API JSON
Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API JSON con una solicitud deDELETE
contenedor:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Donde
BUCKET_NAME
es el nombre del segmento que se va a eliminar. Por ejemplo,my-bucket
.
Si la acción se realiza correctamente, la respuesta contendrán un código de estado 204.
API XML
Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API XML con una solicitud deDELETE
contenedor:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME"
Donde
BUCKET_NAME
es el nombre del segmento que se va a eliminar. Por ejemplo,my-bucket
.
Siguientes pasos
- crear un depósito,
- Mover un segmento o cambiarle el nombre
- Enumera los objetos de un segmento.
- Eliminar un objeto
- Restaurar un segmento eliminado de forma lógica.