Gestionar los ciclos de vida de los objetos

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

Aviso: Cuando cambies la configuración del ciclo de vida, la gestión del ciclo de vida de los objetos aún puede realizar acciones basadas en la configuración anterior durante hasta 24 horas. Por ejemplo, si cambia una condición de Age de 10 días a 20 días, la gestión del ciclo de vida de los objetos puede eliminar un objeto que tiene 11 días de antigüedad hasta 24 horas después, según la configuración anterior.

Nota: El soporte para esta característica a través de las bibliotecas cliente de Google Cloud no está disponible actualmente. El soporte para esta característica a través de las bibliotecas cliente de las API de Google está actualmente disponible como una alternativa.

Habilitar la gestión del ciclo de vida

Para habilitar la gestión del ciclo de vida de un segmento:

Consola

1. Abre el explorador de Cloud Storage en la consola de Google Cloud Platform.
   Abrir el navegador de Cloud Storage

2. En 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.

3. Haz clic en Añadir regla.

4. En la página que aparece, especifica una configuración.

   1. Selecciona las condiciones bajo las cuales se realiza una acción.

   2. Haz clic en Continuar.

   3. Selecciona la acción que se realizará cuando un objeto cumpla con las condiciones.

   4. Haz clic en Continuar.

   5. Haz clic en Guardar.

gsutil

1. Crea un archivo .json con las reglas de configuración del ciclo de vida que querrías aplicar (ver ejemplos a continuación).

2. 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

1. 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.
2. Crea un archivo .json con las reglas de configuración del ciclo de vida que querrías aplicar (ver ejemplos a continuación).
3. Usa cURL para llamar a la API JSON con una petición de PATCH 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

1. 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.
2. 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).
3. Usa cURL para llamar a la API XML con una petición de PUT 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

1. Abre el explorador de Cloud Storage en la consola de Google Cloud Platform.
   Abrir el navegador de Cloud Storage

2. En 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.

3. Haz clic en Eliminar todo.

4. En la ventana de confirmación que aparece, haz clic en Eliminar.

Nota: Puedes eliminar reglas individuales haciendo clic en el icono de la papelera asociado a la regla que deseas eliminar.

gsutil

1. Crea un archivo .json con una configuración de ciclo de vida vacía:

   {}

2. 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

1. 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.
2. Crea un archivo .json con una configuración de ciclo de vida vacía:

   {}

3. Usa cURL para llamar a la API JSON con una petición de PATCH 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

1. 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.
2. 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/>

3. Usa cURL para llamar a la API XML con una petición de PUT 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

1. Abre el explorador de Cloud Storage en la consola de Google Cloud Platform.
   Abrir el navegador de Cloud Storage

2. En 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

1. Usa el comando lifecycle get, sustituyendo [VALUES_IN_BRACKETS] por los valores correspondientes:

   gsutil lifecycle get gs://[BUCKET_NAME]

APIs REST

API JSON

1. 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. .
2. Usa cURL para llamar a la API JSON con una petición de GET 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

1. 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.
2. Usa cURL para llamar a la API XML con una petición de GET 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.

Aviso: Una vez que se elimina un objeto, no se puede recuperar.Ten cuidado al configurar las reglas del ciclo de vida para que no se eliminen más datos de los que deseas. Se recomienda probar las reglas del ciclo de vida en los datos de desarrollo antes de aplicarlas a la producción, así como observar los metadatos de la fecha de caducidad para garantizar que la regla tiene el efecto deseado.

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.

Nota: La condición IsLive en la segunda regla del ejemplo anterior es opcional, porque la condición NumberOfNewerVersions ya garantiza que los objetos activos no se eliminarán (ya que un objeto activo tiene 0 versiones más recientes).

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.