En esta página, se muestra cómo borrar objetos de tus buckets en Cloud Storage.
Roles obligatorios
Para obtener los permisos que necesitas para borrar objetos, pídele a tu administrador que te otorgue el rol de IAM de usuario de objeto de almacenamiento (roles/storage.objectUser
) para el bucket que contiene los objetos que deseas borrar.
Si planeas usar la consola de Google Cloud para completar las tareas de esta página, pídele a tu administrador que te otorgue el rol de administrador de almacenamiento (roles/storage.admin
) en lugar del usuario de objeto de Storage (roles/storage.objectUser
o el rol básico de visualizador (roles/viewer
), además de la función de usuario de objeto de almacenamiento (roles/storage.objectUser
).
Estos roles contienen los permisos necesarios para borrar objetos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
storage.objects.delete
storage.objects.list
- Este permiso solo es necesario cuando se usa la consola de Google Cloud o
cuando se usan la marca
--recursive
o los comodines en Google Cloud CLI.
- Este permiso solo es necesario cuando se usa la consola de Google Cloud o
cuando se usan la marca
storage.buckets.list
- Este permiso solo es necesario cuando se usa la consola de Google Cloud para realizar las instrucciones de esta página.
También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.
Para obtener más información sobre cómo otorgar roles en los buckets, consulta Usa IAM con buckets.
Borrar un objeto
Completa los siguientes pasos para borrar objetos de uno de tus buckets de Cloud Storage:
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket que contiene el objeto que deseas borrar.
Se abrirá la página Detalles del bucket y se seleccionará la pestaña Objetos.
Navega hasta los objetos, que pueden estar en una carpeta.
Haz clic en la casilla de verificación de cada objeto que deseas borrar.
También puedes hacer clic en la casilla de verificación de las carpetas , lo que borrará todos los objetos que contiene esa carpeta.
Haz clic en el botón Borrar.
Haz clic en Borrar en el diálogo que aparece.
Si borras muchos objetos a la vez, puedes realizar un seguimiento del progreso de eliminación; para ello, haz clic en el ícono Notificaciones en la consola de Google Cloud. La consola de Google Cloud puede borrar de forma masiva y en segundo plano varios millones de objetos.
Para obtener información sobre 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
Usa el comando gcloud storage rm
de Google Cloud CLI:
gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto que deseas borrar. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre del objeto que deseas borrar. Por ejemplo,pets/dog.png
.
Si se realiza de forma correcta, la respuesta se verá como el ejemplo siguiente:
Removing objects: Removing gs://example-bucket/file.txt... Completed 1/1
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.
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.
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.
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.
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.
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.
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.
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.
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
cURL
para llamar a la API de JSON con una solicitudDELETE
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto que deseas borrar. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado como URL del objeto que deseas borrar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
API de XML
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API de XML con una solicitudDELETE Object
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto que deseas borrar. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado como URL del objeto que deseas borrar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
Borra objetos de forma masiva
Si deseas borrar de forma masiva cien mil objetos o más, evita usar gcloud storage
, ya que el proceso toma mucho tiempo en completarse.
En su lugar, considera una de las siguientes opciones:
La función Administración del ciclo de vida de los objetos puede borrar cualquier cantidad de objetos. Para borrar objetos de forma masiva en tu bucket con esta función, establece una regla de configuración del ciclo de vida en tu bucket en la que la condición tenga
Age
establecido en 0 días y la acción esté configurada endelete
. Una vez que configuras la regla, Cloud Storage realiza la eliminación masiva de forma asíncrona.La consola de Google Cloud también es una opción recomendada cuando se borran hasta un millón de objetos. Una vez que inicias esta solicitud de eliminación, el proceso se realiza en segundo plano. Para comprobar el estado de la eliminación masiva, haz clic en el botón Notificaciones (notifications) en el encabezado de la consola de Google Cloud.
Cuando usas ciertas bibliotecas cliente o la API de JSON directamente, puedes agrupar en lotes tus solicitudes de eliminación para reducir la cantidad de conexiones HTTP que necesitas realizar.
¿Qué sigue?
- Obtén más información sobre la función de control de versiones de objetos.
- Obtén información sobre la función de Administración del ciclo de vida de los objetos.
- Obtén información para borrar un bucket.