You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DescribeAutoSnapshotPolicy

最近更新时间：2024.04.25 17:11:26

首次发布时间：2022.06.02 15:47:48

我的收藏

调用DescribeAutoSnapshotPolicy接口，查询您在某个地域下，所有已创建的符合查询条件的自动快照策略。

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

名称类型是否必选示例值描述
ActionString是DescribeAutoSnapshotPolicy要执行的操作，取值：DescribeAutoSnapshotPolicy。

AutoSnapshotPolicyIds.N

String

否

AutoSnapshotPolicyIds.1=asp-anj249wubz9kakc8****
AutoSnapshotPolicyIds.2=asp-ancejlwubz9kakc8****

需要查询的自动快照策略ID列表。

PageNumberInteger否1实例信息列表的页码，取值为不超过Integer数据类型的最大值，起始值为1。
PageSizeInteger否1每页记录数。取值为1～100间的整数。默认为15。
ProjectNameString否default根据自动快照策略所属的Project（项目）名筛选快照。

TagFilters.N.Key

String

否

TagFilters.1.Key=tag

根据标签查询资源时指定的标签键。说明如下：

  • TagFilters.N.Key：N表示标签键的序号。取值范围：1～10。

  • 多个标签键之间用&分隔，不允许重复。

  • 不传入该参数则表示查询所有标签。

  • 传入空字符串时，则返回错误码InvalidTagFilterKey.Malformed。

TagFilters.N.Values.N

String

否

TagFilters.1.Values.1=tag&TagFilters.1.Values.2=test

根据标签查询资源时指定的标签值。说明如下：

  • TagFilters.N.Values.N：第一个N表示标签键的序号。取值范围：1～10。

  • TagFilters.N.Values.N：第二个N表示标签值的序号。取值范围：1～3。

  • 多个标签值之间用&分隔。

  • 如果传入该参数，则必须先传入TagFilters.N.Key。

  • 不传入该参数则表示查询同一标签键下的所有标签值。

  • 传入空字符串时，表示查询标签值为空的标签。

返回数据

名称类型示例值描述
AutoSnapshotPoliciesArray-符合条件自动快照策略列表。具体请参见下表“AutoSnapshotPolicy结构”。
TotalCountInteger3符合条件的自动快照策略总数。
PageNumberInteger1实例信息列表的页码。
PageSizeInteger15每页记录数。

AutoSnapshotPolicy结构

名称类型
示例值
描述
AutoSnapshotPolicyNameStringtestName自动快照策略的名称。
AutoSnapshotPolicyIdStringasp-anj249wubz9kakc8****自动快照策略ID。
StatusString-保留参数。
VolumeNumsInteger3自动快照策略关联的云盘数量。
TimePointsString"2", "8", "9"自动快照的创建时间点。
RepeatWeekdaysString"3", "5", "7"按周重复创建快照，即在周一至周日之间选择一个或多个日期创建快照。
RepeatDaysInteger2按天重复创建快照，即间隔一定的天数创建快照。

RetentionDays

Integer

50

自动快照的保留时间，单位为天，取值说明如下：

  • -1：永久保存
  • 1~65536：指定保存天数
CreatedAtString2021-06-28T15:10:47+08:00自动快照策略的创建时间。
UpdatedAtString2021-06-28T15:10:47+08:00自动快照策略的更新时间。
ProjectNameStringdefault自动快照策略所属项目。
TagsArray of Struct-自动快照策略的标签信息，具体请参见下表“ Tag结构 ”。

Tag结构

名称类型示例值描述
KeyStringtag自动快照策略的标签键。
ValueStringtest自动快照策略的标签值。

请求示例

GET /?Action=DescribeAutoSnapshotPolicy&Version=2020-04-01 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022050518000501021206303202BF****",
        "Action": "DescribeAutoSnapshotPolicy",
        "Version": "2020-04-01",
        "Service": "storage_ebs",
        "Region": "cn-beijing"
    },
    "Result": {
        "AutoSnapshotPolicies": [
            {
                "AccountId": "2000006376",
                "AutoSnapshotPolicyId": "asp-anj1nuju6w9gsaqi****",
                "AutoSnapshotPolicyName": "modify_****autosanpshot_policy",
                "CreatedAt": "2022-04-28T18:46:36+08:00",
                "ProjectName": "default",
                "RepeatWeekdays": [
                    "3",
                    "5",
                    "7"
                ],
                "RetentionDays": 50,
                "Status": "",
                "TimePoints": [
                    "2",
                    "8",
                    "9"
                ],
                "Tags": [
				            {
				                "Key": "tag",
				                "Value": "value"
				            }
				        ],
                "UpdatedAt": "2022-04-28T18:46:37+08:00",
                "VolumeNums": 0
            },
            {
                "AccountId": "2000006376",
                "AutoSnapshotPolicyId": "asp-anj2a9gwj49gsbso****",
                "AutoSnapshotPolicyName": "****test",
                "CreatedAt": "2022-04-28T14:49:01+08:00",
                "ProjectName": "default",
                "RepeatWeekdays": [
                    "1"
                ],
                "RetentionDays": -1,
                "Status": "",
                "TimePoints": [
                    "0"
                ],
                "Tags": [
				            {
				                "Key": "tag",
				                "Value": "value"
				            }
				        ],
                "UpdatedAt": "2022-04-28T14:49:01+08:00",
                "VolumeNums": 0
            }
        ],
        "PageNumber": 1,
        "PageSize": 10,
        "RequestId": "2022050518000501021206303202BFE158-cc****",
        "TotalCount": 2
    }
}

错误码

HttpCode错误码错误信息
500InternalError内部错误，请提工单解决