Object Storage Service:PutBucketVersioning

Observações de uso

• A permissão PutBucketVersioning é obrigatória.

• Um bucket possui três estados de versionamento: desativado (padrão), ativado ou suspenso.

• Quando ativado, o OSS atribui IDs de versão exclusivos a todos os objetos adicionados ao bucket e retém múltiplas versões.

• Quando suspenso, o OSS define o ID de versão como null para novos objetos e não retém versões de objetos excluídos ou sobrescritos.

Para obter mais informações sobre versionamento, consulte Versionamento.

Sintaxe da solicitação

PUT /?versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Enabled</Status>
</VersioningConfiguration>

Cabeçalhos da solicitação

O PutBucketVersioning utiliza apenas cabeçalhos comuns de solicitação. Para mais detalhes, consulte Cabeçalhos comuns de solicitação.

Parâmetros da solicitação

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de resposta.

Exemplos

• Exemplo de solicitação: ativar versionamento

  PUT /?versioning HTTP/1.1
  Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 02:20:12 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <?xml version="1.0" encoding="UTF-8"?>
  <VersioningConfiguration>
      <Status>Enabled</Status>
  </VersioningConfiguration>

  Exemplo de resposta

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC015CB7AEADE01700****
  Date: Tue, 09 Apr 2019 02:20:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• Exemplo de solicitação: suspender versionamento

  PUT /?versioning HTTP/1.1
  Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 02:28:18 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <?xml version="1.0" encoding="UTF-8"?>
  <VersioningConfiguration>
      <Status>Suspended</Status>
  </VersioningConfiguration>

  Exemplo de resposta

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC0342B7AEADE01700****
  Date: Tue, 09 Apr 2019 02:28:18 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

SDKs do OSS

Use os seguintes SDKs do OSS para chamar a operação PutBucketVersioning:

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação PutBucketVersioning, consulte put-bucket-versioning.

Códigos de erro