Object Storage Service:Elementos de configuración

Ejemplo en 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>        

En a continuación secciones se describen los elementos que puede configure en el archivo de configuración de las reglas de ciclo de vida para objetos, como los elementos ID y Operation.

ID

El elemento ID especifique el identificador de la regla de ciclo de vida configurada para un bucket. Este identificador puede tener una longitud máxima de 255 bytes. Si no configure este elemento o lo deja vacío, Object Storage Service (OSS) genera automáticamente un ID único para la regla de ciclo de vida.

Status

El elemento Status especifique el estado de la regla de ciclo de vida. Puede establezca el estado en Enabled o Disabled. Solo surten efecto las reglas de ciclo de vida cuyo elemento Status esté establecido en Enabled.

Prefix

El elemento Prefix especifique el prefijo del nombre de objeto con base en el cual la regla de ciclo de vida se aplica a todos los objetos de un bucket o solo a algunos.

Filter

El elemento Filter especifique la condición de filtro de una regla de ciclo de vida. Los objetos que cumplen todas las condiciones indicadas en este elemento coinciden con la regla.

Not

Cuando utiliza una regla de ciclo de vida para procesar objetos cuyo nombre contiene un prefijo específico y que tienen etiquetas determinadas, es posible que desee omitir ciertos objetos. En ese caso, especifique en el elemento Not los prefijos de nombre y las etiquetas de los objetos que desea elimine.

Ejemplos:

• Configure una regla de ciclo de vida con el ID rule1 y establezca que los objetos cuyo nombre contenga el prefijo dir1 se eliminen 30 días después de su última modificación.

• Configure una regla de ciclo de vida con el ID rule2. Establezca que la clase de almacenamiento de los objetos cuyo nombre contenga el prefijo dir1 se convierta a Infrequent Access (IA) 20 días después de su última modificación. Además, utilice el elemento Not para indicar que la clase de almacenamiento de los objetos del directorio dir1/dir2/ no se convierta.

<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, el elemento Not solo surte efecto en rule2. Con base en rule1, los objetos cuyo nombre contiene el prefijo dir1 se eliminan 30 días después de su última modificación.

Para obtener más información, consulte Lifecycle rules based on the last modified time.

Time

• Date

  El elemento secundario <CreatedBeforeDate> especifique una fecha fija. Se eliminan todos los objetos cuya última modificación ocurrió antes de esa fecha, o bien se convierte su clase de almacenamiento.

• Days

  El elemento secundario <Days> especifique el periodo de validez de los objetos contado desde su última modificación. Una vez que finaliza dicho periodo, los objetos se eliminan o se convierte su clase de almacenamiento.

Operation

Puede configure uno o varios elementos Operation en una regla de ciclo de vida para los objetos que coincidan con ella. OSS ejecuta las operaciones especificadas cuando dichos objetos caducan. El efecto de estas operaciones varía según el estado de control de versiones del bucket donde se almacenan. A continuación tablas describen cómo el estado de control de versiones del bucket afecta la operación indicada en la regla de ciclo de vida.

• Bucket con el control de versiones deshabilitado

  Operación	Descripción
  Transition	La clase de almacenamiento de los objetos que coinciden con la regla de ciclo de vida se convierte cuando estos caducan, según la fecha o el periodo de validez especificados en la regla. Para obtener más información sobre las clases de almacenamiento disponibles en las reglas de ciclo de vida, consulte Convert storage classes.
  Expiration	Los objetos que coinciden con la regla de ciclo de vida se eliminan cuando caducan, según la fecha o el periodo de validez especificados en la regla.

• Bucket con el control de versiones habilitado

  A continuación tablas describen los elementos Operation que se pueden especifique en las reglas de ciclo de vida para objetos en buckets con control de versiones. Estos incluyen tanto los buckets con el control de versiones habilitado como aquellos donde se suspendió:

  • Operación de eliminación o conversión de clase de almacenamiento en la versión actual de un objeto

    Operación	Descripción
    Expiration	La operación que se ejecuta sobre un objeto caducado varía según si la versión actual del objeto es un marcador de eliminación. Si la versión actual del objeto no es un marcador de eliminación, OSS procesa la versión según a continuación reglas: Si el control de versiones está habilitado en el bucket que almacena el objeto, OSS inserta un marcador de eliminación con un ID de versión único. Después, la versión actual del objeto se reemplaza por el marcador de eliminación insertado. Si el control de versiones está suspendido en el bucket que almacena el objeto, OSS inserta un marcador de eliminación cuyo ID de versión es null. Este marcador sobrescribe la versión actual del objeto con ID de versión null, lo que garantiza que solo exista una versión del objeto con dicho ID. Si la versión actual del objeto es un marcador de eliminación, OSS procesa la versión según a continuación reglas: Si existen una o más versiones anteriores del objeto, no se activa ninguna operación especificada en la regla de ciclo de vida. Si solo existe una versión del objeto, el marcador de eliminación se quita cuando caduca según la fecha o el periodo de validez especificados en la regla de ciclo de vida, o bien cuando el elemento secundario ExpiredObjectDeleteMarker se establece en true dentro de dicha regla. Importante Si se activa la operación Expiration de una regla de ciclo de vida configurada para un objeto con el fin de eliminar su versión actual, o si se inicia una operación de eliminación sin especificar una versión del objeto, la versión actual pasa a ser una versión anterior. Por otro lado, si se activa la operación Expiration para eliminar una versión anterior, o si se inicia una operación de eliminación sobre una versión anterior específica, esta se borra permanentemente y solo se conserva el marcador de eliminación caducado del objeto. No es posible configure el elemento secundario ExpiredObjectDeleteMarker y especifique una etiqueta en la misma regla de ciclo de vida.
    Transition	La clase de almacenamiento de la versión actual de los objetos que coinciden con la regla de ciclo de vida se convierte cuando estos caducan, según la fecha o el periodo de validez especificados en la regla.

  • Operación de eliminación o conversión de clase de almacenamiento en las versiones anteriores de los objetos

    Operación	Descripción	Elemento secundario asociado
    NoncurrentVersionExpiration	Los objetos que coinciden con la regla de ciclo de vida se eliminan cuando sus versiones anteriores caducan, según la fecha o el periodo de validez especificados en la regla.	El elemento secundario <NoncurrentDays> especifique el número de días transcurridos desde que las versiones actuales pasan a ser versiones anteriores hasta que estas últimas se eliminan permanentemente. Nota Por ejemplo, suponga que una versión era la versión actual de un objeto antes del 1 de mayo de 2019. Ese día se invocó la operación PutObject y dicha versión pasó a ser una versión anterior. En el elemento NoncurrentVersionExpiration, <NoncurrentDays> se estableció en 3. Como resultado, el 4 de mayo de 2019 la versión se eliminó permanentemente. Cada vez que se invoca la operación PutObject para un objeto, su versión actual se convierte en la versión anterior más reciente, mientras que la versión cargada pasa a ser la versión actual. OSS determina cuándo una versión se vuelve anterior con base en el momento de creación de a continuación versión.
    NoncurrentVersionTransition	La clase de almacenamiento de los objetos que coinciden con la regla de ciclo de vida se convierte cuando sus versiones anteriores caducan, según la fecha o el periodo de validez especificados en la regla.	El elemento secundario <NoncurrentDays> especifique el número de días transcurridos desde que las versiones actuales pasan a ser versiones anteriores hasta que se convierte la clase de almacenamiento de los objetos. El elemento secundario <StorageClass> especifique la clase de almacenamiento de destino a la que se convertirán los objetos.