获取生命周期信息 - DescribeUFileLifeCycle

简介

获取生命周期信息

定义

公共参数

参数名	类型	描述信息	必填
Action	string	对应的 API 指令名称，当前 API 为 `DescribeUFileLifeCycle`	Yes
PublicKey	string	用户公钥，可从控制台获取	Yes
Signature	string	根据公钥及 API 指令生成的用户签名，参见签名算法	Yes

请求参数

参数名	类型	描述信息	必填
Region	string	地域。参见地域和可用区列表	No
ProjectId	string	项目ID。不填写为默认项目，子帐号必须填写。请参考GetProjectList接口	No
BucketName	string	存储空间名称	Yes
LifeCycleId	string	生命周期Id；不传递此参数拉取存储空间下面的所有生命周期信息	No

响应字段

字段名	类型	描述信息	必填
RetCode	int	返回状态码，为 0 则为成功返回，非 0 为失败	Yes
Action	string	操作指令名称	Yes
Message	string	返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息	No
DateSet	array[LifeCycleItem]	生命周期信息	Yes

数据模型

LifeCycleItem

字段名	类型	描述信息	必填
LifeCycleId	string	生命周期Id	No
LifeCycleName	string	生命周期名称	No
Prefix	string	生命周期所适用的前缀；*为整个存储空间文件；	No
Days	int	指定一个过期天数N，文件会在其最近更新时间点的N天后过期，自动删除，0代表不启用；	No
Status	string	Enabled — 启用，Disabled — 不启用	No
BucketName	string	存储空间名称	No
ArchivalDays	int	指定一个过期天数N，文件会在其最近更新时间点的N天后过期，自动转换为归档存储类型，0代表不启用；	No
IADays	int	指定一个过期天数N，文件会在其最近更新时间点的N天后过期，自动转换为低频存储类型，0代表不启用；	No

示例

请求示例


https://api.tnqacloud.com/?Action=DescribeUFileLifeCycle
&Region=cn-gd
&ProjectId=org-sdfsdf
&BucketName=test
&LifeCycleId=dc7eca04-edbc-4ae9-aefd-816253123456

响应示例


{
  "Action": "DescribeUFileLifeCycleResponse",
  "DateSet": [
    {
      "BucketName": "test",
      "Days": 10,
      "LifeCycleId": "dc7eca04-edbc-4ae9-aefd-816253123456",
      "LifeCycleName": "lifecycle",
      "Prefix": "test-",
      "Status": "Enabled"
    }
  ],
  "RetCode": 0
}