Como criar uma política de retenção - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Para criar uma política de retenção, é preciso ter a permissão oss:InitiateBucketWorm. Para mais informações, consulte Attach a custom policy to a RAM user.
O Object Storage Service (OSS) oferece suporte ao recurso Write Once Read Many (WORM), que impede a exclusão ou modificação de dados. Defina uma política de retenção baseada em tempo para um bucket, com período de retenção de 1 dia a 70 anos.
Se uma política de retenção baseada em tempo não for bloqueada em até 24 horas após a criação, ela se tornará inválida automaticamente. Após o bloqueio da política de retenção, envie objetos e leia-os no bucket. No entanto, o sistema não permite que você exclua os objetos nem a política de retenção até que o período de retenção expire. Para mais informações sobre políticas de retenção, consulte Retention policies.

Sintaxe do comando

ossutil api initiate-bucket-worm --bucket value --initiate-worm-configuration value [flags]

Parâmetro	Tipo	Descrição
--bucket	string	O nome do bucket.
--initiate-worm-configuration	string	O corpo da requisição.

Nota

O comando initiate-bucket-worm corresponde à operação da API InitiateBucketWorm. Para mais informações sobre os parâmetros da operação da API, consulte InitiateBucketWorm.

--initiate-worm-configuration

A opção --initiate-worm-configuration oferece suporte às sintaxes XML e JSON:

Sintaxe XML:

<InitiateWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</InitiateWormConfiguration>

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

Nota

Para mais informações, consulte Command-line options.

Exemplos

Para o bucket examplebucket, crie uma política de retenção.

Use um arquivo de configuração XML. O código a seguir mostra o conteúdo de initiate-worm-configuration.xml:

<?xml version="1.0" encoding="UTF-8"?>
<InitiateWormConfiguration>
  <RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>

Comando de exemplo:

ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.xml

Utilize um arquivo de configuração JSON. O código a seguir exibe o conteúdo de initiate-worm-configuration.json:

{
        "RetentionPeriodInDays": "365"
}

Exemplo de comando:

ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.json

Empregue parâmetros de configuração JSON. O exemplo a seguir mostra um comando:

ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration "{\"RetentionPeriodInDays\":\"365\"}"