Object Storage Service:PutBucketVersioning

Notas de uso

• Debe contar con el permiso PutBucketVersioning.

• Un bucket puede tener uno de tres estados de versionado: deshabilitado (predeterminado), habilitado o suspendido.

• Cuando está habilitado, OSS asigna identificadores de versión únicos a todos los objetos agregados al bucket y conserva varias versiones.

• Cuando está suspendido, OSS asigna el identificador de versión null a los objetos nuevos y no conserva versiones de los objetos eliminados o sobrescritos.

Para obtener más información sobre el versionado, consulte Versioning.

Sintaxis de la solicitud

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>

Encabezados de la solicitud

DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Parámetros de la solicitud

Encabezados de la respuesta

La respuesta contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Ejemplos

• Solicitud de ejemplo: habilite el versionado

  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>

  Respuesta de ejemplo

  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

• Solicitud de ejemplo: suspender el versionado

  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>

  Respuesta de ejemplo

  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

SDK de OSS

Llame a PutBucketVersioning con los siguientes SDK de OSS:

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación PutBucketVersioning, consulte put-bucket-versioning.

Códigos de error