En esta página, se muestra cómo borrar objetos de tus buckets en Cloud Storage.
Permisos necesarios
Consola
Para completar esta guía con la consola de Google Cloud, debes tener los permisos de IAM adecuados. Si el objeto que deseas acceder existe en un proyecto que no creaste, es posible que necesites que el propietario del proyecto te otorgue una función con los permisos necesarios.
A fin de obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para la consola de Google Cloud.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Línea de comandos
Para completar esta guía con una utilidad de línea de comandos, debes tener los permisos de IAM adecuados. Si el objeto que deseas borrar existe en un proyecto que no creaste, es posible que necesites que el propietario del proyecto te otorgue una función con los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para los comandos de gsutil.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Bibliotecas cliente
Para completar esta guía con las bibliotecas cliente de Cloud Storage, debes tener los permisos de IAM adecuados. Si el objeto que deseas borrar existe en un proyecto que no creaste, es posible que necesites que el propietario del proyecto te otorgue una función con los permisos necesarios.
A menos que se indique lo contrario, las solicitudes de la biblioteca cliente se realizan mediante la API de JSON y requieren permisos, como se indica en Permisos de IAM para métodos de JSON. Para ver qué métodos de la API de JSON se invocan cuando realizas solicitudes mediante una biblioteca cliente, registra las solicitudes sin procesar.
Para obtener una lista de los roles de IAM relevantes, consulta Roles de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
API de REST
API de JSON
Para completar esta guía con la API de JSON, debes tener los permisos de IAM adecuados. Si el objeto que deseas borrar existe en un proyecto que no creaste, es posible que necesites que el propietario del proyecto te otorgue una función con los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Borra un objeto
Completa los siguientes pasos para borrar objetos de uno de tus buckets de Cloud:
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án 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
gcloud
Usa el comando gcloud storage rm
de la CLI de Google Cloud:
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
gsutil
Usa el comando gsutil rm
:
gsutil 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:
Operation completed over 1 objects.
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
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de JSON con una solicitudDELETE
:curl -X DELETE \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Aquí:
OAUTH2_TOKEN
es el nombre del token de acceso que generaste en el paso 1.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
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de XML con una solicitudDELETE Object
:curl -X DELETE \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Aquí:
OAUTH2_TOKEN
es el nombre del token de acceso que generaste en el paso 1.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
o gsutil, ya que el proceso toma mucho tiempo en completarse. En su lugar, usa la consola de Google Cloud, que puede borrar hasta varios millones de objetos, o la Administración del ciclo de vida de los objetos, que puede borrar cualquier cantidad de objetos.- Para borrar objetos de forma masiva en tu bucket con la Administración del ciclo de vida de los objetos, 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
.
- Para borrar objetos de forma masiva en tu bucket con la Administración del ciclo de vida de los objetos, establece una regla de configuración del ciclo de vida en tu bucket en la que la condición tenga
Cuando usas ciertas bibliotecas cliente o cuando usas 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.