文件存储 数据生命周期策略

接口请求域名: cfs.tencentcloudapi.com 。推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。可以查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

相关产品
文件存储 产品页,含版本规格、价格与购买入口。

一、1. 接口描述

配置生命周期策略关联到的目录列表

默认接口请求频率限制:20次/秒。

二、2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数,本接口取值:ApplyPathLifecyclePolicy。
Version 是 String 公共参数,本接口取值:2019-07-19。
Region 是 String 公共参数,详见产品支持的 地域列表。
LifecyclePolicyID 是 String 生命周期管理策略ID示例值:policy-xxxxxx
Paths.N 否 Array of PathInfo 生命周期管理策略所关联的目录路径列表,每个路径必须以 /cfs/ 开头,代表文件存储实例内部的逻辑路径,而非本地挂载点路径。示例:若挂载的是CFS根目录 /,需关联挂载路径下的 test1/test2,则入参值为 /cfs/test1/test2若挂载的是CFS子目录 /subdir,需关联挂载路径下的 test1/test2,则入参值为 /cfs/subdir/test1/test2

三、3. 输出参数

参数名称 类型 描述
CheckResults Array of CheckResult 有规则冲突时返回的已有冲突规则信息注意:此字段可能返回 null,表示取不到有效值。
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

四、输入示例

https://cfs.tencentcloudapi.com/?Action=ApplyPathLifecyclePolicy
&LifecyclePolicyID=policy-ek8aw4id
&Paths.0.FileSystemId=cfs-4030acd30
&Paths.0.Path=/data
&<公共请求参数>

五、输出示例

{
"Response": {
"CheckResults": [
{
"LifecyclePolicyID": "policy-4cqyxcma",
"FileSystemId": "cfs-5ajk45jk8",
"Path": "/data/home/user00/",
"LifecycleRules": [
{
"StorageType": "InfrequentAccess",
"Interval": "DEFAULT_ATIME_14",
"FileType": "All",
"Action": "Archive",
"FileMaxSize": "1G",
"FileMinSize": "1M"
}
],
"TargetPath": "/data/home/user00/"
}
],
"RequestId": "a1b2c3-d4e5f6-g7h8j9"
}
}

六、腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便你从同一入口查询及使用腾讯云提供的所有 API 服务。

七、API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

八、SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

·Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

九、命令行工具

·Tencent Cloud CLI 3.0

十、6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。

错误码 描述
InvalidParameterValue.BindInfrequentaccessFirst 参数值错误: 绑定归档规则前需绑定沉降规则
InvalidParameterValue.ExternalStorageSupportDataflowOnly ExternalStorage 生命周期模式只支持数据流动
InvalidParameterValue.InvalidPolicyFsPath 目录路径中包含无效字符。
InvalidParameterValue.PathUsedInDataflow 该文件系统目录已配置数据流动,请配置其他规则
ResourceInsufficient.PolicyFsLimitExceeded 策略绑定文件系统数量超过限制。
ResourceInsufficient.PolicyFsPathLimitExceeded 策略绑定路径数量超过限制。
ResourceInsufficient.PolicyLimitExceeded 该用户的生命周期策略个数达到最大限制。
UnsupportedOperation 操作不支持。
赞 (0)
上一篇 4天前
下一篇 4天前