バケットの ObjectWorm 構成を取得する - Object Storage Service

GetBucketObjectWormConfiguration を呼び出して、バケットの ObjectWorm 構成 (有効化ステータスとデフォルトの保持ポリシーを含む) を取得します。

注意事項

この操作を呼び出すには、oss:GetBucketObjectWormConfiguration 権限が必要です。
バケットで ObjectWorm が有効になっていない場合、呼び出しは 404 エラーを返します。

リクエスト構文

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

レスポンス要素

パラメーター	タイプ	値	説明
ObjectWormConfiguration	コンテナ	N/A	バケットの ObjectWorm 構成のコンテナです。子ノード：`ObjectWormEnabled`、`Rule`
ObjectWormEnabled	文字列	Enabled	ObjectWorm が有効かどうかを示します。親ノード：`ObjectWormConfiguration`
Rule	コンテナ	N/A	デフォルトの保持ポリシーのコンテナです。この要素は、デフォルトの保持ポリシーが構成されていない場合は返されません。親ノード：`ObjectWormConfiguration` 子ノード：`DefaultRetention`
DefaultRetention	コンテナ	N/A	デフォルトの保持ポリシーの詳細のコンテナです。親ノード：`Rule` 子ノード：`Mode`、`Days`、または `Years`
Mode	文字列	COMPLIANCE	デフォルトの保持モードです。値 `COMPLIANCE` はコンプライアンスモードを示します。親ノード：`DefaultRetention`
Days	正の整数	1	デフォルトの保持期間 (日単位) です。この要素と `Years` 要素は相互排他的です。親ノード：`DefaultRetention`
Years	正の整数	1	デフォルトの保持期間 (年単位) です。この要素と `Days` 要素は相互排他的です。親ノード：`DefaultRetention`

例

リクエスト例

GET /?objectWorm HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,Signature=****

レスポンス例

HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<ObjectWormConfiguration>
  <ObjectWormEnabled>Enabled</ObjectWormEnabled>
  <Rule>
    <DefaultRetention>
      <Mode>COMPLIANCE</Mode>
      <Days>1</Days>
    </DefaultRetention>
  </Rule>
</ObjectWormConfiguration>