全部产品
Search

搜索本产品

    边缘节点服务ENS：PutBucketLifecycle - 设置Object生命周期规则

    文档中心

    边缘节点服务ENS：PutBucketLifecycle - 设置Object生命周期规则

    更新时间：Mar 02, 2026

    调用PutBucketLifecycle设置文件生命周期规则。

    接口说明

    • 最多⽀持 1000 条规则。

    • 如果同一文件同时满足多条规则，则以最先过期时间规则为准。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:PutBucketLifecycle

    none

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    BucketName

    string

    是

    Bucket 名称。

    test
    RuleId

    string

    否

    标识规则的唯⼀ID。最多由 255 个字节组成。

    • 创建新规则时无需配置该参数，系统会⾃动⽣成⼀个唯⼀ID。

    • 更新已有规则需指定 RuleId，且该 RuleId 对应的规则必须存在，否则会报错。

    b8f93xxxxx4881xxxxxc71d991
    Status

    string

    是

    规则状态。取值范围：

    • Enabled：定期执⾏该规则。

    • Disabled：忽略该规则。

    Enabled
    Prefix

    string

    否

    指定规则所适⽤的前缀（Prefix），不⽀持设置相同的 Prefix。

    • 如果指定了 Prefix，则表示此规则仅适⽤于 Bucket 中与 Prefix 匹配的 Object。

    • 如果 Prefix 置空，则表示此规则适⽤于 Bucket 中所有 Object。

    image
    CreatedBeforeDate

    string

    否

    指定过期⽇期，存储会对最后更新时间早于该⽇期的数据执⾏⽣命周期规则。

    ⽇期设置需按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。

    说明

    ExpirationDays 和 CreateBeforeDate 互斥，必须设置⼀个。

    2023-10-12T05:45:00Z
    ExpirationDays

    integer

    否

    指定⽣命周期规则在距离 Object 最后更新多少天后⽣效。取值需大于 0，为正整数。

    说明

    ExpirationDays 和 CreateBeforeDate 互斥，必须设置⼀个。

    5
    AllowSameActionOverlap

    boolean

    否

    是否允许前缀重叠。取值：

    • true：允许重复。

    • false（默认值）：不允许重复。

    false

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    请求 ID。

    62373E71-5521-4620-8AAB-133CCE49357A
    RuleId

    string

    规则 ID。

    b8f93xxxxx4881xxxxxc71d991

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "62373E71-5521-4620-8AAB-133CCE49357A",
  "RuleId": "b8f93xxxxx4881xxxxxc71d991"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 Invalid%s The specified parameter %s is invalid.
    400 InvalidArgument Days and createBeforeDate can only choose one
    400 InvalidBucketName Specified parameter BucketName is not valid. 指定的BucketName参数无效。
    400 InvalidLifecycleScheme Specified parameter LifecycleScheme is not valid.
    400 InvalidType Specified parameter Type is not valid.
    400 OperationDenied Engine lifecycle scheme does't support replication lifecycle rule configuration.
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.
    403 AccessDenied auth is not valid
    403 UserDisable The user has been disabled due to arrears. 该用户因欠费被禁用。
    404 NoSuchBucket The specified bucket does not exist. 请求的目标Bucket不存在。
    404 NoSuchLifecycle The bucket lifecycle does not exist.

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。