put-bucket-lifecycle-configuration

Classic/VPC環境で利用できます。

Ncloud Storageバケットにライフサイクルの新規ルールを登録したり、既存のライフサイクルルールを上書きしたりします。

構文

put-bucket-lifecycle-configuration構文は次の通りです。

aws s3api put-bucket-lifecycle-configuration \
    --bucket <bucket> \
    --lifecycle-configuration <lifecycle-configuration> \
    --endpoint-url <endpoint-url>

オプション

put-bucket-lifecycle-configurationの実行時に指定できるオプションについて説明します。

必須オプション

put-bucket-lifecycle-configurationの必須オプションです。

--lifecycle-configuration構文

• 例1: バケットのバージョニングが有効になっていない場合
  • Transitionルールに従い、documents/接頭辞を持つオブジェクトを180日後にDEEP_ARCHIVEストレージクラスへ移行します。
  • Expirationルールに従い、logs/接頭辞を持つオブジェクトを作成から360日後に削除します。

{
  "Rules": [
    {
      "ID": "tran_documents",
      "Filter": {
        "Prefix": "documents/"
      },
      "Status": "Enabled",
      "Transitions": [
        {
          "Days": 180,
          "StorageClass": "DEEP_ARCHIVE"
        }
      ]
    },
    {
      "ID": "exp_logs",
      "Filter": {
        "Prefix": "logs/"
      },
      "Status": "Enabled",
      "Expiration": {
        "Days": 360
      }
    }
  ]
}

• 例2: バケットのバージョニングが有効になっている場合
  • NoncurrentVersionTransitionルールに従い、documents/接頭辞を持つオブジェクトのうち、最新5つの旧バージョンを除く残りのオブジェクトバージョンを、旧バージョンになってから180日経過後に自動でDEEP_ARCHIVEストレージクラスへ移行します。
  • NoncurrentVersionExpiration ルールに従い、logs/接頭辞を持つオブジェクトが非現行になってから100日経過後に削除します。

{
  "Rules": [
    {
      "ID": "tran_noncurrent_documents",
      "Filter": {
        "Prefix": "documents/"
      },
      "Status": "Enabled",
      "NoncurrentVersionTransitions": [
        {
          "NewerNoncurrentVersions": 5,
          "NoncurrentDays": 180,
          "StorageClass": "DEEP_ARCHIVE"
        }
      ]
    },
    {
      "ID": "exp_noncurrent_logs",
      "Filter": {
        "Prefix": "logs/"
      },
      "Status": "Enabled",
      "NoncurrentVersionExpiration": {
        "NoncurrentDays": 100
      }
    }
  ]
}

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

ライフサイクルルールの登録リクエストが成功すると、ルールが適用され、結果は出力されません。

コマンド

コマンドの例は次の通りです。

aws s3api put-bucket-lifecycle-configuration --bucket my-test-bucket \
    --lifecycle-configuration file://lifecycle.json \
    --endpoint-url=https://kr.ncloudstorage.com

関連コマンド

関連コマンドは次の通りです。

• delete-bucket-lifecycle
• get-bucket-lifecycle-configuration