PutBucketLifecycleConfiguration
処理概要
バケットにライフサイクル構成情報を設定します。
リクエストURL
PUT /{Bucket}?lifecycle指定するパラメーター
ヘッダーパラメーター
パラメーター | 型 | 説明 | 必須 |
---|---|---|---|
x-amz-content-sha256 | string |
ペイロード全体の計算されたSHA256チェックサム |
○ |
x-amz-date | string |
リクエスト側で生成した現在日時 |
○ |
Authorization | string |
リクエスト認証に用いる文字列 |
○ |
Content-Length | string |
リクエストボディのバイト数 |
○ |
パスパラメーター
パラメーター | 型 | 説明 | 必須 |
---|---|---|---|
Bucket | string |
バケット名 |
○ |
リクエストボディ
パラメーター | 型 | 説明 | 必須 |
---|---|---|---|
LifecycleConfiguration | structure |
ライフサイクル設定要素用のコンテナ |
○ |
␣Rule | list |
ID、Prefix、Status、Expiration、Filter要素用のコンテナ |
○ |
␣␣ID | string |
ルールの一意の識別子 |
○ |
␣␣Prefix | string |
ルールが適用されるオブジェクトのプレフィックス |
|
␣␣Status | string |
ルールの運用状態 値:
|
|
␣␣Expiration | structure |
オブジェクトのライフサイクルの有効期限 |
|
␣␣␣Date | timestamp |
ルールが有効になる日時 |
|
␣␣␣Days | integer |
ルールの対象となるオブジェクトの有効期間 |
|
␣␣Filter | structure |
ライフサイクルルールが適用されるオブジェクトを識別する要素を格納するコンテナ |
|
␣␣␣And | structure |
Filterで複数の条件を指定するときに必要となるコンテナ |
|
␣␣␣␣Tag | structure |
Key、Value要素用のコンテナ |
|
␣␣␣␣␣Key | string |
オブジェクトに設定されているキー名 |
|
␣␣␣␣␣Value | string |
オブジェクトに設定されているキーに対する値 |
|
␣␣NoncurrentVersionExpiration | structure |
NoncurrentDays要素用のコンテナ |
|
␣␣␣NoncurrentDays | integer |
バージョニングが有効なバケットで最新版でなくなったオブジェクトバージョンの有効期限 |
応答フィールド
レスポンスヘッダー
フィールド (項目) | 型 | 説明 |
---|---|---|
Date | string |
トランザクションが実行された日時 |
Content-Length | string |
レスポンスボディのバイト数 |
Connection | string |
持続接続の状態 |
x-amz-request-id | string |
このリクエストに付与されるID |
x-amz-id-2 | string |
このリクエストに対する処理ID |
x-ntap-sg-trace-id | string |
このリクエストに対する処理ID |
X-Fcx-Endpoint-Request | string |
APIエンドポイントとしてリクエストを受け付けたことを示す番号 |
リクエストサンプル
PUT /general-bucket?lifecycle HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20200128T020025Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20200128/jp-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=c58a782f909ad2346c39c37decd3a418f569970386eca4fac975b715841e04f9
Content-Length: 170
Content-Type: application/x-www-form-urlencoded
<LifecycleConfiguration>
<Rule>
<ID>rule#1</ID>
<Filter>
<Tag>
<Key>key1</Key>
<Value>tag1</Value>
</Tag>
</Filter>
<Expiration>
<Days>100</Days>
</Expiration>
<Status>Enabled</Status>
</Rule>
<Rule>
<ID>rule#2</ID>
<Filter>
<And>
<Prefix>test/dir3</Prefix>
<Tag>
<Key>key2</Key>
<Value>tag2</Value>
</Tag>
</And>
</Filter>
<Expiration>
<Date>2020-05-22T09:00:00Z</Date>
</Expiration>
<Status>Disabled</Status>
</Rule>
</LifecycleConfiguration>
応答サンプル
HTTP/1.1 200 OK
Date: Tue, 28 Jan 2020 02:00:35 GMT
Content-Length: 0
Connection: keep-alive
x-amz-request-id: 1580176825903684
x-amz-id-2: 12000889
x-ntap-sg-trace-id: ca6b37be3e3dd009
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-1.local-20578-6521026-1_200