跳到主要内容

查询云主机快照信息

描述

查询云主机快照信息,可根据查询条件查询多条记录。

请求参数

参数名参数类型是否必填参数说明
ActionString操作方法:DescribeInstanceSnapshots
RegionString机房标识,取值参见地域列表
InstanceId.NString云主机ID,支持批量,N为自然数,格式:&InstanceId.0=xxx&InstanceId.1=xxx等
Id.NString云主机快照ID,支持批量,N为自然数,格式:&Id.0=xxx&Id.1=xxx等
NameString名称
StartTimeString创建开始时间 格式yyyy-MM-dd HH:mm:ss
EndTimeString创建结束时间 格式yyyy-MM-dd HH:mm:ss
OffsetInteger记录偏移量,不指定取 0
CountInteger记录数量,不指定为全部
StatusString状态,取值范围:
  • CREATING
  • AVAILABLE
  • DELETING
  • ERROR
  • COPYING
  • ROLLING_BACK
  • ERROR_DELETING
  • 返回参数

    名称类型说明
    ActionString执行的操作
    TaskIdString请求标识
    TotalCountInteger过滤条件下总共记录数
    InstanceSnapshotSetInstanceSnapshotItemType由InstanceSnapshotItemType组成的数组格式,返回云主机快照信息

    InstanceSnapshotItemType

    云主机快照信息的数据类型

    名称类型说明
    IdString实例快照标识
    NameString名称
    DescriptionString描述信息
    StartTimeDateTime开始时间
    StatusString快照状态:CREATING,AVAILABLE,DELETING,ERROR,`ERROR_DELETING, ROLLING_BACK
    VolumeIdString卷标识
    VolumeSnapshotIdString卷快照标识
    SizeInteger快照大小
    InstanceIdString云主机标识
    UserIdString所属用户ID
    IsFileLockString是否归档类型的快照

    请求示例

    https://api.chinac.com/v2/?Action=DescribeInstanceSnapshots
    &Name=LukeSkywalker
    &公共参数

    返回示例

    {
    "code": 10000,
    "message": "",
    "data": {
    "TaskId": "p11520170509141741086",
    "Action": "DescribeInstanceSnapshots",
    "TotalCount": 1,
    "InstanceSnapshotSet": [{
    "Id": "is-959ih49eh22",
    "Name": "test23",
    "Description": "test23",
    "StartTime": "2017-05-09T14:17:38 +0800",
    "Status": "CREATING",
    "VolumeId": "v-nl9ih49e7r70",
    "VolumeSnapshotId": null,
    "InstanceId": "i-719ih49e6c9p",
    "Locked": null,
    "UserId": "18359229",
    "IsFileLock": null
    }]
    }
    }