PutBucketLifecycle
最終更新日：2025-08-18 15:50:10
PutBucketLifecycleは、バケット（スペース）にライフサイクルを作成する、または既存のライフサイクルルールを置き換えるために使用します。操作にはIAM権限 wos:PutBucketLifecycle が必要です。
リクエスト構文
PUT /?lifecycle HTTP/1.1
Host: Bucket.Endpoint
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="https://www.wangsu.com/document ">
<Rule>
<Expiration>
<Days>integer</Days>
</Expiration>
<Filter>
<Prefix>string</Prefix>
</Filter>
<ID>string</ID>
<Transition>
<Date>timestamp</Date>
<StorageClass>string</StorageClass>
</Transition>
</Rule>
...
</LifecycleConfiguration>
URIリクエストパラメータ
なし
リクエストヘッダー
Common Request Headers のみご利用ください。
リクエストボディ
リクエストボディには以下のXML情報を送信します。
要素名 | 要素説明 |
LifecycleConfiguration | ライフサイクル設定リストの定義。 型: XML 子ノード: Rule 親ノード: なし |
Rule | 個々のライフサイクル詳細設定の定義。 型: XML 親ノード: LifecycleConfiguration 子ノード: Filter |
ID | 各ルールを一意に識別するID。 型: String 親ノード: Rule |
Filter | ライフサイクルルールに合致するオブジェクトのサブセットを指定します。現在、オブジェクト名のプレフィックスのみサポートされています。未指定（<Filter></Filter>）の場合、全オブジェクトにルールが適用されます。 型: XML 子ノード: Prefix 親ノード: Rule |
Prefix | フィルタ条件となるオブジェクト名のプレフィックス。対象プレフィックスに一致するオブジェクトにのみライフサイクル設定が有効となります。 型: String 親ノード: Filter |
Expiration | Filterに合致するオブジェクトの有効期限ルールを定義します。 型: XML 子ノード: Days|Date 親ノード: Rule |
Days | オブジェクトの有効期限を相対日数で定義します。例として値が3の場合、そのオブジェクトは最終更新から3日後に削除されます。 型: 正の整数 親ノード: Expiration |
Transition | データ移行ルールを定義します。 型: XML 子ノード: Days|StorageClass 親ノード: Rule |
Days | 移行までの日数 型: 正の整数 親ノード: Transition |
StorageClass | 移行先ストレージタイプ。IA：低頻度、Archive：アーカイブ。 型: String 親ノード: Transition |
レスポンス構文
HTTP/1.1 200 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server
レスポンスヘッダー
Common Request Headers のみご利用ください。
レスポンス要素
なし
例
30日で低頻度（IA）へ、60日でアーカイブ（Archive）へ、365日で削除されるルールを作成
PUT /?lifecycle HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
x-amz-date: Sun, 14 May 2017 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 105
<LifecycleConfiguration>
<Rule>
<ID>id1</ID>
<Filter>
<Prefix>logs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
<Days>30</Days>
<StorageClass>IA</StorageClass>
</Transition>
<Transition>
<Days>60</Days>
<StorageClass>Archive</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>
HTTP/1.1 200 OK
x-wos-request-id: 9E26D08072A8EF9E
Date: Sun, 14 May 2017 02:11:22 GMT
Content-Length: 0
Server: WCS-Web-Server