En esta página, se muestra cómo borrar buckets de Cloud Storage.
Antes de comenzar
Para obtener los permisos necesarios para borrar un bucket de Cloud Storage, pídele a tu administrador que te otorgue el rol de IAM de administrador de almacenamiento (roles/storage.admin
) en el bucket.
Este rol predefinido contiene los permisos necesarios para borrar un bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:
Permisos necesarios
-
storage.buckets.delete
-
storage.buckets.list
- Este permiso solo es necesario cuando se borran buckets mediante la consola de Google Cloud.
-
storage.objects.delete
- Este permiso solo es necesario si los objetos existen dentro del bucket que deseas borrar.
-
storage.objects.list
- Este permiso solo es necesario para borrar buckets mediante la consola de Google Cloud o Google Cloud CLI.
También puedes obtener estos permisos con otros roles personalizados o roles predefinidos.
Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.
Borrar un bucket
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
Selecciona la casilla de verificación del bucket que desees borrar.
Haz clic en Borrar.
En la ventana de superposición que aparece, confirma que deseas borrar el bucket y su contenido.
Haz clic en Borrar.
Para obtener información acerca de cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
Para borrar el bucket, junto con todos los objetos que contiene, usa el comando
gcloud storage rm
de Google Cloud CLI con la marca--recursive
:gcloud storage rm --recursive gs://BUCKET_NAME
En el ejemplo anterior,
BUCKET_NAME
es el nombre del bucket que se borrará. Por ejemplo,my-bucket
.Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:
Removing gs://my-bucket/...
Si el bucket contiene carpetas administradas, puedes borrar el bucket junto con todas las carpetas y los objetos administrados dentro de él a través del comando Google Cloud CLI
gcloud alpha storage rm
con la marca--recursive
:gcloud alpha storage rm --recursive gs://BUCKET_NAME
En el ejemplo anterior,
BUCKET_NAME
es el nombre del bucket que se borrará. Por ejemplo,my-bucket
.Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:
Removing gs://my-bucket/...
Si quieres evitar la eliminación accidental de objetos o carpetas administradas, no uses la marca --recursive
en los comandos. Cuando excluyes la marca, los comandos solo borran un bucket si este está vacío.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializadapara generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Usa
cURL
para llamar a la API de JSON con una solicitud de bucketDELETE
:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
En el que
BUCKET_NAME
es el nombre del bucket que se borrará. Por ejemplo,my-bucket
.
Si no hay errores, la respuesta contendrá un código de estado 204.
API de XML
Tener la gcloud CLI instalada e inicializadapara generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Usa
cURL
para llamar a la API de XML con una solicitud de bucketDELETE
:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME"
En el que
BUCKET_NAME
es el nombre del bucket que se borrará. Por ejemplo,my-bucket
.
¿Qué sigue?
- Crea un depósito.
- Mueve o cambia el nombre de un depósito.
- Hacer una lista de objetos de un bucket.
- Borra un objeto.