Configure WORM retention policies for OSS buckets with ossutil - Object Storage Service

Ejecute el comando worm para configurar una política de retención WORM (Write Once Read Many) en un bucket. Durante el periodo de retención, ningún usuario, incluido el propietario del recurso, puede modificar o eliminar objetos del bucket. En este lapso solo se permite cargar y leer objetos. La modificación o eliminación de objetos solo es posible una vez que vence el periodo de retención.

Notas de uso

Permisos obligatorios: oss:InitiateBucketWorm para crear, oss:CompleteBucketWorm para bloquear, oss:ExtendBucketWorm para extender, oss:GetBucketWorm para consultar y oss:AbortBucketWorm para eliminar una política de retención. Attach a custom policy to a RAM user.
En ossutil 1.6.16 y versiones posteriores, puede usar ossutil como comando. Para versiones anteriores a la 1.6.16, debe utilizar el nombre del binario correspondiente a su sistema operativo. Para obtener más información, consulte ossutil command reference.
El tema Retention policies aborda el ciclo de vida de WORM.

Crear y bloquear una política de retención

Cree una política de retención para un bucket y bloquéela.

Crear una política de retención

Sintaxis del comando

ossutil worm init oss://BucketName days

Parámetros:

Parámetro

Descripción

BucketName

Nombre del bucket de destino.

days

Periodo de retención en días. Los objetos del bucket no se pueden modificar ni eliminar durante este lapso.

Unidad: día
Valores válidos: de 1 a 25550

Ejemplos
Cree una política de retención para el bucket examplebucket con un periodo de retención de 180 días.
```
ossutil worm init oss://examplebucket 180
```
Salida de ejemplo:
```
init success,worm id is 581D8A7FFA064C80827CAB4076A93A78
```

Bloquear la política de retención
- Sintaxis del comando
```
ossutil worm complete oss://BucketName WormId
```
  Parámetros:
  
  Parámetro
  
  Descripción
  
  BucketName
  
  Nombre del bucket de destino.
  
  WormId
  
  ID devuelto al crear la política de retención.
- Ejemplos
  Bloquee la política de retención del bucket examplebucket.
```
ossutil worm complete oss://examplebucket 581D8A7FFA064C80827CAB4076A93A78
```
  Salida de ejemplo:
```
0.073810(s) elapsed
```

Extender el periodo de retención

Una vez bloqueada la política de retención, los objetos no se pueden modificar ni eliminar hasta que venza el periodo de retención. Si es necesario, puede extender dicho periodo.

Sintaxis del comando

ossutil worm extend oss://BucketName days WormId

Ejemplos

Extienda el periodo de retención de examplebucket a 360 días.

ossutil worm extend oss://examplebucket 360 581D8A7FFA064C80827CAB4076A93A78

Salida de ejemplo:

0.067810(s) elapsed

Consultar una política de retención

Obtenga la configuración de la política de retención de un bucket.

Sintaxis del comando
```
ossutil worm get oss://BucketName
```

Ejemplos

Consulte la política de retención del bucket examplebucket.

ossutil worm get oss://examplebucket

Salida de ejemplo:

<WormConfiguration>
      <WormId>581D8A7FFA064C80827CAB4076A93A78</WormId>
      <State>Locked</State>
      <RetentionPeriodInDays>360</RetentionPeriodInDays>
      <CreationDate>2021-01-19T03:36:53.000Z</CreationDate>
  </WormConfiguration>

Eliminar una política de retención

Elimine una política de retención antes de que se bloquee.

Sintaxis del comando
```
ossutil worm abort oss://BucketName
```
Ejemplos

Elimine la política de retención del bucket examplebucket.
```
ossutil worm abort oss://examplebucket
```
Salida de ejemplo:
```
0.067810(s) elapsed
```

Opciones comunes

Para acceder a un bucket en otra región, 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.

Ejemplo: Cree una política de retención para el bucket test en China (Hangzhou) bajo una cuenta distinta de Alibaba Cloud.

ossutil worm init oss://test -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.