跳到主要内容

查詢雲主機快照資訊

描述

查詢雲主機快照資訊,可根據查詢條件查詢多條記錄。

請求引數

引數名引數型別是否必填引數說明
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.yunpanel.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
    }]
    }
    }