La Administración del ciclo de vida de los objetos te ayuda a optimizar los costos de almacenamiento y automatizar la retención de datos estableciendo reglas de ciclo de vida en un bucket. Por ejemplo, puedes transferir objetos a clases de almacenamiento más frías o borrar datos vencidos.
Puedes configurar y ver las reglas del ciclo de vida en un bucket. Estas reglas se aplican a todos los objetos actuales y futuros de ese bucket.
Para obtener información general, consulta Administración del ciclo de vida de los objetos.
Roles obligatorios
Para obtener los permisos que necesitas a fin de configurar y administrar la Administración del ciclo de vida de los objetos para un bucket, pídele a tu administrador que te otorgue el rol Administrador de almacenamiento (roles/storage.admin) en el bucket. Este rol predefinido contiene los permisos necesarios para configurar y administrar la Administración del ciclo de vida de los objetos de un bucket. Para ver los permisos exactos necesarios, expande la sección Permisos necesarios:
Permisos necesarios
storage.buckets.getstorage.buckets.list- Solo necesitas este permiso si usas la consola de Google Cloud para ejecutar las instrucciones de esta página.
storage.buckets.update
También puedes obtener estos permisos con roles personalizados.
Para obtener más información sobre cómo otorgar roles en buckets, consulta Configura y administra políticas de Identity and Access Management en buckets.
Configura el ciclo de vida de un bucket
Cuando cambias la configuración del ciclo de vida, la Administración del ciclo de vida de los objetos puede
seguir realizando acciones basadas en la configuración anterior durante un máximo de 24
horas. Por ejemplo, si cambias una condición age de 10 días a 20,
la Administración del ciclo de vida de los objetos aún puede borrar un objeto de 11 días de antigüedad durante un máximo de 24
horas según la configuración anterior.
Console
- En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
En la lista de bucket s, busca el bucket que deseas habilitar y haz clic en su nombre.
Haz clic en la pestaña Ciclo de vida.
Aparece la página de reglas del ciclo de vida. Desde aquí, puedes editar o borrar reglas existentes. Para agregar una regla nueva, haz lo siguiente:
Haz clic en Agregar una regla.
En la página que aparece, especifica una configuración.
Selecciona la acción que debe realizarse cuando un objeto cumple las condiciones.
Haga clic en Continuar.
Selecciona las condiciones en las que se realiza una acción.
Haz clic en Continuar.
Haz clic en Crear.
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
Si deseas conservar las reglas de ciclo de vida existentes en el bucket, obtén la configuración actual del ciclo de vida y guárdala en un archivo JSON. De lo contrario, crea un archivo JSON nuevo.
Actualiza el archivo JSON para incluir todas las reglas de configuración del ciclo de vida que deseas aplicar al bucket. Cuando se aplica un archivo de configuración, se reemplazan las reglas de ciclo de vida existentes en el bucket. Para ver archivos JSON de muestra, consulta Ejemplos de configuración.
Usa el comando
gcloud storage buckets updatecon la marca--lifecycle-file:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
Donde:
BUCKET_NAMEes el nombre del bucket correspondiente. Por ejemplo,my-bucketLIFECYCLE_CONFIG_FILEes la ruta de acceso del archivo JSON que actualizaste en el paso 2.
Bibliotecas cliente
Si estableces una configuración del ciclo de vida con las bibliotecas cliente, se reemplazan las reglas del ciclo de vida existentes en el bucket. Si quieres conservar las reglas existentes, primero obtén la configuración actual del ciclo de vida y, luego, incluye todas las reglas que quieras aplicar en tu solicitud.
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
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.
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
Rust
En el siguiente ejemplo, se establece una configuración del ciclo de vida en un bucket:
En la siguiente muestra, se quita cualquier configuración del ciclo de vida existente de un bucket:
Terraform
Puedes usar un recurso de Terraform a fin de establecer una configuración de ciclo de vida para un bucket administrado por Terraform. Para establecer una configuración del ciclo de vida en un depósito existente que aún no administra Terraform, primero debes importar el depósito existente. Aplicar una configuración de Terraform
reemplaza cualquier regla del ciclo de vida existente en el bucket. Si
quieres conservar las reglas existentes, incluye todos los bloques lifecycle_rule que
quieras aplicar en tu recurso google_storage_bucket.
Para saber si una condición del ciclo de vida es compatible con Terraform, consulta la documentación de Terraform para el bloque condition.
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.Si deseas conservar las reglas de ciclo de vida existentes en el bucket, obtén la configuración actual del ciclo de vida y guárdala en un archivo JSON. De lo contrario, crea un archivo JSON nuevo.
Actualiza el archivo JSON para incluir todas las reglas de configuración del ciclo de vida que quieras aplicar al bucket. Cuando se aplica un archivo de configuración, se reemplazan las reglas de ciclo de vida existentes en el bucket. Para ver archivos JSON de muestra, consulta Ejemplos de configuración.
Usa
cURLpara llamar a la API de JSON con una solicitud de bucketPATCH:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME?fields=lifecycle"
Aquí:
LIFECYCLE_CONFIG_FILEes la ruta de acceso del archivo JSON que actualizaste en el paso 3.BUCKET_NAMEes el nombre del bucket correspondiente. Por ejemplo,my-bucket.
API de XML
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization.Si quieres conservar las reglas de ciclo de vida existentes en el bucket, obtén la configuración actual del ciclo de vida y guárdala en un archivo en formato XML. De lo contrario, crea un archivo XML nuevo.
Actualiza el archivo XML para incluir todas las reglas de configuración del ciclo de vida que quieras aplicar al bucket. Cuando se aplica un archivo de configuración, se reemplazan las reglas de ciclo de vida existentes en el bucket. Para ver archivos en formato XML de muestra, consulta Ejemplos de configuración.
Usa
cURLpara llamar a la API de XML con una solicitud de bucketPUTy un parámetro de string de consultalifecycle:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./BUCKET_NAME?lifecycle"
Aquí:
XML_FILE_NAMEes la ruta de acceso del archivo XML que actualizaste en el paso 3.BUCKET_NAMEes el nombre del bucket correspondiente. Por ejemplo,my-bucket.
Obtén la configuración del ciclo de vida de un bucket
Console
- En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
En la lista de depósitos, el estado del ciclo de vida de cada depósito se encuentra en la columna Ciclo de vida.
Puedes hacer clic en este estado para agregar, ver, editar y borrar reglas.
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 buckets describe con la marca --format:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
En el ejemplo anterior, BUCKET_NAME es el nombre del bucket para
el que deseas ver la configuración del ciclo de vida. Por ejemplo,
my-bucket.
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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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.
Si deseas ver las políticas del ciclo de vida del bucket, sigue las instrucciones para mostrar los metadatos de un depósito y busca los campos de la política del ciclo de vida en la respuesta.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 de bucketGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./storage/v1/b/BUCKET_NAME?fields=lifecycle"
En el que
BUCKET_NAMEes el nombre del bucket correspondiente. Por ejemplo,my-bucket.
API de XML
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 XML con una solicitud de bucketGETy un parámetro de string de consultalifecycle:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./BUCKET_NAME?lifecycle"
En el que
BUCKET_NAMEes el nombre del bucket correspondiente. Por ejemplo,my-bucket.
¿Qué sigue?
- Obtén más información sobre la administración del ciclo de vida de los objetos, incluidas las acciones y las condiciones del ciclo de vida disponibles.
- Explora los ejemplos de configuración del ciclo de vida.