Object Storage Service:PutBucketVersioning

使用上の注意

• バケットのバージョン管理状態を設定するには、PutBucketVersioning 権限が必要です。

• バケットは、無効、有効、一時停止のいずれかのバージョン管理状態になります。 デフォルトでは、バケットのバージョン管理は無効になっています。

• バケットのバージョン管理が有効になっている場合、OSS はバケットに追加されるすべてのオブジェクトに一意のバージョン ID を生成します。 この場合、OSS はオブジェクトの複数のバージョンを保存します。

• バケットのバージョン管理が一時停止されている場合、OSS はバケットに追加されるすべてのオブジェクトにバージョン ID null を生成します。 この場合、OSS は、削除または上書きされたオブジェクトの新しいバージョンを保存しません。

バージョン管理の詳細については、「バージョン管理」をご参照ください。

リクエスト構文

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>

リクエストヘッダー

DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

レスポンスヘッダー

DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

例

• バケットのバージョン管理を有効にするサンプルリクエスト

  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>

  サンプルレスポンス

  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

• バケットのバージョン管理を一時停止するサンプルリクエスト

  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>

  サンプルレスポンス

  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

OSS SDK

次のプログラミング言語の OSS SDK を使用して、PutBucketVersioning 操作を呼び出すことができます。

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil

ossutil コマンドの詳細については、「put-bucket-versioning」をご参照ください。

エラーコード