En esta página se explica cómo habilitar la gestión del ciclo de vida de los objetos y proporciona ejemplos de políticas de ciclo de vida. Para obtener una descripción de esta característica, incluidas las acciones y condiciones que admite, consulta el apartado sobre la gestión del ciclo de vida de los objetos.
Configurar la gestión del ciclo de vida
Habilitar la gestión del ciclo de vida
Para habilitar la gestión del ciclo de vida de un segmento:
Consola
Abre el explorador de Cloud Storage en la consola de Google Cloud Platform.
Abrir el navegador de Cloud StorageEn la lista de segmentos, busca el que deseas habilitar y haz clic en Ninguno en la columna Ciclo de vida.
Aparecerá la página de reglas del ciclo de vida.
Haz clic en Añadir regla.
En la página que aparece, especifica una configuración.
Selecciona las condiciones bajo las cuales se realiza una acción.
Haz clic en Continuar.
Selecciona la acción que se realizará cuando un objeto cumpla con las condiciones.
Haz clic en Continuar.
Haz clic en Guardar.
gsutil
Crea un archivo
.json
con las reglas de configuración del ciclo de vida que querrías aplicar (ver ejemplos a continuación).Usa el comando
lifecycle set
para aplicar la configuración, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]
APIs REST
API JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura el playground que se va a usar con tus propias credenciales de OAuth.
- Crea un archivo
.json
con las reglas de configuración del ciclo de vida que querrías aplicar (ver ejemplos a continuación). - Usa
cURL
para llamar a la API JSON con una petición dePATCH Bucket
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:curl -X PATCH --data-binary @[LIFECYCLE_CONFIG_FILE].json \ -H "Authorization: Bearer [OAUTH2_TOKEN]" \ -H "Content-Type: application/json" \ "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"
API XML
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura el playground que se va a usar con tus propias credenciales de OAuth.
- Crea un cuerpo de petición que contenga las reglas de configuración del ciclo de vida que querría aplicar (ver ejemplos a continuación).
- Usa
cURL
para llamar a la API XML con una petición dePUT Bucket
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:curl -X PUT --data-binary @[XML_FILE].xml \ -H "Authorization: Bearer [OAUTH2_TOKEN]" \ "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"
Inhabilitar la gestión del ciclo de vida
Para inhabilitar la administración del ciclo de vida de un segmento:
Consola
Abre el explorador de Cloud Storage en la consola de Google Cloud Platform.
Abrir el navegador de Cloud StorageEn la lista de segmentos, busca el que deseas inhabilitar y haz clic en Habilitado en la columna Ciclo de vida.
Aparecerá la página de reglas del ciclo de vida.
Haz clic en Eliminar todo.
En la ventana de confirmación que aparece, haz clic en Eliminar.
gsutil
Crea un archivo
.json
con una configuración de ciclo de vida vacía:{}
Usa el comando
lifecycle set
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]
APIs REST
API JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura el playground que se va a usar con tus propias credenciales de OAuth.
- Crea un archivo
.json
con una configuración de ciclo de vida vacía:{}
- Usa
cURL
para llamar a la API JSON con una petición dePATCH Bucket
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:curl -X PATCH --data-binary @[LIFECYCLE_CONFIG_FILE].json \ -H "Authorization: Bearer [OAUTH2_TOKEN]" \ -H "Content-Type: application/json" \ "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"
API XML
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura el playground que se va a usar con tus propias credenciales de OAuth.
- Crea un cuerpo de petición que contenga una configuración de ciclo de vida vacía:
<?xml version="1.0" encoding="UTF-8" ?> <LifecycleConfiguration/>
- Usa
cURL
para llamar a la API XML con una petición dePUT Bucket
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:curl -X PUT --data-binary @[XML_FILE].xml \ -H "Authorization: Bearer [OAUTH2_TOKEN]" \ "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"
Comprobar la configuración del ciclo de vida
Para comprobar la configuración del ciclo de vida establecida en un segmento:
Consola
Abre el explorador de Cloud Storage en la consola de Google Cloud Platform.
Abrir el navegador de Cloud StorageEn la lista de segmentos, el estado del ciclo de vida de cada segmento se encuentra en la columna Ciclo de vida.
Puedes hacer clic en este estado para agregar, ver, editar y eliminar reglas.
gsutil
Usa el comando
lifecycle get
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:gsutil lifecycle get gs://[BUCKET_NAME]
APIs REST
API JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura el playground que se va a usar con tus propias credenciales de OAuth. .
- Usa
cURL
para llamar a la API JSON con una petición deGET Bucket
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:curl -X GET -H "Authorization: Bearer [OAUTH2_TOKEN]" \ "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"
API XML
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura el playground que se va a usar con tus propias credenciales de OAuth.
- Usa
cURL
para llamar a la API XML con una petición deGET Bucket
, sustituyendo[VALUES_IN_BRACKETS]
por los valores correspondientes:curl -X GET \ -H "Authorization: Bearer [OAUTH2_TOKEN]" \ "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"
Ejemplos de configuración del ciclo de vida
Los siguientes ejemplos muestran configuraciones específicas del ciclo de vida que logran eliminar objetos y cambiar la clase de almacenamiento de los objetos cuando se cumplen los criterios comunes. Para obtener una descripción detallada de las configuraciones del ciclo de vida, incluida una lista de acciones y condiciones disponibles, consulta el apartado sobre la gestión del ciclo de vida de los objetos.
Eliminar un objeto
La siguiente configuración del ciclo de vida define dos reglas. La primera regla elimina cualquier objeto activos de más de 30 días. La segunda elimina objetos archivados de más de 10 días. Ten en cuenta que, para la segunda regla, se requiere habilitar el control de versiones de objetos para que se cumplan sus criterios.
Consola
La siguiente regla elimina objetos activos de más de 30 días:
La siguiente regla elimina los objetos archivados de más de 10 días:
gsutil
La siguiente configuración de ciclo de vida se puede aplicar a un segmento habilitando la gestión del ciclo de vida.
{ "lifecycle": { "rule": [ { "action": {"type": "Delete"}, "condition": { "age": 30, "isLive": true } }, { "action": {"type": "Delete"}, "condition": { "age": 10, "isLive": false } } ] } }
Para obtener el formato generalizado de un archivo de configuración de ciclo de vida, consulta la representación de recursos de segmentos para JSON.
APIs REST
API JSON
La siguiente configuración de ciclo de vida se puede aplicar a un segmento habilitando la gestión del ciclo de vida.
{ "lifecycle": { "rule": [ { "action": {"type": "Delete"}, "condition": { "age": 30, "isLive": true } }, { "action": {"type": "Delete"}, "condition": { "age": 10, "isLive": false } } ] } }
Para obtener el formato generalizado de un archivo de configuración de ciclo de vida, consulta la representación de recursos de segmentos para JSON.
API XML
La siguiente configuración de ciclo de vida se puede aplicar a un segmento habilitando la gestión del ciclo de vida.
<?xml version="1.0" encoding="UTF-8" ?> <LifecycleConfiguration> <Rule> <Action> <Delete/> </Action> <Condition> <IsLive>true</IsLive> <Age>30</Age> </Condition> </Rule> <Rule> <Action> <Delete/> </Action> <Condition> <IsLive>false</IsLive> <Age>10</Age> </Condition> </Rule> </LifecycleConfiguration>
Para obtener el formato generalizado de un archivo de configuración de ciclo de vida, consulta el formato de configuración de ciclo de vida para XML.
Cambiar la clase de almacenamiento de un objeto
La siguiente configuración de ciclo de vida define dos reglas para cambiar la clase de almacenamiento de objetos en un segmento. La primera regla cambia los objetos de Multi-Regional Storage, almacenamiento estándar y almacenamiento de disponibilidad reducida duraderos anteriores a 365 días (un año) a Nearline Storage. La segunda regla cambia los objetos de Nearline Storage de más de 1095 días (tres años) a Coldline Storage. Esta configuración de ciclo de vida se aplica a los objetos en el segmento, independientemente de cuándo se agregaron.
Ten en cuenta que esta configuración de ciclo de vida se aplica a los segmentos en ubicaciones multirregionales. En el caso de segmentos en ubicaciones regionales, sustituye "MULTI_REGIONAL"
por "REGIONAL"
.
Consola
La siguiente regla mueve objetos a Nearline después de 365 días:
La siguiente regla mueve objetos a Coldline después de 1095 días:
gsutil
La siguiente configuración de ciclo de vida se puede aplicar a un segmento habilitando la gestión del ciclo de vida.
{ "lifecycle": { "rule": [ { "action": { "type": "SetStorageClass", "storageClass": "NEARLINE" }, "condition": { "age": 365, "matchesStorageClass": ["MULTI_REGIONAL", "STANDARD", "DURABLE_REDUCED_AVAILABILITY"] } }, { "action": { "type": "SetStorageClass", "storageClass": "COLDLINE" }, "condition": { "age": 1095, "matchesStorageClass": ["NEARLINE"] } } ] } }
Para obtener el formato generalizado de un archivo de configuración de ciclo de vida, consulta la representación de recursos de segmentos para JSON.
APIs REST
API JSON
La siguiente configuración de ciclo de vida se puede aplicar a un segmento habilitando la gestión del ciclo de vida.
{ "lifecycle": { "rule": [ { "action": { "type": "SetStorageClass", "storageClass": "NEARLINE" }, "condition": { "age": 365, "matchesStorageClass": ["MULTI_REGIONAL", "STANDARD", "DURABLE_REDUCED_AVAILABILITY"] } }, { "action": { "type": "SetStorageClass", "storageClass": "COLDLINE" }, "condition": { "age": 1095, "matchesStorageClass": ["NEARLINE"] } } ] } }
Para obtener el formato generalizado de un archivo de configuración de ciclo de vida, consulta la representación de recursos de segmentos para JSON.
API XML
La siguiente configuración de ciclo de vida se puede aplicar a un segmento habilitando la gestión del ciclo de vida.
<?xml version="1.0" encoding="UTF-8" ?> <LifecycleConfiguration> <Rule> <Action> <SetStorageClass>NEARLINE</SetStorageClass> </Action> <Condition> <Age>365</Age> <MatchesStorageClass>MULTI_REGIONAL</MatchesStorageClass> <MatchesStorageClass>STANDARD</MatchesStorageClass> <MatchesStorageClass>DURABLE_REDUCED_AVAILABILITY</MatchesStorageClass> </Condition> </Rule> <Rule> <Action> <SetStorageClass>COLDLINE</SetStorageClass> </Action> <Condition> <Age>1095</Age> <MatchesStorageClass>NEARLINE</MatchesStorageClass> </Condition> </Rule> </LifecycleConfiguration>
Para obtener el formato generalizado de un archivo de configuración de ciclo de vida, consulta el formato de configuración de ciclo de vida para XML.