すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetBucketVersioning

最終更新日:Feb 19, 2025

この操作を呼び出して、バケットのバージョン管理状態をクエリできます。

リクエスト構文

GET /? versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

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

レスポンスヘッダー

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

レスポンス要素

要素

タイプ

説明

VersioningConfiguration

コンテナー

N/A

バケットのバージョン管理状態を格納するコンテナー。

子ノード: Status

親ノード: なし

Status

文字列

Enabled

バケットのバージョン管理状態。

親ノード: VersioningConfiguration

有効な値:

  • Enabled: バケットのバージョン管理が有効になっていることを示します。

  • Suspended: バケットのバージョン管理が一時停止されていることを示します。

説明

バケットのバージョン管理が有効になっていない場合、Status 要素はレスポンス要素に含まれません。

リクエストの例

GET /?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****************

レスポンスの例

  • バージョン管理が有効になっているバケットのレスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 5CAC0342B7AEADE01700****
    Date: Tue, 09 Apr 2019 02:28:18 GMT 
    Content-Length: 121
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS
    <? xml version="1.0" encoding="UTF-8"? >
    <VersioningConfiguration>
        <Status>Enabled</Status>
    </VersioningConfiguration>
  • バージョン管理が無効になっているバケットのレスポンスの例

    リクエストされたバケットのバージョン管理が無効になっている場合、バケットのバージョン管理状態はレスポンスの XML 本文に含まれません。

    HTTP/1.1 200 OK
    x-oss-request-id: 5CAC015CB7AEADE01700****
    Date: Tue, 09 Apr 2019 02:20:12 GMT 
    Content-Length: 74
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS
    <VersioningConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com"/>

OSS SDK

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

ossutil

GetBucketVersioning 操作に対応する ossutil コマンドについては、「get-bucket-versioning」をご参照ください。

エラーコード

エラーコード

HTTP ステータスコード

説明

AccessDenied

403

バケットのバージョン管理状態を照会する権限がないために返されるエラーメッセージ。

バケットの所有者、または GetBucketVersioning 権限を持つ RAM ユーザーのみが、バケットのバージョン管理状態を照会できます。

NoSuchBucket

404

指定されたバケットが存在しないために返されるエラーメッセージ。