PutBucketLifecycle_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

只有 Bucket 的拥有者以及被授予 PutBucketLifecycle 权限的 RAM 用户才能发起配置生命周期规则的请求。
如果 Bucket 此前没有设置过生命周期规则，此操作会创建一个新的生命周期规则；如果 Bucket 此前设置过生命周期规则，此操作会覆写先前的规则配置。
PutBucketLifecycle 是覆盖语义。当您需要追加生命周期规则时，请先调用 GetBucketLifecycle 接口获取当前生命周期规则配置，然后追加新的生命周期规则配置，最后调用 PutBucketLifecycle 接口更新生命周期规则配置。
PutBucketLifecycle 操作可以对 Object 以及 Part（以分片方式上传，但最后未提交的分片）设置过期时间。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:PutBucketLifecycle	Update	Bucket acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}	acs:UserAgent acs:AccessId oss:BucketTag oss:TLSVersion	无

请求语法

PUT /?lifecycle HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-allow-same-action-overlap: string
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>string</ID>
    <Prefix>string</Prefix>
    <Status>string</Status>
    <Expiration>
      <CreatedBeforeDate>string</CreatedBeforeDate>
      <Days>integer</Days>
      <ExpiredObjectDeleteMarker>boolean</ExpiredObjectDeleteMarker>
      <Date>string</Date>
    </Expiration>
    <Transition>
      <CreatedBeforeDate>string</CreatedBeforeDate>
      <Days>integer</Days>
      <StorageClass>string</StorageClass>
      <IsAccessTime>boolean</IsAccessTime>
      <ReturnToStdWhenVisit>boolean</ReturnToStdWhenVisit>
      <AllowSmallFile>boolean</AllowSmallFile>
    </Transition>
    <AbortMultipartUpload>
      <Days>integer</Days>
      <CreatedBeforeDate>string</CreatedBeforeDate>
    </AbortMultipartUpload>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>integer</NoncurrentDays>
    </NoncurrentVersionExpiration>
    <NoncurrentVersionTransition>
      <NoncurrentDays>integer</NoncurrentDays>
      <StorageClass>string</StorageClass>
      <IsAccessTime>boolean</IsAccessTime>
      <ReturnToStdWhenVisit>boolean</ReturnToStdWhenVisit>
      <AllowSmallFile>boolean</AllowSmallFile>
    </NoncurrentVersionTransition>
    <Filter>
      <Not>
        <Prefix>string</Prefix>
        <Tag>
          <Key>string</Key>
          <Value>string</Value>
        </Tag>
      </Not>
      <ObjectSizeGreaterThan>integer</ObjectSizeGreaterThan>
      <ObjectSizeLessThan>integer</ObjectSizeLessThan>
    </Filter>
    <AtimeBase>integer</AtimeBase>
  </Rule>
</LifecycleConfiguration>

请求参数

字段名称	字段详情
bucketstring	Bucket 名称。示例值:examplebucket
x-oss-allow-same-action-overlapstring	指定生命周期规则是否允许前缀重叠。取值如下：展开详情示例值:true
bodyobject	保存 Lifecycle 配置的请求体。

变更历史

	变更时间	变更内容概要	操作
	2024-03-05	新增请求参数x-oss-allow-same-action-overlap
	2024-02-21	新增请求参数body

PutBucketLifecycle_对象存储_API文档

接口说明

流控信息

授权信息

请求语法

请求参数

变更历史

相关示例