Este documento apresenta exemplos comuns de configurações de ciclo de vida para ajudar você a gerenciar objetos em seus buckets por meio de regras de ciclo de vida.
Condição de filtro única
Toda regra de ciclo de vida contém pelo menos uma condição de filtro. Essa condição determina os objetos do bucket aos quais a regra se aplica. Os exemplos a seguir demonstram como especificar condições de filtro em uma regra de ciclo de vida.
Exemplo 1: Transição e exclusão de objetos com um prefixo específico após um número definido de dias
Nesta regra de ciclo de vida, a condição de filtro define o prefixo doc/. A regra se aplica a objetos com o prefixo doc/, como doc/test1.txt e doc/test2.jpg. Ela move os objetos para a classe de armazenamento Infrequent Access (IA) 180 dias após a última modificação e os exclui 365 dias após essa data.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule0</ID> <Prefix>doc/</Prefix> <Status>Enabled</Status> <Transition> <Days>180</Days> <StorageClass>IA</StorageClass> </Transition> <Expiration> <Days>365</Days> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
@id="image_f8h_i86_m2k"
Parâmetros de configuração da regra de ciclo de vida no console:
Status: Enabled
Policy: Match by prefix, prefixo:
doc/File time policy: Number of days
Regra 1: O sistema move os dados automaticamente para Infrequent Access (IA) 180 dias após a última modificação
Regra 2: O sistema exclui os dados 365 dias após a última modificação (não é possível recuperar dados excluídos)
Fragment expiration policy: Disabled
Exemplo 2: Exclusão de todos os objetos em um bucket após um número definido de dias
Esta regra de ciclo de vida abrange todos os objetos de um bucket e os expira 300 dias após a última modificação.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule1</ID> <Prefix></Prefix> <Status>Enabled</Status> <Expiration> <Days>300</Days> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
@id="image_cgz_xn0_hvm"
Principais itens de configuração da regra de ciclo de vida no console:
Status: Enabled
Policy: Applied to the entire bucket
File time policy: Number of days
Lifecycle management rule: O sistema exclui os dados automaticamente 300 dias após a última modificação (não é possível recuperar dados excluídos)
Fragment expiration policy: Disabled
Exemplo 3: Exclusão de todos os objetos em um bucket após uma data específica
Esta regra de ciclo de vida se aplica a todos os objetos de um bucket (prefixo vazio). Ela expira todos os objetos cuja última modificação ocorreu antes de 30 de dezembro de 2023.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule0</ID> <Prefix></Prefix> <Status>Enabled</Status> <Expiration> <CreatedBeforeDate>2023-12-30T00:00:00.000Z</CreatedBeforeDate> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
@id="image_kyi_zrz_8j6"
Parâmetros específicos de configuração da regra de ciclo de vida:
Status: Selecione Enabled
Policy: Selecione Applied to the entire bucket
File time policy: Selecione Specific date. Defina a regra de gerenciamento de ciclo de vida para aplicar-se a objetos com última modificação anterior a 30 de dezembro de 2023
Processamento de dados: Selecione Data deletion (deleted data cannot be recovered)
Fragment expiration policy: Selecione Disabled
Condições de filtro sobrepostas
Os exemplos a seguir descrevem como o sistema trata conflitos entre ações de ciclo de vida quando há sobreposição de condições de filtro.
Exemplo 1: Ações de ciclo de vida baseadas em prefixos sobrepostos (sem conflito)
Considere a configuração de duas regras de ciclo de vida com prefixos sobrepostos. Detalhes das regras:
Regra 1: Especifica o prefixo test/ e move os objetos para a classe de armazenamento Archive 30 dias após a última modificação.
Regra 2: Aplica-se a todo o bucket (prefixo vazio) e exclui todos os objetos 365 dias após a última modificação.
Resultado: Não há conflito entre as regras. As ações definidas na Regra 1 e na Regra 2 entram em vigor.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule1</ID> <Prefix>test/</Prefix> <Status>Enabled</Status> <Transition> <Days>30</Days> <StorageClass>Archive</StorageClass> </Transition> </Rule> <Rule> <ID>test-rule2</ID> <Prefix></Prefix> <Status>Enabled</Status> <Expiration> <Days>365</Days> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
-
Regra 1@id="image_utj_bh4_olt"
Configuração da regra de ciclo de vida para a Regra 1:
Status: Enabled
Policy: Match by prefix, prefixo:
test/File time policy: Number of days. O sistema move os dados automaticamente para a classe de armazenamento Archive 30 dias após a última modificação
Fragment expiration policy: Disabled
-
Regra 2@id="image_anx_b0q_ow2"
Status: Enabled
Policy: Applied to the entire bucket
File time policy: Number of days. O sistema exclui os dados automaticamente 365 dias após a última modificação (não é possível recuperar dados excluídos)
Fragment expiration policy: Disabled
-
Exemplo 2: Ações de ciclo de vida baseadas em filtragem por tag (conflito)
Considere a especificação de duas regras de ciclo de vida. Detalhes das regras:
Regra 1: Define uma condição de filtro baseada em tag (tag1/value1) e move os objetos para a classe de armazenamento IA 180 dias após a última modificação.
Regra 2: Define uma condição de filtro baseada em tag (tag2/value2) e expira os objetos 10 dias após a última modificação.
Condição: Um objeto possui ambas as tags; portanto, as duas regras se aplicam a ele.
Resultado: O objeto expira 10 dias após a última modificação. Como o objeto é excluído, a transição de classe de armazenamento não ocorre. Assim, apenas a ação de expiração da Regra 2 entra em vigor.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule1</ID> <Prefix></Prefix> <Tag> <Key>tag1</Key> <Value>value1</Value> </Tag> <Status>Enabled</Status> <Transition> <Days>180</Days> <StorageClass>IA</StorageClass> </Transition> </Rule> <Rule> <ID>test-rule2</ID> <Prefix></Prefix> <Tag> <Key>tag2</Key> <Value>value2</Value> </Tag> <Status>Enabled</Status> <Expiration> <Days>10</Days> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
-
Regra 1@id="image_227_mzc_2f8"
Configuração no console para a Regra 1:
Status: Enabled
Policy: Applied to the entire bucket
Tag:
tag1:value1File time policy: Number of days. O sistema move os dados automaticamente para Infrequent Access (IA) 180 dias após a última modificação
-
Regra 2@id="image_qs5_vmn_vw5"
Configuração de ciclo de vida para a Regra 2:
Status: Enabled
Policy: Applied to the entire bucket
Tag:
tag2:value2File time policy: Number of days
Lifecycle management rule: O sistema executa a Data deletion 10 dias após a última modificação (não é possível recuperar dados excluídos)
-
Exemplo 3: Ações de ciclo de vida baseadas no mesmo período de tempo (conflito)
Considere a especificação de duas regras de ciclo de vida. Detalhes das regras:
Regra 1: Determina a conversão de objetos com última modificação há mais de 365 dias para objetos IA.
Regra 2: Determina a exclusão de objetos com última modificação há mais de 365 dias.
Resultado da execução: O sistema exclui os objetos correspondentes às regras após 365 dias da última modificação.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>rule1</ID> <Prefix></Prefix> <Status>Enabled</Status> <Transition> <Days>365</Days> <StorageClass>IA</StorageClass> </Transition> </Rule> <Rule> <ID>rule2</ID> <Prefix></Prefix> <Status>Enabled</Status> <Expiration> <Days>365</Days> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
-
Regra 1@id="image_ldr_4ti_lpz"
Configuração para a Regra 1:
Policy: Selecione Applied to the entire bucket
File time policy: Selecione Number of days. Regra: O sistema move os dados automaticamente para Infrequent Access (IA) 365 dias após a última modificação
Fragment expiration policy: Selecione Disabled
-
Regra 2@id="image_dv9_qil_7z2"
Configuração de ciclo de vida para a Regra 2:
Status: Enabled
Policy: Applied to the entire bucket
File time policy: Number of days
Lifecycle management rule: O sistema exclui os dados automaticamente 365 dias após a última modificação (não é possível recuperar dados excluídos)
Fragment expiration policy: Disabled
-
Exemplo 4: Ações de ciclo de vida baseadas em prefixos sobrepostos que especificam a mesma ação (conflito)
Considere a especificação de duas regras de ciclo de vida. Detalhes das regras:
Regra 1: Determina a transição de objetos com o prefixo logs/ para a classe de armazenamento Infrequent Access 180 dias após a última modificação.
Regra 2: Determina a transição de todos os objetos no bucket atual para a classe de armazenamento Infrequent Access 30 dias após a última modificação.
Resultado: O sistema move todos os objetos do bucket para a classe de armazenamento Infrequent Access 30 dias após a última modificação.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>rule1</ID> <Prefix>logs/</Prefix> <Status>Enabled</Status> <Transition> <Days>180</Days> <StorageClass>IA</StorageClass> </Transition> </Rule> <Rule> <ID>rule2</ID> <Prefix></Prefix> <Status>Enabled</Status> <Transition> <Days>30</Days> <StorageClass>IA</StorageClass> </Transition> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
-
Regra 1@id="image_z03_ysx_iye"
Configuração no console para a Regra 1:
Status: Enabled
Policy: Match by prefix, prefixo:
logs/File time policy: Number of days. O sistema move os dados automaticamente para a classe de armazenamento Infrequent Access (IA) 180 dias após a última modificação
Fragment expiration policy: Disabled
-
Regra 2@id="image_ie7_6vp_0t4"
Configuração da Regra 2: Status definido como Enabled. File time policy definida como Number of days. A regra de gerenciamento de ciclo de vida determina que o sistema mova os dados automaticamente para a classe de armazenamento Infrequent Access (IA) 30 dias após a última modificação. Fragment expiration policy definida como Disabled.
-
Desativação de uma regra de ciclo de vida
Considere a especificação de duas regras de ciclo de vida. Detalhes das regras:
Regra 1 (Desativada): Determina a transição de objetos com o prefixo
logs/para a classe de armazenamento IA 100 dias após a criação.Regra 2 (Ativada): Determina a transição de objetos com o prefixo
documents/para a classe de armazenamento Archive 50 dias após a criação.
Resultado: Apenas a regra ativada entra em vigor.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule1</ID> <Prefix>logs/</Prefix> <Status>Disabled</Status> <Transition> <Days>100</Days> <StorageClass>IA</StorageClass> </Transition> </Rule> <Rule> <ID>test-rule2</ID> <Prefix>documents/</Prefix> <Status>Enabled</Status> <Transition> <Days>50</Days> <StorageClass>Archive</StorageClass> </Transition> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
-
Regra 1@id="image_mh8_8rv_j29"
Configuração da regra de ciclo de vida para a Regra 1:
Policy: Match by prefix, prefixo:
logs/File time policy: Number of days. O sistema move os dados automaticamente para Infrequent Access (IA) 100 dias após a última modificação
Fragment expiration policy: Disabled
Status: Disabled
-
Regra 2@id="image_8o3_g0y_iy7"
Configuração para a Regra 2: Policy definida como Match by prefix, prefixo:
documents/. File time policy definida como Number of days, com o sistema movendo os dados automaticamente para a classe de armazenamento Archive 50 dias após a última modificação. Fragment expiration policy definida como Disabled.
-
Regras de ciclo de vida com versionamento
Quando o versionamento está ativado, cada objeto no bucket possui uma versão atual e zero ou mais versões não atuais. Para mais informações sobre versionamento, consulte Versionamento.
Exemplo 1: Transição e exclusão de versões não atuais de objetos após um número definido de dias
Neste exemplo, uma regra de ciclo de vida é configurada para um bucket com versionamento ativado. A regra move as versões atuais dos objetos para a classe de armazenamento IA 10 dias após a última modificação. Além disso, ela move as versões não atuais para a classe de armazenamento Archive 60 dias após se tornarem não atuais e as exclui 90 dias após esse evento.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule0</ID> <Prefix></Prefix> <Status>Enabled</Status> <Transition> <Days>10</Days> <StorageClass>IA</StorageClass> </Transition> <NoncurrentVersionTransition> <NoncurrentDays>60</NoncurrentDays> <StorageClass>Archive</StorageClass> </NoncurrentVersionTransition> <NoncurrentVersionExpiration> <NoncurrentDays>90</NoncurrentDays> </NoncurrentVersionExpiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
@id="image_oc4_yfo_fh6"
Detalhes da configuração:
Status: Selecione Enabled. Policy: Selecione Match by prefix
Current version file execution policy: File time policy: Selecione Number of days. Configure a transição automática dos dados para Infrequent Access (IA) 10 dias após a última modificação
Noncurrent version file execution policy: File time policy: Selecione Number of days. Configure a transição para a classe de armazenamento Archive 60 dias após o objeto tornar-se não atual e a delete dos dados 90 dias após o objeto tornar-se não atual (não é possível recuperar dados excluídos)
Fragment execution policy: Selecione Disabled
Exemplo 2: Exclusão de marcadores de exclusão expirados
Se a única versão de um objeto for um marcador de exclusão, ele será considerado um marcador de exclusão expirado. O exemplo a seguir mostra uma regra de ciclo de vida que remove marcadores de exclusão expirados.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>test-rule0</ID> <Prefix></Prefix> <Status>Enabled</Status> <Expiration> <ExpiredObjectDeleteMarker>true</ExpiredObjectDeleteMarker> </Expiration> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
@id="image_p65_1o0_nyr"
Configuração da regra de ciclo de vida:
Status: Selecione Enabled
Policy: Selecione Applied to the entire bucket
Current version file execution policy: File time policy: Selecione Remove expired delete markers
Noncurrent version file execution policy: File time policy: Selecione Disabled
Fragment execution policy: Fragment expiration policy: Selecione Disabled
Limpeza de fragmentos expirados
Este exemplo apresenta uma regra de ciclo de vida que expira fragmentos com o prefixo logs/ após 5 dias. Fragmentos são partes de um upload multipart para o qual a operação CompleteMultipartUpload não foi executada.
Os exemplos a seguir mostram as configurações XML e no console para esta regra de ciclo de vida:
-
XML
<LifecycleConfiguration> <Rule> <ID>lifecyclerule1</ID> <Prefix>logs/</Prefix> <Status>Enabled</Status> <AbortMultipartUpload> <Days>5</Days> </AbortMultipartUpload> </Rule> </LifecycleConfiguration> -
Console
NotaVocê também pode usar o console para configurar uma regra de ciclo de vida com essas condições. Para mais informações, consulte Definir regras de ciclo de vida.
@id="image_b91_v3x_kia"
Configuração da regra de ciclo de vida no console:
Status: Enabled
Policy: Match by prefix, prefixo:
logs/File time policy: Disabled
Fragment expiration policy: Number of days. O sistema exclui automaticamente fragmentos gerados há mais de 5 dias (não é possível recuperar dados excluídos)