Object Storage Service:Elementos de configuração

Exemplo no formato XML

<LifecycleConfiguration>
<Rule>
 <ID>rule1</ID>
 <Prefix>logs/</Prefix>
 <Status>Enabled</Status>
 <Filter>
    <Not>
      <Prefix>logs1/</Prefix>
      <Tag><Key>key1</Key><Value>value1</Value></Tag>
    </Not>
 </Filter>
 <Expiration>
   <Days>10</Days>
  </Expiration>
</Rule>
<Rule>
 <ID>rule2</ID>
 <Prefix>doc/</Prefix>
 <Status>Disabled</Status>
 <Expiration>
   <CreatedBeforeDate>2017-12-31T00:00:00.000Z</CreatedBeforeDate>
 </Expiration>
</Rule>
<Rule>
 <ID>rule3</ID>
 <Prefix>logs2/</Prefix>
 <Tag><Key>xx</Key><Value>1</Value></Tag>
 <Status>Enabled</Status>
 <Transition>
   <Days>60</Days>
   <StorageClass>Archive</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>        

As seções a seguir descrevem os elementos que você pode configurar no arquivo de configuração de regras de ciclo de vida para objetos, como os elementos ID e Operation.

ID

O elemento ID especifica o ID da regra de ciclo de vida configurada para um bucket. O ID de uma regra de ciclo de vida pode ter até 255 bytes. Se você não configurar esse elemento ou deixá-lo vazio, o Object Storage Service (OSS) gera automaticamente um ID exclusivo para a regra de ciclo de vida.

Status

O elemento Status especifica o status da regra de ciclo de vida. Você pode definir o status como Enabled ou Disabled. Somente as regras de ciclo de vida com o elemento Status definido como Enabled entram em vigor.

Prefix

O elemento Prefix especifica o prefixo do nome do objeto com base no qual a regra de ciclo de vida é aplicada a todos ou a objetos específicos em um bucket.

Filter

O elemento Filter especifica a condição de filtro de uma regra de ciclo de vida. Os objetos que atendem a todas as condições especificadas no elemento Filter correspondem à regra.

Not

Ao usar a regra de ciclo de vida para processar objetos cujos nomes contêm um prefixo específico e que possuem tags específicas, talvez você queira ignorar determinados objetos. Nesse caso, especifique os prefixos de nome e as tags dos objetos que deseja ignorar no elemento Not.

Exemplos:

• Você configura uma regra de ciclo de vida com ID rule1 e especifica que os objetos cujos nomes contêm o prefixo dir1 são excluídos 30 dias após a última modificação.

• Você configura uma regra de ciclo de vida com ID rule2 e especifica que as classes de armazenamento dos objetos cujos nomes contêm o prefixo dir1 são convertidas para Infrequent Access (IA) 20 dias após a última modificação. Além disso, especifica que as classes de armazenamento dos objetos no diretório dir1/dir2/ não são convertidas por meio do elemento Not.

<LifecycleConfiguration>
  <Rule>
    <ID>rule1</ID>
    <Prefix>dir1/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>30</Days>
    </Expiration>
  </Rule>
  <Rule>
    <ID>rule2</ID>
    <Prefix>dir1/</Prefix>
    <Status>Disabled</Status>
    <Filter>
      <Not>
        <Prefix>dir1/dir2/</Prefix>
      </Not>
    </Filter>
    <Transition>
      <Days>20</Days>
      <StorageClass>IA</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>

Como resultado, o elemento Not entra em vigor somente para a rule2. Os objetos cujos nomes contêm o prefixo dir1 são excluídos 30 dias após a última modificação, com base na rule1.

Para mais informações, consulte Regras de ciclo de vida com base no horário da última modificação.

Time

• Data

  O elemento filho <CreatedBeforeDate> especifica uma data fixa. Todos os objetos modificados pela última vez antes dessa data são excluídos, ou suas classes de armazenamento são convertidas.

• Dias

  O elemento filho <Days> especifica o período de validade dos objetos após a última modificação. Quando o período de validade expira, os objetos são excluídos ou suas classes de armazenamento são convertidas.

Operation

Você pode configurar um ou mais elementos Operation em uma regra de ciclo de vida para objetos correspondentes à regra. O OSS executa as operações especificadas nos objetos quando eles expiram. O efeito das operações varia conforme o status de versionamento do bucket onde os objetos estão armazenados. As tabelas a seguir descrevem como o status de versionamento do bucket afeta a operação especificada na regra de ciclo de vida dos objetos.

• Bucket com versionamento desativado

  Operação	Descrição
  Transition	As classes de armazenamento dos objetos correspondentes à regra de ciclo de vida são convertidas quando os objetos expiram com base na data ou no período de validade especificado na regra. Para mais informações sobre as classes de armazenamento que podem ser especificadas nas regras de ciclo de vida, consulte Converter classes de armazenamento.
  Expiration	Os objetos correspondentes à regra de ciclo de vida são excluídos quando expiram com base na data ou no período de validade especificado na regra.

• Bucket com versionamento ativado

  As tabelas a seguir descrevem os elementos Operation que podem ser especificados nas regras de ciclo de vida para objetos em buckets versionados. Buckets versionados incluem os buckets com versionamento ativado e os buckets com versionamento suspenso:

  • Operação de exclusão ou conversão de classe de armazenamento na versão atual de um objeto

    Operação	Descrição
    Expiration	A operação executada em um objeto expirado varia conforme a versão atual do objeto seja um marcador de exclusão ou não. Se a versão atual do objeto não for um marcador de exclusão, o OSS processa a versão com base nas seguintes regras: Se o versionamento estiver ativado para o bucket que armazena o objeto, o OSS insere um marcador de exclusão com um ID de versão exclusivo. Em seguida, o marcador de exclusão inserido substitui a versão atual do objeto. Se o versionamento estiver suspenso para o bucket que armazena o objeto, o OSS insere um marcador de exclusão com ID de versão nulo. O marcador de exclusão inserido sobrescreve a versão atual do objeto com ID de versão nulo, garantindo que exista apenas uma versão do objeto com ID de versão nulo. Se a versão atual do objeto for um marcador de exclusão, o OSS processa a versão com base nas seguintes regras: Se existirem uma ou mais versões anteriores do objeto, nenhuma operação especificada na regra de ciclo de vida será acionada. Se existir apenas uma versão do objeto, o marcador de exclusão será removido quando expirar com base na data ou no período de validade especificado na regra de ciclo de vida, ou quando o elemento filho ExpiredObjectDeleteMarker estiver definido como true na regra. null Se a operação Expiration de uma regra de ciclo de vida configurada para um objeto for acionada para excluir a versão atual, ou se uma operação de exclusão for iniciada sem especificar a versão do objeto, a versão atual se torna uma versão anterior. Se a operação Expiration for acionada para excluir uma versão anterior do objeto, ou se uma operação de exclusão for iniciada em uma versão anterior específica, essa versão anterior é excluída permanentemente e apenas o marcador de exclusão expirado do objeto é mantido. Não é possível configurar o elemento filho ExpiredObjectDeleteMarker e especificar uma tag em uma regra de ciclo de vida ao mesmo tempo.
    Transition	A classe de armazenamento da versão atual dos objetos correspondentes à regra de ciclo de vida é convertida quando os objetos expiram com base na data ou no período de validade especificado na regra.

  • Operação de exclusão ou conversão de classe de armazenamento nas versões anteriores dos objetos

    Operação	Descrição	Elemento filho associado
    NoncurrentVersionExpiration	Os objetos correspondentes à regra de ciclo de vida são excluídos quando as versões anteriores expiram com base na data ou no período de validade especificado na regra.	O elemento filho <NoncurrentDays> especifica o número de dias desde o momento em que as versões atuais se tornam versões anteriores até o momento em que as versões anteriores são excluídas permanentemente. null Por exemplo, uma versão era a versão atual de um objeto antes de 1º de maio de 2019. Em 1º de maio de 2019, a operação PutObject foi chamada e essa versão se tornou uma versão anterior. No elemento NoncurrentVersionExpiration, <NoncurrentDays> está definido como 3. Em 4 de maio de 2019, a versão foi excluída permanentemente. Cada vez que a operação PutObject é chamada para um objeto, a versão atual se torna a versão anterior mais recente. A versão carregada se torna a versão atual do objeto. O OSS determina quando uma versão se torna uma versão anterior com base no momento em que a próxima versão é criada.
    NoncurrentVersionTransition	As classes de armazenamento dos objetos correspondentes à regra de ciclo de vida são convertidas quando as versões anteriores dos objetos expiram com base na data ou no período de validade especificado na regra.	O elemento filho <NoncurrentDays> especifica o número de dias desde o momento em que as versões atuais se tornam versões anteriores até o momento em que a classe de armazenamento dos objetos é convertida. O elemento filho <StorageClass> especifica a classe de armazenamento para a qual a classe de armazenamento dos objetos é convertida.