本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/object-storage-service/api/PutBucketLifecycleConfiguration.htmへ移行しました。 今後は新ページをご参照ください。

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

ルールの一意の識別子
最大文字数は255文字です。


Prefix string

ルールが適用されるオブジェクトのプレフィックス
本パラメータを記述しない場合Filterを必ず記述すること


Status string

ルールの運用状態
以下のどちらかが指定できます。
- Enabled
- Disabled


値:
  • Enabled
  • Disabled
Expiration structure

オブジェクトのライフサイクルの有効期限
日付、日形式で指定します。


Date timestamp

ルールが有効になる日時
タイムスタンプ形式で指定します。
例:2019-12-19T09:30:00Z
注意事項: 同一ルール内でDaysと併用することはできません。


Days integer

ルールの対象となるオブジェクトの有効期間
日数で指定します。
注意事項: 同一ルール内でDateと併用することはできません。


Filter structure

ライフサイクルルールが適用されるオブジェクトを識別する要素を格納するコンテナ
本パラメータを記述しない場合Prefixを必ず記述すること


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

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上