GetBucketLifecycle

最終更新日:2025-08-18 15:50:12

本インターフェースは、バケットのライフサイクル設定を取得するために使用します。操作にはIAM権限 wos:GetBucketLifecycle が必要です。

リクエスト構文

GET /?lifecycle HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization string

URIリクエストパラメータ

なし

リクエストヘッダー

Common Request Headers をご利用ください。

リクエストボディ

なし

レスポンス構文

HTTP/1.1 200 OK
x-wos-request-id:
Date:
Server: WCS-Web-Server
Content-Length: 358
 
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns=" https://www.wangsu.com/document ">
<Rule>
<ID>id</ID>
<Filter>
<Prefix> </Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
  <Days>30</Days>
  <StorageClass>IA</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>

レスポンスヘッダー

Common Response Headers をご利用ください。

レスポンスボディ

フィールド名 説明
LifecycleConfiguration ライフサイクル設定リストの定義。
型: XML
子ノード: Rule
親ノード: なし
Rule 個別のライフサイクル設定の定義。
型: XML
親ノード: LifecycleConfiguration
子ノード: Filter
ID 各ルールに一意となるIDを設定。
型: String
親ノード: Rule
Filter ライフサイクルルールに該当するオブジェクトのサブセットを定義します。フィルタはプレフィックスによる絞り込みのみサポートされています。Filterが定義されていない()場合、このライフサイクルルールはバケット内すべてのオブジェクトに適用されます。
型: XML
子ノード: Prefix
親ノード: Rule
Prefix フィルタ条件となるルールを定義。このプレフィックスに一致するオブジェクトにのみ、ライフサイクル設定が有効となります。
型: String
親ノード: Filter
Status ライフサイクル設定のステータス(有効化されているかどうか)。Enabledで有効。
型: String(現在はEnabledのみサポート)
親ノード: Rule
Expiration 条件に一致したオブジェクトの有効期限を定義します。
型: XML
子ノード: Days/Date
親ノード: Rule
Days オブジェクトの有効期限を相対日数で指定。例: 13の場合、最終更新から13日後にオブジェクトが期限切れとなります。
型: 正の整数
親ノード: Expiration
Transition データ移行ルール。
型: XML
子ノード: Days/StorageClass
親ノード: Rule
Days(Transition配下) 移行までの日数。
型: 正の整数
親ノード: Transition
StorageClass 移行先のストレージ種別。サポート値: IA(低頻度アクセス)、Archive(アーカイブ保存)。
型: String
親ノード: Transition

GET /?lifecycle HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
x-wos-date: Thu, 15 Nov 2016 00:17:21 GMT
Authorization: signatureValue

HTTP/1.1 200 OK
x-wos-request-id: 51991C342C575321
Date: Thu, 15 Nov 2016 00:17:23 GMT
Server: WCS-Web-Serve
Content-Length: 358
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns=" https://www.wangsu.com/document ">
<Rule>
<ID>Archive and then delete rule</ID>
<Filter>
    <Prefix>projectdocs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
    <Days>365</Days>
</Expiration>
<Transition>
  <Days>30</Days>
  <StorageClass>IA</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>