更新时间：2025-12-04 GMT+08:00

设置桶的生命周期配置

功能说明

配置桶的生命周期规则，实现定时删除桶中对象的功能。

方法定义

1. ObsClient->setBucketLifecycle(array $parameter)
2. ObsClient->setBucketLifecycleAsync(array $parameter, callable $callback)

请求参数

字段名			类型	约束	说明
Bucket			string	必选	桶名。
Rules			indexed array	必选	桶生命周期规则列表。
-	Transitions		indexed array	可选	对象转换策略列表。
	-	StorageClass	string	必选	对象转换后的存储类型。说明：不支持“标准存储”类型。
		Date	string 或 \DateTime	如果没有设置Days则必选	表示对象转换的日期。该值必须兼容ISO8601格式（例如：2018-01-01T00:00:00Z），而且必须是UTC午夜0点。
		Days	integer	如果没有设置Date则必选	表示在对象创建时间后第几天时转换，正整数。
-	Expiration		associative array	可选	对象过期时间配置。
	-	Date	string 或 \DateTime	如果没有设置Days则必选	表示对象过期的日期。该值为字符串时必须兼容ISO8601格式（例如：2018-01-01T00:00:00Z），而且必须是UTC午夜0点。
	-	Days	integer	如果没有设置Date则必选	表示在对象创建时间后第几天时过期，正整数。
	ID		string	可选	规则ID，由不超过255个字符的字符串组成。
	Prefix		string	必选	对象名前缀，用以标识哪些对象可以匹配到当前这条规则。可为空字符串，代表匹配桶内所有对象。
	Status		string	必选	标识当前这条规则是否启用，支持的值： Enabled：启用规则 Disabled：禁用规则
-	NoncurrentVersionTransitions		indexed array	可选	历史版本对象转换策略列表。
	-	StorageClass	string	必选	历史版本对象转换后的存储类型。
	-	NoncurrentDays	integer	必选	表示对象成为历史版本后第几天时转换，正整数。
-	NoncurrentVersionExpiration		associative array	可选	历史版本对象过期时间配置。
-	-	NoncurrentDays	integer	必选	表示对象成为历史版本后第几天时过期，正整数。

Transitions、Expiration、NoncurrentVersionTransitions、NoncurrentVersionExpiration不能全为空。

返回结果

字段名	类型	说明
HttpStatusCode	integer	HTTP状态码。
Reason	string	HTTP文本描述。
RequestId	string	OBS服务端返回的请求ID。

代码样例

try{
       $resp = $obsClient -> setBucketLifecycle([
              'Bucket' => 'bucketname',
              'Rules' => [
                     ['ID' => 'rule1', 'Prefix' => 'prefix1', 'Status' => 'Enabled', 'Expiration' => ['Days' => 60], 'NoncurrentVersionExpiration' => ['NoncurrentDays' => 60]],
                     ['ID' => 'rule2', 'Prefix' => 'prefix2', 'Status' => 'Enabled', 'Expiration' => ['Date' => '2018-12-31T00:00:00Z']]
              ]
       ]);
       printf("RequestId:%s\n", $resp['RequestId']);
}catch (Obs\Common\ObsException $obsException){
       printf("ExceptionCode:%s\n", $obsException->getExceptionCode());
       printf("ExceptionMessage:%s\n", $obsException->getExceptionMessage());
}

父主题：桶相关接口

上一篇：删除桶策略

下一篇：获取桶的生命周期配置