Object Storage Service:worm (retention policy)

Observações de uso

• Permissões necessárias: oss:InitiateBucketWorm para crie, oss:CompleteBucketWorm para bloquear, oss:ExtendBucketWorm para estender, oss:GetBucketWorm para consultar e oss:AbortBucketWorm para exclua uma política de retenção. Anexar uma política personalizada a um usuário RAM.

• No ossutil 1.6.16 e versões posteriores, use ossutil como comando. Nas versões anteriores à 1.6.16, utilize o nome do binário correspondente ao seu sistema operacional. Para mais informações, consulte Referência de comandos do ossutil.

• O tópico Políticas de retenção aborda o ciclo de vida do WORM.

Crie e bloquear uma política de retenção

Crie uma política de retenção para um bucket e bloqueie-a.

1. Crie a política de retenção

   • Sintaxe do comando

     ossutil worm init oss://BucketName days

     Parâmetros:

     Parâmetro	Descrição
     BucketName	Nome do bucket de destino.
     days	Período de retenção em dias. Os objetos no bucket não podem ser modifique ou exclua durante esse intervalo. Unidade: dia Valores válidos: 1 a 25550

   • Exemplos

     Crie uma política de retenção para o bucket examplebucket com duração de 180 dias.

     ossutil worm init oss://examplebucket 180

     Saída de exemplo:

     init success,worm id is 581D8A7FFA064C80827CAB4076A93A78

2. Bloqueie a política de retenção

   • Sintaxe do comando

     ossutil worm complete oss://BucketName WormId

     Parâmetros:

     Parâmetro	Descrição
     BucketName	Nome do bucket de destino.
     WormId	ID retornado na criação da política de retenção.

   • Exemplos

     Bloqueie a política de retenção do bucket examplebucket.

     ossutil worm complete oss://examplebucket 581D8A7FFA064C80827CAB4076A93A78

     Saída de exemplo:

     0.073810(s) elapsed

Estender o período de retenção

Após o bloqueio da política de retenção, os objetos ficam protegidos contra modificação ou exclusão até o fim do período definido. Caso necessário, estenda essa duração.

• Sintaxe do comando

  ossutil worm extend oss://BucketName days WormId

• Exemplos

  Estenda o período de retenção do examplebucket para 360 dias.

  ossutil worm extend oss://examplebucket 360 581D8A7FFA064C80827CAB4076A93A78

  Saída de exemplo:

  0.067810(s) elapsed

Consultar uma política de retenção

Obtenha a configuração da política de retenção de um bucket.

• Sintaxe do comando

  ossutil worm get oss://BucketName

• Exemplos

  Consulte a política de retenção do bucket examplebucket.

  ossutil worm get oss://examplebucket

  Saída de exemplo:

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

Exclua uma política de retenção

Exclua a política de retenção antes do bloqueio.

• Sintaxe do comando

  ossutil worm abort oss://BucketName

• Exemplos

  Exclua a política de retenção do bucket examplebucket.

  ossutil worm abort oss://examplebucket

  Saída de exemplo:

  0.067810(s) elapsed

Opções comuns

Para acessar um bucket em outra região, use -e para especifique o endpoint. Para acessar um bucket de outra conta Alibaba Cloud, use -i para o AccessKey ID e -k para o AccessKey secret.

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

Opções comuns.