ニフクラAPI (オブジェクトストレージサービス: PutBucketLifecycleConfiguration)

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