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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
AutoSnapshotPolicyId String sp-extreme-233e6****

自动快照策略ID。

PageSize Integer 10

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

取值范围:1~100

默认值:10

PageNumber Integer 1

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

起始值(默认值):1

FileSystemType String extreme

文件系统类型。

取值:extreme(极速型NAS)

返回数据

名称 类型 示例值 描述
TotalCount Integer 2

自动快照策略的总个数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

PageSize Integer 10

分页展示返回的自动快照策略时的每页行数。

PageNumber Integer 1

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

AutoSnapshotPolicies Array of AutoSnapshotPolicy

自动快照策略详情集合。

AutoSnapshotPolicy
TimePoints String 4,19

自动快照的创建时间点。

单位:小时

包括:0~23,表示从00:00~23:00共24个时间点。1代表在01:00时间点。最多24个时间点,用半角逗号(,)隔开。

Status String Available

自动快照策略状态。

包括:

  • Creating:创建中
  • Available:正常可用
RepeatWeekdays String 1,5

自动快照的重复日期。

重复周期:星期

取值范围:1~7,例如:1表示周一。

AutoSnapshotPolicyName String p-23f2i9s4t

自动快照策略的名称。

CreateTime String 2014-04-21T12:08:52Z

创建时间。

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

AutoSnapshotPolicyId String FinanceJoshua

自动快照策略ID。

RetentionDays Integer 30

自动快照的保留时间。

单位:天

包括:

  • -1:永久保存,当快照数量达到额度上限后被自动删除。
  • 1~65536:指定保存天数,保留时间到期后快照会被自动释放。
FileSystemNums Integer 2

启用该策略的文件系统数量。

RegionId String cn-hangzhou

自动快照策略所属的地域ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAutoSnapshotPolicies
&AutoSnapshotPolicyId=sp-extreme-233e6****
&PageSize=10
&PageNumber=1
&FileSystemType=extreme
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAutoSnapshotPoliciesResponse>
    <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>
</DescribeAutoSnapshotPoliciesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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"
    }
  }
}

错误码

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