Obtener ciclo de vida de depósitos

Para enumerar la configuración del ciclo de vida de un depósito, debes realizar una solicitud GET a un depósito y usar el parámetro de string de consulta lifecycle. La configuración del ciclo de vida se muestra en un documento XML en el cuerpo de la respuesta.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
lifecycle Puedes usarlo para mostrar la configuración del ciclo de vida de un depósito existente. No

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Consulta encabezados de solicitud comunes.

Elementos de cuerpo de la solicitud

Esta solicitud no incluye un documento XML en el cuerpo de la solicitud.

Sintaxis de la solicitud

La siguiente sintaxis se aplica a las solicitudes del depósito GET que usan el parámetro de string de consulta lifecycle.

GET /?lifecycle HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de la solicitud que uses.

Elementos del cuerpo de la respuesta

Los siguientes elementos del cuerpo de respuesta solo se aplican si usas el parámetro de string de consulta lifecycle para mostrar la configuración del ciclo de vida del depósito.

Elemento Descripción
LifecycleConfiguration Define las políticas de administración del ciclo de vida para el depósito, que contiene 0 o más reglas (hasta 100). Un elemento vacío (por ejemplo, <LifecycleConfiguration/>) significa que la administración del ciclo de vida no está habilitada para el depósito.
Rule Define una regla de administración del ciclo de vida, que se realiza de una acción y las condiciones que deben cumplirse para que esta acción ocurra.
Action Define la acción que se debe realizar cuando se cumplen las condiciones especificadas.
Delete Elemento de acción para borrar objetos en el depósito.
SetStorageClass El elemento de acción para cambiar la clase de almacenamiento de los objetos del depósito
Condition Condiciones que se deben cumplir para que se lleve a cabo la acción. Cada regla contiene al menos un elemento de condición.
Age Elemento de condición que coincide con objetos sobre la edad especificada (en días).
CreatedBefore Elemento de condición que coincide con objetos creados antes de la medianoche de la fecha especificada en UTC. El valor es una string de fecha ISO sin una zona horaria, p.ej., 2019-01-15.
CustomTimeBefore Elemento de condición que coincide con objetos cuyos metadatos Custom-Time contienen una fecha anterior a la fecha establecida en esta condición. CustomTimeBefore es una string de fecha ISO sin una zona horaria, p.ej., 2020-02-25.
DaysSinceCustomTime Elemento de condición que coincide con objetos cuyos metadatos Custom-Time tienen más de DaysSinceCustomTime días de antig.edad.
DaysSinceNoncurrentTime Elemento de condición relevante solo para objetos con versión. Coincide con objetos que no han sido actuales por más de la cantidad de días especificada.
IsLive Por lo general, el elemento de condición solo se usa junto con el control de versiones de objetos. Cuando se establece en false, esta condición se cumple con las versiones no actuales de un objeto. Cuando se configura como true, esta condición se cumple con la versión publicada de un objeto. Si no usas el control de versiones de los objetos, todos tus objetos se consideran activos y coinciden cuando IsLive es true.
MatchesStorageClass Elemento de condición que coincide con objetos que tienen una clase de almacenamiento determinada.
NoncurrentTimeBefore Elemento de condición relevante solo para objetos con versión. Coincide con los objetos que se convirtieron en no actuales en una fecha anterior a la fecha especificada en esta condición. NoncurrentTimeBefore es una string de fecha ISO sin una zona horaria, p.ej., 2020-02-25.
NumberOfNewerVersions Elemento de condición relevante solo para objetos con versión. Si el valor es N, la condición se cumple cuando hay al menos N versiones (incluida la versión activa) más recientes que esta versión del objeto.