获取桶的生命周期

该接口用于设置存储桶（Bucket）的生命周期规则，只有存储桶的拥有者才能发起此请求。

请求

  • 请求语法

    • 内容

        GET /?lifecycle HTTP/1.1
  Host: {BucketName}.{Endpoint}
  Date: {date}
  Authorization: {SignatureValue}

    • 描述

        Endpoint：参考与region地域的关系
  SignatureValue：参考签名算法

  • 请求参数

    无

  • 非公共请求头

    无

  • 请求体

    无

响应

  • 非公共响应头

    无

  • 响应体

名称 类型 描述
AbortIncompleteMultipartUpload 容器 用于指定不完整的分段上传何时可以中止操作。指定此参数时，无法指定tag。
子节点: DaysAfterInitiation
父节点: Rule
And 容器 存放多个规则的容器。
父节点:Rule
Date 字符串 指定对该日期之前的对象执行生命周期规则。
父节点: Expiration 或Transition
Days 字符串 指定生命周期规则在Object最后修改过后多少天生效。
父节点: Expiration, Transition.
DaysAfterInitiation 正整数 指定启动分段上传后必须完成分段上传的时间。
父节点:AbortIncompleteMultipartUpload.
Expiration 容器 表示过期时间的属性。
子节点: Days 或 Date
父节点：Rule
Filter 容器 存放过滤参数的容器。
子节点: Prefix, Tag
父节点：Rule
ID 字符串 规则唯一的ID，最多由255个字节组成。
父节点: Rule
Key 字符串 Tag Key
父节点: Tag
LifecycleConfiguration 容器 Lifecycle配置的容器，最多可容纳1000条规则。
子节点：Rule
父节点：无
ExpiredObjectDeleteMarker 字符串 指定是否自动移除过期删除标记。true为是，false为否。
父节点：Expiration
NoncurrentDays 容器 指定生命周期规则在Object成为非当前版本多少天后生效。
父节点：NoncurrentVersionTransition、NoncurrentVersionExpiration
NoncurrentVersionExpiration 容器 指定Object非当前版本的生命周期规则的过期属性。
子节点：NoncurrentDays
NoncurrentVersionTransition 容器 在有效生命周期中，OSS何时将指定Object的非当前版本转储为其他类型。
子节点：NoncurrentDays、StorageClass
父节点: Rule
Prefix 字符串 指定规则所适用的前缀。只有匹配前缀的Object才可能被该规则所影响。
父节点: Filter 或者 And
Rule 容器 表述生命周期规则。
父节点: LifecycleConfiguration
Status 字符串 如果值为Enabled，那么OSS会定期执行该规则；如果为Disabled，那么OSS会忽略该规则。有效值：Enabled，Disabled
父节点: Rule
StorageClass 字符串 指定Object转存的存储类型。
父节点: Transition and NoncurrentVersionTransition
Tag 容器 指定规则所适用的对象标签，可以设置多个。
子节点：Key， Value
父节点:Filter 或者 And
Transition 容器 生命周期配置中表示迁移时间和迁移后对象存储级别的元素。
子节点：Date或Days,StorageClass
父节点: Rule
Value 字符串 Tag Value
父节点：Tag

示例

  • 请求

          GET /?lifecycle HTTP/1.1
      Host: oss-example.oss-cn-beijing.inspurcloud.com
      x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
      Authorization: signatureValue

  • 响应

          HTTP/1.1 200 OK
      x-oss-id-2: HWEKT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SHEMN
      x-oss-request-id: 22291C342C575859
      Date: Thu, 15 Nov 2012 00:17:21 GMT
      Content-Length: 524

      <?xml version="1.0" encoding="UTF-8"?>
      <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
          <Rule>
              <ID>Archive and then delete rule</ID>
              <Filter>
                  <Prefix>projectdocs/</Prefix>
              </Filter>
              <Status>Enabled</Status>
              <Transition>
                  <Days>30</Days>
                  <StorageClass>STANDARD_IA</StorageClass>
              </Transition>
              <Transition>
                  <Days>365</Days>
                  <StorageClass>GLACIER</StorageClass>
              </Transition>
              <Expiration>
                  <Days>3650</Days>
              </Expiration>
          </Rule>
      </LifecycleConfiguration>

错误码

错误码 描述 状态码 描述
NoSuchLifecycleConfiguration 生命周期配置不存在 404 Not Found ...