查询云主机快照列表 - 混合云OpenAPI4.0

请求参数

Body 参数application/json

regionID

string

区域ID

必需

projectID

string

可选

企业项目ID 公有云字段，混合云暂不匹配

pageNo

integer <int32>

页码，默认值:1

可选

pageSize

integer <int32>

每页记录数目

可选

instanceID

string

云主机实例ID

可选

snapshotStatus

string

可选

快照状态公有云字段，混合云暂不支持，忽略

snapshotID

string

云主机快照实例ID

可选

queryContent

string

可选

模糊查找，根据快照名称、快照uuid、创建快照的云主机名称或创建快照的云主机uuid是否包含或等于该参数值进行筛选

snapshotName

string

快照名称

可选

示例

{
    "regionID": "TestRegionID",
    "projectID": "0",
    "pageNo": 1,
    "pageSize": 50,
    "instanceID": "b6e2966d-7b1c-385e-abe4-d940caa273b7",
    "snapshotName": "snapshot_for_restore"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/ecs/snapshot/list' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "projectID": "0",
    "pageNo": 1,
    "pageSize": 50,
    "instanceID": "b6e2966d-7b1c-385e-abe4-d940caa273b7",
    "snapshotName": "snapshot_for_restore"
}'

返回响应

🟢200successful operation

application/json

Body

returnObj

object

响应对象

必需

currentCount

integer <int64>

当前页记录数目

可选

totalCount

integer <int64>

总记录数

可选

totalPage

integer <int64>

总页数

可选

results

array [object {11}]

分页明细

可选

errorCode

string

错误码

可选

message

string

错误说明

可选

description

string

描述

可选

statusCode

integer <int32>

必需

返回状态码(800:成功;900:失败)。默认值:800

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "currentCount": 1,
        "results": [
            {
                "azName": "az1",
                "createdTime": "2022-10-31 T02:08:52Z",
                "instanceID": "instance_uuidc4cb5146-a148-3427-0425-73dd2b81e60a",
                "instanceName": "instance_name",
                "instanceStatus": "stopped",
                "members": [
                    {
                        "diskID": "volume_idf0c85685-c038-46e3-84cd-9f41ca98938d",
                        "diskName": "volume_nameopenapi-ipType-volume_000",
                        "diskSize": 40,
                        "diskSnapshotID": "sid56ac8923-87c7-4970-a71c-552f0df34752",
                        "diskSnapshotStatus": "available",
                        "diskType": "string",
                        "isBootable": true,
                        "isEncrypted": true
                    }
                ],
                "projectID": null,
                "snapshotDescription": null,
                "snapshotID": "73e30bcd-119b-9653-f864-a50150434a90",
                "snapshotName": "mock ---- name snapshot_for_restore",
                "snapshotStatus": "pending",
                "updatedTime": "2022-10-31 T02:08:52Z"
            }
        ],
        "totalCount": 0,
        "totalPage": 1
    },
    "statusCode": 800
}