PutBucketLifecycleConfiguration#

バケットにライフサイクル構成情報を設定します。

APIエンドポイント#

リージョン	APIエンドポイント
西日本リージョン3の場合	https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

PUT

/{bucket}?lifecycle

HTTPステータスコード#

正常時：200

エラー時：400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503

リクエストパラメータの説明#

名前	In	Type	デフォルト値 /必須指定	Description
Bucket	path	string	必須	バケット名
x-amz-content-sha256	header	string	必須	ペイロード全体の計算されたSHA256チェックサム
x-amz-date	header	string	必須	リクエスト側で生成した現在日時
Authorization	header	string	必須	リクエスト認証に用いる文字列
Content-Length	header	string	必須	リクエストボディのバイト数
LifecycleConfiguration	body	container	必須	ライフサイクル設定要素用のコンテナ
Rule	body	body	必須	ID、Prefix、Status、Expiration、Filter要素用のコンテナ
ID	body	string	必須	ルールの一意の識別子最大文字数は255文字です。
Prefix	body	string	任意	ルールが適用されるオブジェクトのプレフィックス本パラメータを記述しない場合Filterを必ず記述すること
Status	Expiration	string	任意	ルールの運用状態以下のどちらかが指定できます。 - Enabled - Disabled
Expiration	body	container	任意	オブジェクトのライフサイクルの有効期限日付、日形式で指定します。
Date	body	timestamp	任意	ルールが有効になる日時タイムスタンプ形式で指定します。例：2019-12-19T09:30:00Z 📒注: 同一ルール内でDaysと併用することはできません。
Days	body	integer	任意	ルールの対象となるオブジェクトの有効期間日数で指定します。 📒注: 同一ルール内でDateと併用することはできません。
Filter	body	container	任意	ライフサイクルルールが適用されるオブジェクトを識別する要素を格納するコンテナ本パラメータを記述しない場合Prefixを必ず記述すること
AND	body	container	任意	Filterで複数の条件を指定するときに必要となるコンテナ
Tag	body	container	任意	Key、Value要素用のコンテナ
Key	body	string	任意	オブジェクトに設定されているキー名
Value	body	string	任意	オブジェクトに設定されているキーに対する値
NoncurrentVersionExpiration	body	container	任意	NoncurrentDays要素用のコンテナ
NoncurrentDays	body	integer	任意	バージョニングが有効なバケットで最新版でなくなったオブジェクトバージョンの有効期限日数で指定します。

レスポンスヘッダーの説明#

名前	Type	Description
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: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20200128T020025Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20200128/jp-east-3/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-3.local-20578-6521026-1_200