Administra los ciclos de vida de los objetos

En esta página, se describe cómo habilitar la Administración del ciclo de vida de los objetos y se proporcionan ejemplos de políticas de ciclo de vida. Para obtener una descripción de esta característica, incluidas las acciones y las condiciones que admite, consulta la Administración del ciclo de vida de los objetos.

Configura la administración del ciclo de vida en un depósito

Habilita la administración del ciclo de vida

Para habilitar la administración del ciclo de vida de un depósito, haz lo siguiente:

Console

  1. Abre el navegador de Cloud Storage en Google Cloud Platform Console.
    Abrir el navegador de Cloud Storage
  2. En la lista de categorías, busca la que deseas habilitar y haz clic en Ninguna en la columna Ciclo de vida.

    Aparece la página de reglas del ciclo de vida.

  3. Haz clic en Agregar 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 debe realizarse cuando un objeto cumple 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 deseas aplicar (ver ejemplos).

  2. Usa el comando lifecycle set para aplicar la configuración:

    gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]

    donde:

    • [LIFECYCLE_CONFIG_FILE] es el nombre del archivo que creaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de REST

API de JSON

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Crea un archivo .json con las reglas de configuración del ciclo de vida que deseas aplicar (ver ejemplos).

  3. Usa cURL para llamar a la API de JSON con una solicitud de depósito PATCH:

    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"

    Donde:

    • [LIFECYCLE_CONFIG_FILE] es el nombre del archivo que creaste en el paso 2.
    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de XML

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Crea un archivo .xml con las reglas de configuración del ciclo de vida que deseas aplicar (ver ejemplos).

  3. Usa cURL para llamar a la API de XML con una solicitud de depósito PUT:

    curl -X PUT --data-binary @[XML_FILE].xml \
      -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      "https://storage.googleapis.com/[BUCKET_NAME]?lifecycle"

    Donde:

    • [XML_FILE] es el nombre del archivo que creaste en el paso 2.
    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Inhabilita la administración del ciclo de vida

Para inhabilitar la administración del ciclo de vida de un depósito, haz lo siguiente:

Console

  1. Abre el navegador de Cloud Storage en Google Cloud Platform Console.
    Abrir el navegador de Cloud Storage
  2. En la lista de depósitos, busca el que deseas inhabilitar y haz clic en el botón Habilitado en la columna Ciclo de vida.

    Aparece la página de reglas del ciclo de vida.

  3. Haz clic en Borrar todo.

  4. En la ventana de confirmación que se muestra, haz clic en Borrar.

gsutil

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

    {}
  2. Usa el comando lifecycle set:

    gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]

    donde:

    • [LIFECYCLE_CONFIG_FILE] es el nombre del archivo que creaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de REST

API de JSON

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar 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 de JSON con una solicitud de depósito PATCH:

    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"

    Donde:

    • [LIFECYCLE_CONFIG_FILE] es el nombre del archivo que creaste en el paso 2.
    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de XML

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Crea un archivo .xml con una configuración de ciclo de vida vacía:

    <LifecycleConfiguration/>
  3. Usa cURL para llamar a la API de XML con una solicitud de depósito PUT:

    curl -X PUT --data-binary @[XML_FILE].xml \
      -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      "https://storage.googleapis.com/[BUCKET_NAME]?lifecycle"

    Donde:

    • [XML_FILE] es el nombre del archivo que creaste en el paso 2.
    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Comprueba la configuración del ciclo de vida

Para comprobar la configuración del ciclo de vida en un depósito, haz lo siguiente:

Console

  1. Abre el navegador de Cloud Storage en Google Cloud Platform Console.
    Abrir el navegador de Cloud Storage
  2. 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.

gsutil

  1. Usa el comando lifecycle get:

    gsutil lifecycle get gs://[BUCKET_NAME]

    En el que [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de REST

API de JSON

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Usa cURL para llamar a la API de JSON con una solicitud de depósito GET:

    curl -X GET \
      -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

    Donde:

    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de XML

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Usa cURL para llamar a la API de XML con una solicitud de depósito GET:

    curl -X GET \
      -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      "https://storage.googleapis.com/[BUCKET_NAME]?lifecycle"

    Donde:

    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Ejemplos de configuración del ciclo de vida de los objetos

En los ejemplos siguientes, se muestran opciones de configuración específicas del ciclo de vida que permiten borrar objetos y cambiar su clase de almacenamiento cuando se cumplen criterios comunes. Para ver un análisis detallado sobre las opciones de configuración del ciclo de vida, incluida una lista de acciones y condiciones disponibles, consulta Administración del ciclo de vida de los objetos.

Borra un objeto

La configuración del ciclo de vida siguiente define dos reglas:

  1. Borrar todos los objetos activos de más de 30 días de antigüedad
  2. Borrar los objetos archivados con más de 10 días de antigüedad. Ten en cuenta que esta regla solo se cumple para los depósitos que tienen (o tuvieron) habilitado el control de versiones de los objetos.

Console

La regla siguiente borra los objetos activos que tengan más de 30 días de antigüedad:

Borra los objetos activos de más de 30 días.

La regla siguiente borra los objetos archivados que tengan más de 10 días de antigüedad:

Borrar los objetos archivados con más de 10 días de antigüedad.

gsutil

La configuración del ciclo de vida siguiente se puede aplicar a un depósito. Para ello, habilita la administració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 del ciclo de vida, consulta la representación de recursos de depósitos para JSON.

API de REST

API de JSON

La configuración del ciclo de vida siguiente se puede aplicar a un depósito. Para ello, habilita la administració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 del ciclo de vida, consulta la representación de recursos de depósitos para JSON.

API de XML

La configuración del ciclo de vida siguiente se puede aplicar a un depósito. Para ello, habilita la administració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>

Si deseas ver el formato generalizado de un archivo de configuración del ciclo de vida, consulta el formato de configuración del ciclo de vida para XML.

Cambia la clase de almacenamiento de un objeto

La configuración del ciclo de vida siguiente define dos reglas:

  1. Cambia la clase de almacenamiento de un objeto a Nearline Storage si su antigüedad es mayor a 365 días (un año) y su clase de almacenamiento actual es Standard Storage, Multi-Regional Storage o almacenamiento de disponibilidad reducida duradera (DRA).
  2. Cambia la clase de almacenamiento de un objeto a Coldline Storage si su antigüedad es superior a 1,095 días (tres años) y su clase de almacenamiento actual es Nearline Storage.

Console

La regla siguiente mueve los objetos a Nearline después de 365 días:

Configura los objetos como Nearline después de 365 días.

La regla siguiente mueve los objetos a Coldline después de 1,095 días:

Configura los objetos como Coldline después de 1,095 días.

gsutil

La configuración del ciclo de vida siguiente se puede aplicar a un depósito. Para ello, habilita la administració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 del ciclo de vida, consulta la representación de recursos de depósitos para JSON.

API de REST

API de JSON

La configuración del ciclo de vida siguiente se puede aplicar a un depósito. Para ello, habilita la administració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 del ciclo de vida, consulta la representación de recursos de depósitos para JSON.

API de XML

La configuración del ciclo de vida siguiente se puede aplicar a un depósito. Para ello, habilita la administració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>

Si deseas ver el formato generalizado de un archivo de configuración del ciclo de vida, consulta el formato de configuración del ciclo de vida para XML.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.