Administra ciclos de vida de 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 Administración del ciclo de vida de los objetos.

Configura la administración del ciclo de vida

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 depósitos, busca el depósito que deseas habilitar y haz clic en el botón Ninguno en la columna Ciclo de vida.

    Aparecerá 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 en las que se realiza una acción.

    2. Haz clic en Continuar.

    3. Selecciona la acción que se debe 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 te gustaría aplicar (consulta los ejemplos a continuación).

  2. Usa el comando lifecycle set para aplicar la configuración y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

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

API de REST

API de JSON

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas para usar tus propias credenciales de OAuth.
  2. Crea un archivo .json con las reglas de configuración del ciclo de vida que te gustaría aplicar (consulta los ejemplos a continuación).
  3. Usa cURL para llamar a la API de JSON con una solicitud de PATCH Bucket y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:
    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 de XML

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas para usar tus propias credenciales de OAuth.
  2. Crea un cuerpo de la solicitud que incluya las reglas de configuración del ciclo de vida que te gustaría aplicar (consulta los ejemplos a continuación).
  3. Usa cURL para llamar a la API de XML con la solicitud de PUT Bucket y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:
    curl -X PUT --data-binary @[XML_FILE].xml \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

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 depósito que deseas inhabilitar y haz clic en el botón Habilitado en la columna Ciclo de vida.

    Aparecerá 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 y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

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

API de REST

API de JSON

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas 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 PATCH Bucket y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:
    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 de XML

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas para usar tus propias credenciales de OAuth.
  2. Crea un cuerpo de la solicitud que incluya 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 de XML con la solicitud de PUT Bucket y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:
    curl -X PUT --data-binary @[XML_FILE].xml \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

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 y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

    gsutil lifecycle get gs://[BUCKET_NAME]

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 la solicitud de GET Bucket y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:
    curl -X GET -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API de XML

  1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas para usar tus propias credenciales de OAuth.
  2. Usa cURL para llamar a la API de XML con la solicitud de GET Bucket y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:
    curl -X GET \
        -H "Authorization: Bearer [OAUTH2_TOKEN]" \
        "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

Ejemplos de configuración del ciclo de vida

En los ejemplos siguientes, se muestran opciones de configuración específicas del ciclo de vida que permiten borrar objetos y cambiar la clase de almacenamiento de objetos cuando se cumplen los criterios comunes. Para ver un debate 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 3 versiones más nuevas.

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 del depósito 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 del depósito 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>

Para el formato generalizado de un archivo de configuración de 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 que 365 días (un año) y su clase de almacenamiento actual es Multi-Regional Storage, Standard Storage o Disponibilidad reducida duradera.
  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 del depósito 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 del depósito 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>

Para el formato generalizado de un archivo de configuración de 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.