How do I extend the retention period of objects in a bucket? - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

Para estender o período de retenção de objetos em um bucket, você precisa da permissão oss:ExtendBucketWorm. Para mais informações, consulte Conceder uma política personalizada.
Por padrão, uma política baseada em tempo fica no estado InProgress após a criação para um bucket. A política permanece nesse estado por 24 horas. Durante esse período, a política de retenção protege os dados no bucket.
- Na janela de 24 horas após a ativação da política de retenção: se a política não estiver bloqueada, o proprietário do bucket e os usuários autorizados podem excluí-la. Se estiver bloqueada, a exclusão não é permitida e apenas é possível estender o período de retenção especificado.
- Após 24 horas da ativação da política de retenção: se a política não estiver bloqueada, ela se torna inválida.
Se um bucket contiver objetos dentro do período de proteção, não será possível excluir o bucket nem sua política de retenção. A exclusão do bucket também remove sua política de retenção associada. Somente o proprietário pode excluir um bucket quando ele estiver vazio.

Sintaxe do comando

 ossutil api extend-bucket-worm --bucket value --worm-id value --extend-worm-configuration value [flags]

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket.
--extend-worm-configuration	string	Contêiner que armazena as configurações da política de retenção.
--worm-id	string	ID da política de retenção.

--extend-worm-configuration

A opção --extend-worm-configuration aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo "file://", o ossutil lê as configurações do arquivo especificado.

Formato XML:

<ExtendWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</ExtendWormConfiguration>

Formato JSON:
```
{
  "RetentionPeriodInDays": integer
}
```

Nota

Para mais informações, consulte Opções de linha de comando.

Exemplos

Estenda o período de retenção dos objetos protegidos pela política de retenção "123" para 366 dias.

Use um arquivo de configuração XML (extend-worm-configuration.xml neste exemplo)

<?xml version="1.0" encoding="UTF-8"?>
<ExtendWormConfiguration>
  <RetentionPeriodInDays>366</RetentionPeriodInDays>
</ExtendWormConfiguration>

Comando de exemplo:

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.xml

Use um arquivo de configuração JSON (extend-worm-configuration.json neste exemplo)

{
        "RetentionPeriodInDays": "366"
}

Comando de exemplo:

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.json

Use parâmetros JSON diretamente na linha de comando

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration " "{\"RetentionPeriodInDays\":\"366\"}""