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

Notas de uso

Para crie uma política de retenção, você precisa da permissão oss:InitiateBucketWorm. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.
O Object Storage Service (OSS) oferece suporte ao recurso WORM (Write Once Read Many), que impede a exclusão ou modificação de dados. Defina uma política de retenção baseada em tempo para um bucket. O período de retenção pode variar de 1 dia a 70 anos.
Se a política de retenção baseada em tempo não for bloqueada dentro de 24 horas após a criação, ela se tornará inválida automaticamente. Após o bloqueio da política, você pode fazer upload e ler objetos no bucket. No entanto, não é possível exclua os objetos ou a política de retenção até que o período expire. Para obter mais detalhes sobre políticas de retenção, consulte Políticas de retenção.

Sintaxe do comando

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

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket.
--initiate-worm-configuration	string	Corpo da solicitação.

Nota

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

--initiate-worm-configuration

A opção --initiate-worm-configuration aceita as sintaxes XML e JSON:

Sintaxe XML:

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

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

Nota

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

Exemplos

Crie uma política de retenção para o bucket examplebucket.

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

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

{
        "RetentionPeriodInDays": "365"
}

Comando de exemplo:

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

Use parâmetros de configuração JSON diretamente. Exemplo de comando:

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