Object Storage Service:lifecycle

Notas de uso

• Crear o modificar reglas requiere el permiso oss:PutBucketLifecycle. Para consultarlas se necesita oss:GetBucketLifecycle. Eliminarlas requiere oss:DeleteBucketLifecycle. Para obtener más información, consulte Grant a custom policy.

• Antes de configurar reglas de ciclo de vida basadas en la hora de la última modificación o del último acceso de los objetos, asegúrese de familiarizarse con esta función. Para obtener más información, consulte Lifecycle rules based on the last modified time y Lifecycle rules based on the last access time.

• A partir de ossutil 1.6.16, puede usar ossutil directamente como nombre del comando, sin importar el sistema operativo. En versiones anteriores a la 1.6.16, debe utilizar el nombre del ejecutable específico del sistema operativo. Para más instrucciones, consulte References for ossutil commands.

• Para obtener más información sobre las reglas de ciclo de vida, consulte 生命周期.

• Las reglas de ciclo de vida pueden eliminar objetos en buckets de CloudBox, pero no pueden cambiar su clase de almacenamiento.

Crear o modificar reglas de ciclo de vida

Para crear o modificar reglas de ciclo de vida:

1. Cree un archivo XML local con las reglas de ciclo de vida.

2. Ejecute ossutil para aplicar la configuración al bucket de destino.

• Sintaxis del comando

  ossutil lifecycle --method put oss://bucketname local_xml_file

  Parámetros:

  Parámetro	Descripción
  bucketname	El nombre del bucket de destino.
  local_xml_file	El archivo XML local que contiene las reglas de ciclo de vida. Ejemplo: localfile.xml.

• Ejemplos

  Importante

  Puede definir varias reglas dentro de una sola configuración de ciclo de vida. Cada regla debe tener un ID único. Los IDs duplicados provocan que la operación falle con el código de estado HTTP 409.

  1. Cree un archivo llamado localfile.xml y defina las reglas de ciclo de vida.

     Configuraciones de ejemplo:

     • Ejemplo 1

       Esta configuración tiene dos reglas. test-rule1 se aplica a todos los objetos en examplebucket y los hace caducar 365 días después de la última modificación. test-rule2 se aplica a los objetos con el prefijo test/ y los transfiere a Archive 30 días después de la última modificación.

       Para obtener información sobre las clases de almacenamiento compatibles con las reglas de ciclo de vida, consulte Automatically convert object storage classes using lifecycle rules.

       <?xml version="1.0" encoding="UTF-8"?>
       <LifecycleConfiguration>
         <Rule>
           <ID>test-rule1</ID>
           <Prefix></Prefix>
           <Status>Enabled</Status>
           <Expiration>
             <Days>365</Days>
           </Expiration>
         </Rule>
         <Rule>
           <ID>test-rule2</ID>
           <Prefix>test/</Prefix>
           <Status>Enabled</Status>
           <Transition>
             <Days>30</Days>
             <StorageClass>Archive</StorageClass>
           </Transition>
         </Rule>
       </LifecycleConfiguration>

     • Ejemplo 2

       Esta regla hace caducar todos los objetos en examplebucket cuya hora de última modificación sea anterior al 30 de diciembre de 2019:

       <?xml version="1.0" encoding="UTF-8"?>
       <LifecycleConfiguration>
         <Rule>
           <ID>test-rule0</ID>
           <Prefix></Prefix>
           <Status>Enabled</Status>
           <Expiration>
             <CreatedBeforeDate>2019-12-30T00:00:00.000Z</CreatedBeforeDate>
           </Expiration>
         </Rule>
       </LifecycleConfiguration>

     • Ejemplo 3

       Para un bucket con control de versiones habilitado examplebucket, esta regla: Transfiere las versiones actuales a IA 10 días después de la última modificación. Transfiere las versiones no actuales a Archive 60 días después de convertirse en no actuales. Elimina las versiones no actuales 90 días después de convertirse en no actuales.

       <?xml version="1.0" encoding="UTF-8"?>
       <LifecycleConfiguration>
         <Rule>
           <ID>test-rule3</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>

     • Ejemplo 4

       Esta regla transfiere los objetos con el prefijo data/ a IA 200 días después del último acceso. Con <ReturnToStdWhenVisit> establecido en false, los objetos permanecen en IA incluso si se accede a ellos nuevamente.

       <?xml version="1.0" encoding="UTF-8"?>
       <LifecycleConfiguration>
         <Rule>
           <ID>test-rule4</ID>
           <Prefix>data/</Prefix>
           <Status>Enabled</Status>
           <Transition>
             <Days>200</Days>
             <StorageClass>IA</StorageClass>
             <IsAccessTime>true</IsAccessTime>
             <ReturnToStdWhenVisit>false</ReturnToStdWhenVisit>
           </Transition>    
         </Rule>  
       </LifecycleConfiguration>

1. Agregue la configuración de ciclo de vida a examplebucket:

   ossutil lifecycle --method put oss://examplebucket localfile.xml

   Salida en caso de éxito:

   0.299514(s) elapsed

Consultar reglas de ciclo de vida

• Sintaxis del comando

  ossutil lifecycle --method get oss://bucketname [local_xml_file]

  Parámetros:

  Parámetro	Descripción
  bucketname	El nombre del bucket de destino.
  local_xml_file	El archivo de salida para la configuración de ciclo de vida. Ejemplo: localfile.xml. Si se omite, las reglas se imprimen en stdout.

• Ejemplo

  Consulte las reglas de ciclo de vida de examplebucket:

  ossutil lifecycle --method get oss://examplebucket localfile.xml

  Salida en caso de éxito:

  0.212407(s) elapsed

Eliminar la configuración de ciclo de vida

• Sintaxis del comando

  ossutil lifecycle --method delete oss://bucketname

• Ejemplo

  Elimine las reglas de ciclo de vida de examplebucket:

  ossutil lifecycle --method delete oss://examplebucket

  Salida en caso de éxito:

  0.530750(s) elapsed

Opciones comunes

Para acceder a un bucket en una región diferente, use -e para especificar el endpoint. Para acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, use -i para el AccessKey ID y -k para el AccessKey secret.

Por ejemplo, cree reglas de ciclo de vida para examplebucket en la región China (Hangzhou), propiedad de otra cuenta de Alibaba Cloud:

ossutil lifecycle --method put oss://examplebucket localfile.xml -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.