调用DescribeAutoSnapshotPolicies接口查询已创建的自动快照策略。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeAutoSnapshotPolicies

接口名称。

固定取值：DescribeAutoSnapshotPolicies
FileSystemType String 是 extreme

文件系统类型。

取值：extreme（极速型NAS）
AutoSnapshotPolicyId String 否 sp-extreme-233e6****

自动快照策略ID。
PageSize Integer 否 10

每个分页包含的自动快照策略的个数。

取值范围：1~100

默认值：10
PageNumber Integer 否 1

自动快照策略列表的页码。

起始值（默认值）：1

返回数据

名称 类型 示例值 描述
AutoSnapshotPolicies Array of AutoSnapshotPolicy

自动快照策略详情集合。
AutoSnapshotPolicy
AutoSnapshotPolicyId String FinanceJoshua

自动快照策略ID。
AutoSnapshotPolicyName String p-23f2i9s4t

自动快照策略的名称。
CreateTime String 2014-04-21T12:08:52Z

创建时间。

按照ISO8601标准表示，并使用UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。

FileSystemNums Integer 2

启用该策略的文件系统数量。
RegionId String cn-hangzhou

自动快照策略所属的地域ID。
RepeatWeekdays String 1,5

自动快照的重复日期。

重复周期：星期

取值范围：1~7，例如：1表示周一。
RetentionDays Integer 30

自动快照的保留时间。

单位：天

包括：

  • -1：永久保存，当快照数量达到额度上限后被自动删除。
  • 1~65536：指定保存天数，保留时间到期后快照会被自动释放。
Status String Available

自动快照策略状态。

包括：

  • Creating：创建中
  • Available：正常可用
TimePoints String 4,19

自动快照的创建时间点。

单位：小时

包括：0~23，表示从00:00~23:00共24个时间点。1代表在01:00时间点。最多24个时间点，用半角逗号（,）隔开。
PageNumber Integer 1

自动快照策略列表的页码。
PageSize Integer 10

分页展示返回的自动快照策略时的每页行数。
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。
TotalCount Integer 2

自动快照策略的总个数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAutoSnapshotPolicies
&FileSystemType=extreme
&<公共请求参数>

正常返回示例

XML 格式 

<TotalCount>2</TotalCount>
<PageSize>10</PageSize>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<PageNumber>1</PageNumber>
<AutoSnapshotPolicies>
    <AutoSnapshotPolicy>
        <Status>Available</Status>
        <TimePoints>4,19</TimePoints>
        <FileSystemNums>2</FileSystemNums>
        <CreateTime>2014-04-21T12:08:52Z</CreateTime>
        <RetentionDays>30</RetentionDays>
        <AutoSnapshotPolicyId>FinanceJoshua</AutoSnapshotPolicyId>
        <RepeatWeekdays>1,5</RepeatWeekdays>
        <RegionId>cn-hangzhou</RegionId>
        <AutoSnapshotPolicyName>p-23f2i9s4t</AutoSnapshotPolicyName>
    </AutoSnapshotPolicy>
</AutoSnapshotPolicies>

JSON 格式 

{
    "TotalCount": 2,
    "PageSize": 10,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "PageNumber": 1,
    "AutoSnapshotPolicies": {
        "AutoSnapshotPolicy": {
            "Status": "Available",
            "TimePoints": "4,19",
            "FileSystemNums": 2,
            "CreateTime": "2014-04-21T12:08:52Z",
            "RetentionDays": 30,
            "AutoSnapshotPolicyId": "FinanceJoshua",
            "RepeatWeekdays": "1,5",
            "RegionId": "cn-hangzhou",
            "AutoSnapshotPolicyName": "p-23f2i9s4t"
        }
    }
}

错误码

访问错误中心查看更多错误码。