put-bucket-lifecycle-configuration

Available in Classic and VPC

Register a new lifecycle rule on an Ncloud Storage bucket or overwrite an existing lifecycle rule.

Syntax

The put-bucket-lifecycle-configuration syntax is as follows:

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

Options

This section describes the options available when running put-bucket-lifecycle-configuration.

Required options

The following options are required for put-bucket-lifecycle-configuration.

--lifecycle-configuration syntax

• Example 1: When bucket versioning is disabled
  • According to the Transition rule, objects with the documents/ prefix are transitioned to the DEEP_ARCHIVE storage class after 180 days.
  • According to the Expiration rule, objects with the logs/ prefix are deleted 360 days after creation.

{
  "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
      }
    }
  ]
}

• Examples 2: When bucket versioning is enabled
  • According to the NoncurrentVersionTransition rule, all object versions—except for the five most recent previous versions with the documents/ prefix—are automatically transitioned to the DEEP_ARCHIVE storage class 180 days after they become non-current.
  • According to the NoncurrentVersionExpiration rule, objects with the logs/ prefix are deleted 100 days after they become non-current.

{
  "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
      }
    }
  ]
}

Common options

For information about the options common to all aws subcommands, see Ncloud Storage options.

Examples

If the request to register a lifecycle rule is successful, the rule is applied, and no result is displayed.

Command

The command example is as follows:

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

Related commands

Related commands are as follows:

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