Acessar ciclo de vida do bucket

Para listar a configuração do ciclo de vida de um intervalo, faça uma solicitação GET com escopo para o bucket e use o parâmetro de string de consulta lifecycle. A configuração do ciclo de vida é retornada em um documento XML no corpo da resposta.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
lifecycle É possível usá-lo para exibir a configuração do ciclo de vida de um bucket atual. Não

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Veja cabeçalhos de solicitação comuns.

Elementos do corpo da solicitação

Esta solicitação não inclui um documento XML no corpo da solicitação.

Sintaxe da solicitação

A sintaxe a seguir se aplica às solicitações GET Bucket que usam o 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

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

Os elementos do corpo de resposta a seguir são aplicáveis somente se você usar o parâmetro de string de consulta lifecycle para exibir a configuração do ciclo de vida do intervalo.

Element Descrição
LifecycleConfiguration Define as políticas de gerenciamento do ciclo de vida do bucket, que contém 0 ou mais regras (até 100). Um elemento vazio (por exemplo, <LifecycleConfiguration/>) significa que o gerenciamento do ciclo de vida não está ativado para o bucket.
Rule Define uma regra de gerenciamento do ciclo de vida, que é composta de uma ação e as condições que precisam ser atendidas para que a ação ocorra.
Action Define a ação a ser realizada quando as condições especificadas são atendidas.
Delete Elemento de ação para excluir objetos no bucket.
SetStorageClass Elemento de ação para alterar a classe de armazenamento de objetos no bucket.
Condition Condições que precisam ser atendidas para que a ação ocorra. Cada regra contém pelo menos um elemento de condição.
Age Elemento de condição que corresponde a objetos durante a idade especificada (em dias).
CreatedBefore Elemento de condição que corresponde a objetos criados antes da meia-noite, no horário UTC, da data especificada. O valor é uma string de data ISO sem fuso horário, por exemplo, 2019-01-15.
CustomTimeBefore Elemento de condição que corresponde a objetos com metadados Custom-Time que contêm uma data anterior à data definida por essa condição. CustomTimeBefore é uma string de data ISO sem fuso horário, por exemplo, 2020-02-25.
DaysSinceCustomTime Elemento de condição que corresponde a objetos com metadados Custom-Time com mais de DaysSinceCustomTime dias.
DaysSinceNoncurrentTime Elemento de condição relevante apenas para objetos com controle de versão. Corresponde a objetos que não foram atuais por mais tempo que o número especificado de dias.
IsLive O elemento de condição costuma ser usado apenas em conjunto com o controle de versão do objeto. Quando definida como false, essa condição é satisfeita para qualquer versão não atual de um objeto. Quando definida como true, essa condição é satisfeita para a versão ativa de um objeto. Se você não usar o controle de versões de objeto, todos os objetos serão considerados ativos e correspondentes quando IsLive for true.
MatchesStorageClass Elemento de condição que corresponde a objetos que têm a classe de armazenamento fornecida.
NoncurrentTimeBefore Elemento de condição relevante apenas para objetos com controle de versão. Corresponde a objetos que se tornaram não atuais em uma data anterior à data especificada nessa condição. NoncurrentTimeBefore é uma string de data ISO sem fuso horário, por exemplo, 2020-02-25.
NumberOfNewerVersions Elemento de condição relevante apenas para objetos com controle de versão. Se o valor for N, a condição será satisfeita quando houver pelo menos N versões (incluindo a versão ativa) mais recentes que essa versão do objeto.