获取Bucket的生命周期管理规则
所有文档

          对象存储 BOS

          获取Bucket的生命周期管理规则

          接口说明

          此接口用于获取定义的生命周期管理规则详细信息。

          注意事项

          • 如果请求的源Bucket不存在,返回404错误,错误码为NoSuchBucket。
          • 如果请求的源Bucket没有配置lifecycle,返回404错误,错误码为NoLifecycleConfiguration。

          请求URI

          GET /v1/{bucketName}/?lifecycle

          参数名称 参数类型 是否必须 描述 示例值 参数位置
          bucketName String bucket的名称 "bucketName_example" Path

          请求体参数

          请求体字段数据结构说明

          响应体参数

          响应体字段数据结构说明

          参数名称 参数类型 描述 示例值
          rule List<Rule> 所有规则的列表

          Rule字段数据结构说明

          参数名称 参数类型 描述 示例值
          id String 规则的标识符 sample-rule-abort-multiupload-prefix
          status String 规则的状态。 enabled
          resource List<String> 规则对哪些资源生效。
          condition Condition 规则依赖的条件。
          action Action 对resource执行的操作动作。

          Condition字段数据结构说明

          参数名称 参数类型 描述 示例值
          time Time 时间限制条件。

          Time字段数据结构说明

          参数名称 参数类型 描述 示例值
          dateGreaterThan String 描述时间关系。 $(lastModified)+P7D

          Action字段数据结构说明

          参数名称 参数类型 描述 示例值
          name String AbortMultipartUpload
          storageClass String STANDARD_IA

          请求示例

          GET /v1/bucketName_example/?lifecycle
          <公共请求头>
          
          
          { }

          响应示例

          HTTP/1.1 200 OK
          <公共响应头>
          
          {
            "rule" : [ {
              "condition" : {
                "time" : {
                  "dateGreaterThan" : "$(lastModified)+P7D"
                }
              },
              "resource" : [ "bucket/prefix/*", "bucket/prefix/*" ],
              "action" : {
                "storageClass" : "STANDARD_IA",
                "name" : "AbortMultipartUpload"
              },
              "id" : "sample-rule-abort-multiupload-prefix",
              "status" : "enabled"
            }, {
              "condition" : {
                "time" : {
                  "dateGreaterThan" : "$(lastModified)+P7D"
                }
              },
              "resource" : [ "bucket/prefix/*", "bucket/prefix/*" ],
              "action" : {
                "storageClass" : "STANDARD_IA",
                "name" : "AbortMultipartUpload"
              },
              "id" : "sample-rule-abort-multiupload-prefix",
              "status" : "enabled"
            } ]
          }

          错误码

          请参考通用错误码

          上一篇
          设置Bucket的生命周期
          下一篇
          删除Bucket的生命周期管理规则