查询云硬盘关联定期快照策略

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

1. 接口描述

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

本接口（DescribeDiskAssociatedAutoSnapshotPolicy）用于查询云盘绑定的定期快照策略。

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

接口更新时间：2018-04-19 09:44:23。

接口只验签名不鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeDiskAssociatedAutoSnapshotPolicy
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
DiskId	是	否	String	要查询的云硬盘ID。示例值： disk-pe1vkgim

3. 输出参数

参数名称	类型	描述
TotalCount	Uint64	云盘绑定的定期快照数量。示例值： 0
AutoSnapshotPolicySet	Array of AutoSnapshotPolicy	云盘绑定的定期快照列表。示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码	描述
InvalidParameterValue	无效参数值。参数值格式错误或者参数值不被支持等。
MissingParameter	参数缺失。请求没有带必选参数。

5. 示例

示例1 查询云盘disk-dw0bbzws绑定的定期快照策略

输入示例

https://cbs.api3.fincloud.tencent.cn/?Action=DescribeDiskAssociatedAutoSnapshotPolicy
&DiskId=disk-dw0bbzws
&<公共请求参数>

输出示例

{
    "Response": {
        "AutoSnapshotPolicySet": [
            {
                "IsActivated": 1,
                "AutoSnapshotPolicyName": "sds",
                "IsPermanent": 0,
                "NextTriggerTime": "2017-12-03 00:00:00",
                "AutoSnapshotPolicyId": "asp-mrsrn243",
                "Policy": [
                    {
                        "DayOfWeek": [
                            0
                        ],
                        "Hour": [
                            0
                        ]
                    }
                ],
                "CreateTime": "2017-11-17 15:09:12",
                "RetentionDays": 7
            }
        ],
        "TotalCount": 1,
        "RequestId": "8612f14a-fd07-85b5-39f9-5a1fa51efa14"
    }
}