查询文件系统快照策略列表信息

最近更新时间: 2026-09-17 00:03:24

1. 接口描述

接口请求域名： cfs.api3.fincloud.tencent.cn。

查询文件系统快照d定期策略列表信息

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

接口更新时间：2022-03-31 17:39:47。

接口既验签名又鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeAutoSnapshotPolicies
Version	是	否	String	公共参数，本接口取值：2019-07-19
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
AutoSnapshotPolicyId	否	否	String	快照策略ID 示例值： asp-xcweqdx
Offset	否	否	Uint64	分页示例值： 2
Limit	否	否	Uint64	页大小示例值： 2
Filters	否	否	Array of Filter	过滤条件示例值：查看
Order	否	否	String	排序规则:ASC;DESC 示例值： ASC,DESC
OrderField	否	否	String	排序字段:CreationTime;FileSystemNums;TotalSnapshotSize;SizeByte 示例值： CreationTime

3. 输出参数

参数名称	类型	描述
TotalCount	Uint64	总数据量示例值： 3
AutoSnapshotPolicies	Array of AutoSnapshotPolicyInfo	快照策略信息示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 查询快照策略

输入示例


{
    "AutoSnapshotPolicyId": "asp-12345"
}

输出示例

{
  "Response": {
    "AutoSnapshotPolicies": [
      {
        "AliveDays": 30,
        "AppId": 1,
        "AutoSnapshotPolicyId": "asp-region",
        "CreationTime": "2021-08-11 19:36:53",
        "CrossRegionsAliveDays": 0,
        "DayOfMonth": "",
        "DayOfWeek": "1,2,3,4,5,6,7",
        "DestinationRegions": null,
        "FileSystemNums": 0,
        "FileSystems": [],
        "Hour": "11,12,13,14,15,16,17,18,19,20,21",
        "IntervalDays": 0,
        "IsActivated": 1,
        "IsCrossRegion": false,
        "NextActiveTime": "2024-12-12 16:00:00",
        "PolicyName": "default",
        "RegionName": "ap-region1",
        "Status": "available"
      }
    ],
    "RequestId": "d803fa9b-cbd1-42a8-9098-c5f8a5bd763c",
    "TotalCount": 1
  }
}