设置桶的生命周期配置
功能说明
配置桶的生命周期规则,实现定时转换桶中对象的存储类型,以及定时删除桶中对象的功能。
方法定义
ObsClient.setBucketLifecycle
请求参数
|
字段名 |
类型 |
约束 |
说明 |
||
|---|---|---|---|---|---|
|
Bucket |
String |
必选 |
桶名。 |
||
|
RequestDate |
String 或 Date |
可选 |
指定请求时间。
说明:
当为String类型时,必须符合ISO8601或RFC822规范。 |
||
|
Rules |
Array |
必选 |
桶生命周期规则列表。 |
||
|
Transitions |
Array |
可选 |
对象转换策略列表。 |
||
|
StorageClass |
String |
必选 |
对象转换后的存储类型。
说明:
不支持“标准存储”类型。 |
||
|
Date |
String |
如果没有设置Days则必选 |
表示对象转换的日期。该值必须兼容ISO8601格式(例如:2018-01-01T00:00:00Z),而且必须是UTC午夜0点。 |
||
|
Days |
Number |
如果没有设置Date则必选 |
表示在对象创建时间后第几天时转换,正整数。 |
||
|
Expiration |
Object |
可选 |
对象过期时间配置。 |
||
|
Date |
String |
如果没有设置Days则必选 |
表示对象过期的日期。该值必须兼容ISO8601格式(例如:2018-01-01T00:00:00Z),而且必须是UTC午夜0点。 |
||
|
Days |
Number |
如果没有设置Date则必选 |
表示在对象创建时间后第几天时过期,正整数。 |
||
|
ID |
String |
可选 |
规则ID,由不超过255个字符的字符串组成。 |
||
|
Prefix |
String |
必选 |
对象名前缀,用以标识哪些对象可以匹配到当前这条规则。可为空字符串,代表匹配桶内所有对象。 |
||
|
Status |
String |
必选 |
标识当前这条规则是否启用,支持的值:
|
||
|
NoncurrentVersionTransitions |
Array |
可选 |
历史版本对象转换策略列表。 |
||
|
StorageClass |
String |
必选 |
历史版本对象转换后的存储类型。 |
||
|
NoncurrentDays |
Number |
必选 |
表示对象成为历史版本后第几天时转换,正整数。 |
||
|
NoncurrentVersionExpiration |
Object |
可选 |
历史版本对象过期时间配置。 |
||
|
NoncurrentDays |
Number |
必选 |
表示对象成为历史版本后第几天时过期,正整数。 |
||
Transition、Expiration、NoncurrentVersionTransitions、NoncurrentVersionExpiration不能全为空。
返回结果(InterfaceResult)
|
字段名 |
类型 |
说明 |
|---|---|---|
|
RequestId |
String |
OBS服务端返回的请求ID。 |
代码样例
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'}}
]
},function (err, result) {
if(err){
console.error('Error-->' + err);
}else{
if(result.CommonMsg.Status < 300){
console.log('RequestId-->' + result.InterfaceResult.RequestId);
}else{
console.log('Code-->' + result.CommonMsg.Code);
console.log('Message-->' + result.CommonMsg.Message);
}
}
});