Información general Ejemplos de configuración
En esta página se describe cómo configurar la gestión del ciclo de vida de los objetos en un segmento y cómo ver la configuración del ciclo de vida actual de un segmento. Las configuraciones del ciclo de vida se aplican a todos los objetos actuales y futuros del segmento.
Roles obligatorios
Para obtener los permisos que necesitas para configurar y gestionar la gestión del ciclo de vida de los objetos de un segmento, pide a tu administrador que te conceda el rol Administrador de Storage (roles/storage.admin
) en el segmento. Este rol predefinido contiene los permisos necesarios para configurar y gestionar la gestión del ciclo de vida de los objetos de un segmento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
storage.buckets.get
storage.buckets.list
- Este permiso solo es necesario si tienes previsto usar la Google Cloud consola para seguir las instrucciones de esta página.
storage.buckets.update
También puedes obtener estos permisos con roles personalizados.
Para obtener información sobre cómo conceder roles en los contenedores, consulta Usar IAM con contenedores.
Definir la configuración del ciclo de vida de un segmento
Consola
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
En la lista de contenedores, busca el que quieras habilitar y haz clic en su nombre.
Haga clic en la pestaña Ciclo de vida.
Aparecerá la página de reglas del ciclo de vida. Desde aquí, puedes editar o eliminar las reglas que ya tengas. Para añadir una regla, sigue estos pasos:
Haz clic en Añadir regla.
En la página que aparece, especifica una configuración.
Selecciona la acción que se debe llevar a cabo cuando un objeto cumpla las condiciones.
Haz clic en Continuar.
Selecciona las condiciones en las que se lleva a cabo una acción.
Haz clic en Continuar.
Haz clic en Crear.
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
Crea un archivo JSON con las reglas de configuración del ciclo de vida que quieras aplicar. Consulta los ejemplos de configuración para ver archivos JSON de muestra.
Usa el comando
gcloud storage buckets update
con la marca--lifecycle-file
:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
Donde:
BUCKET_NAME
es el nombre del segmento correspondiente. Por ejemplo,my-bucket
.LIFECYCLE_CONFIG_FILE
es la ruta del archivo JSON que has creado en el paso 1.
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
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.
En el siguiente ejemplo se define una configuración del ciclo de vida en un segmento:
En el siguiente ejemplo se elimina la configuración del ciclo de vida de un segmento:
Terraform
Puedes usar un recurso de Terraform para definir una configuración de ciclo de vida de un segmento gestionado por Terraform. Para definir una configuración de ciclo de vida en un bucket que ya exista y que aún no esté gestionado por Terraform, primero debes importar el bucket.
Para saber si Terraform admite una condición de ciclo de vida, consulta la documentación de Terraform sobre el bloque condition
.
APIs REST
API JSON
Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo JSON con las reglas de configuración del ciclo de vida que quieras aplicar. Consulta los ejemplos de configuración para ver archivos JSON de muestra.
Usa
cURL
para llamar a la API JSON con una solicitud dePATCH
contenedor:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Donde:
LIFECYCLE_CONFIG_FILE
es la ruta del archivo JSON que has creado en el paso 2.BUCKET_NAME
es el nombre del segmento correspondiente. Por ejemplo,my-bucket
.
API XML
Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo XML con las reglas de configuración del ciclo de vida que quieras aplicar. Consulta los ejemplos de configuración para ver archivos XML de muestra.
Usa
cURL
para llamar a la API XML con una solicitudPUT
Bucket y el parámetro de cadena de consultalifecycle
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Donde:
XML_FILE_NAME
es la ruta del archivo XML que has creado en el paso 2.BUCKET_NAME
es el nombre del segmento correspondiente. Por ejemplo,my-bucket
.
Consultar la configuración del ciclo de vida de un segmento
Consola
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
En la lista de contenedores, el estado del ciclo de vida de cada contenedor se encuentra en la columna Ciclo de vida.
Puedes hacer clic en este estado para añadir, ver, editar y eliminar reglas.
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
Usa el comando gcloud storage buckets describe
con la marca --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
Donde BUCKET_NAME
es el nombre del cubo cuya configuración del ciclo de vida quiere ver. Por ejemplo, my-bucket
.
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.
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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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.
Para ver las políticas del ciclo de vida de un segmento, sigue las instrucciones para mostrar los metadatos de un segmento y busca los campos de la política del ciclo de vida en la respuesta.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 deGET
contenedor:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Donde
BUCKET_NAME
es el nombre del segmento correspondiente. Por ejemplo,my-bucket
.
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 deGET
contenedor y un parámetro de cadena de consultalifecycle
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Donde
BUCKET_NAME
es el nombre del segmento correspondiente. Por ejemplo,my-bucket
.
Siguientes pasos
- Consulta más información sobre la gestión del ciclo de vida de los objetos, incluidas las acciones y las condiciones disponibles.
- Consulta ejemplos de configuración del ciclo de vida.