put-bucket-lifecycle - Object Storage Service

您可以基於最後一次修改時間以及最後一次訪問時間的策略建立生命週期規則，定期將儲存空間（Bucket）內的多個檔案（Object）轉儲為指定儲存類型，或者將到期的Object和片段刪除，從而節省儲存費用。本文為您介紹如何使用put-bucket-lifecycle命令為儲存空間（Bucket）設定生命週期規則。

注意事項

要為儲存空間設定生命週期規則，您必須有oss:PutBucketLifecycle許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。
如果Bucket此前沒有設定過生命週期規則，此操作會建立一個新的生命週期規則；如果Bucket此前設定過生命週期規則，此操作會覆寫先前的規則配置。
支援對Object以及Part（以分區方式上傳，但最後未提交的分區）設定到期時間。

命令格式

ossutil api put-bucket-lifecycle --bucket value --lifecycle-configuration value [flags]

參數	類型	說明
--bucket	string	Bucket名稱。
--lifecycle-configuration	string	Lifecycle配置的容器，最多可容納1000條規則。

說明

put-bucket-lifecycle命令對應API介面PutBucketLifecycle。關於API中的具體參數含義，請參見PutBucketLifecycle。

--lifecycle-configuration

--lifecycle-configuration配置選項既支援XML文法也支援JSON文法：

XML文法：

<LifecycleConfiguration>
  <Rule>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>integer</NoncurrentDays>
    </NoncurrentVersionExpiration>
    <NoncurrentVersionTransition>
      <NoncurrentDays>integer</NoncurrentDays>
      <StorageClass>string</StorageClass>
      <IsAccessTime>boolean</IsAccessTime>
      <ReturnToStdWhenVisit>boolean</ReturnToStdWhenVisit>
      <AllowSmallFile>boolean</AllowSmallFile>
    </NoncurrentVersionTransition>
    ...
    <ID>string</ID>
    <Prefix>string</Prefix>
    <Status>string</Status>
    <Expiration>
      <ExpiredObjectDeleteMarker>boolean</ExpiredObjectDeleteMarker>
      <CreatedBeforeDate>string</CreatedBeforeDate>
      <Days>integer</Days>
    </Expiration>
    <Transition>
      <IsAccessTime>boolean</IsAccessTime>
      <ReturnToStdWhenVisit>boolean</ReturnToStdWhenVisit>
      <AllowSmallFile>boolean</AllowSmallFile>
      <CreatedBeforeDate>string</CreatedBeforeDate>
      <Days>integer</Days>
      <StorageClass>string</StorageClass>
    </Transition>
    ...
    <AbortMultipartUpload>
      <CreatedBeforeDate>string</CreatedBeforeDate>
      <Days>integer</Days>
    </AbortMultipartUpload>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    ...
    <Filter>
      <Not>
        <Prefix>string</Prefix>
        <Tag>
          <Key>string</Key>
          <Value>string</Value>
        </Tag>
      </Not>
    </Filter>
  </Rule>
  ...
</LifecycleConfiguration>

JSON文法：

{
  "Rule": [
    {
      "Tag": [
        {
          "Key": "string",
          "Value": "string"
        },
        ...
      ],
      "Filter": {
        "Not": {
          "Prefix": "string",
          "Tag": {
            "Key": "string",
            "Value": "string"
          }
        }
      },
      "Transition": [
        {
          "CreatedBeforeDate": "string",
          "Days": integer,
          "StorageClass": "string",
          "IsAccessTime": boolean,
          "ReturnToStdWhenVisit": boolean,
          "AllowSmallFile": boolean
        },
        ...
      ],
      "AbortMultipartUpload": {
        "CreatedBeforeDate": "string",
        "Days": integer
      },
      "NoncurrentVersionExpiration": {
        "NoncurrentDays": integer
      },
      "NoncurrentVersionTransition": [
        {
          "NoncurrentDays": integer,
          "StorageClass": "string",
          "IsAccessTime": boolean,
          "ReturnToStdWhenVisit": boolean,
          "AllowSmallFile": boolean
        },
        ...
      ],
      "ID": "string",
      "Prefix": "string",
      "Status": "string",
      "Expiration": {
        "CreatedBeforeDate": "string",
        "Days": integer,
        "ExpiredObjectDeleteMarker": boolean
      }
    },
    ...
  ]
}

說明

關於支援的全域命令列選項，請參見支援的全域命令列選項。

使用樣本

為儲存空間examplebucket設定生命週期規則。

使用XML設定檔，lifecycle-configuration.xml內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
        <Rule>
                <ID>rule1</ID>
                        <Prefix>tmp/</Prefix>
                        <Status>Enabled</Status>
                        <Expiration>
                                <Days>10</Days>
                        </Expiration>
                        <Transition>
                                <Days>5</Days>
                                <StorageClass>IA</StorageClass>
                        </Transition>
                        <AbortMultipartUpload>
                        <Days>10</Days>
                </AbortMultipartUpload>
        </Rule>
</LifecycleConfiguration>

命令樣本如下：

ossutil api put-bucket-lifecycle --bucket examplebucket --lifecycle-configuration file://lifecycle-configuration.xml

使用JSON設定檔，lifecycle-configuration.json內容如下：

{
        "Rule": {
                "ID": "rule1",
                "Prefix": "tmp/",
                "Status": "Enabled",
                "Expiration": {
                        "Days": "10"
                },
                "Transition": {
                        "Days": "5",
                        "StorageClass": "IA"
                },
                "AbortMultipartUpload": {
                        "Days": "10"
                }
        }
}

命令樣本如下：

ossutil api put-bucket-lifecycle --bucket examplebucket --lifecycle-configuration file://lifecycle-configuration.json

使用JSON配置參數，命令樣本如下：

ossutil api put-bucket-lifecycle --bucket examplebucket --lifecycle-configuration "{\"Rule\":{\"ID\":\"rule1\",\"Prefix\":\"tmp/\",\"Status\":\"Enabled\",\"Expiration\":{\"Days\":\"10\"},\"Transition\":{\"Days\":\"5\",\"StorageClass\":\"IA\"},\"AbortMultipartUpload\":{\"Days\":\"10\"}}}"