查询防勒索备份快照信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| yundun-sas:DescribeSnapshots | Read |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Uuid | string | 否 | 要查询的服务器的 UUID。 说明
调用 DescribeBackupPolicy 接口可以获取该参数。
| 061d8042-59ff-416e-bc33-294a1cf5**** |
| MachineRegion | string | 否 | 服务器所在的地域。 | us-east-1 |
| MachineRemark | string | 否 | 要查询的服务器的名称或 IP 地址。 | 192.168.XX.XX |
| StatusList | string | 否 | 可恢复快照状态列表。取值：
| ["COMPLETE"] |
| PageSize | integer | 是 | 指定分页查询时，每页显示的数据最大条数。 | 20 |
| CurrentPage | integer | 否 | 设置从返回结果的第几页开始显示查询结果。默认值为 1，表示从第 1 页开始显示。 | 1 |
| NextToken | string | 否 | 用来标记当前开始读取的位置，置空表示从头开始。 说明
第一次调用不用填写，会在返回结果中包含第二次调用时用的 NextToken，之后每次调用返回结果中都有下一次调用时的 NextToken。
| CAESGgoSChAKDGNvbXBsZXRlVGltZRABCgQiAggAGAAiQAoJAB4SwmEAAAAACjMDLgAAADFTNzMyZDMwMzAzMDM0NzY3YTZjNjI3NjZmNmU3MjcxNjk3NDY5MzY3MjY4**** |
| ApiVersion | string | 是 | 防护策略的版本。取值：
| 2.0.0 |
| IsAliYunEcs | string | 否 | 是否阿里云 ECS 主机。取值：
| true |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "A4EB8B1C-1DEC-5E18-BCD0-D1BBB393****",
"PageInfo": {
"CurrentPage": 1,
"NextToken": "CAESGgoSChAKDGNvbXBsZXRlVGltZRABCgQiAggAGAAiQAoJAGYXFWIAAAAACjMDLgAAADFTNzMyZDMwMzAzMDM1Mzc3Njc4MzA2ODY5NmI2YTY1Nzg2NTcxNjE2NDc4****",
"PageSize": 20,
"TotalCount": 149,
"Count": 20
},
"Snapshots": [
{
"Status": "COMPLETE",
"SnapshotHash": "9ee47cf12351e4ddecce8c12f4957d3946cd96fbe24cd4ab264c7200839d****",
"ActualItems": 123,
"VaultId": "v-000ccok3zmw7fbzz****",
"ActualBytes": 0,
"SourceType": "ECS_FILE",
"ClientId": "c-000dbefaw9f7gnbw****",
"ItemsDone": 6,
"BytesTotal": 0,
"Retention": 7,
"CreatedTime": 1646793988,
"ParentSnapshotHash": "a0181606689c9562f092b3190bddb8a62bb5a24784424ba2102bc7fe92ae****",
"InstanceId": "i-2ze78zfakirgh1yl****",
"PlanId": "plan-000ee8gh2ljelsnb****",
"RegionId": "us-east-1",
"Uuid": "d332af48-1269-4a55-a6db-8543a80f****",
"ErrorFile": "s-0008ndhgrflh55i5****.csv",
"SnapshotId": "s-0003ahfuqpjdztsg****",
"JobId": "job-000a2q5vg6awgo01****",
"Path": "[\"/home\"]\n",
"ItemsTotal": 7,
"BytesDone": 800,
"Paths": [
"/home"
],
"ClientVersion": "2.10.0"
}
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 403 | NoPermission | caller has no permission | 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。 |
| 500 | ServerError | ServerError | 服务故障，请稍后重试！ |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|
暂无变更历史