云主机创建快照

本页目录

https://www.cloudam.cn/vps/cvmresource/snapshot/create?accountId={ACCOUNT_ID}&ip={IP}

请求方式:GET

云主机创建快照

注1: 一个磁盘一次创造一个快照,当前快照创建完成才可进行新的创建

URL Parameters

ParameterTypeDescription
IPString弹性公网ip地址
Example: 121.41.107.138
ACCOUNT_IDString你的Cloudam账户ID, Cloudam会随Token一起提前发送给客户
Example: demoaccount

Body Attributes(Body属性)

AttributeTypeDescription
diskTypeString需要创建快照的磁盘类型,可能的值:system,data
validTimeString有效期,形式为"yyyy-MM-dd"

Request(请求)

Headers(HTTP头) 注: 请首先联系Cloudam获取API Token,token相当于密码,请妥善保护。

{
"Authorization": "Bearer ${token}",
"Content-Type": "application/json"
}

Body(请求体JSON)

{
"diskType": "system",
"validTime": "2020-2-12"
}

Response(响应) - 200

Headers(响应头)

{
"Content-Type": "application/json"
}

Body(响应体JSON) -- 正确响应

{
"success": true,
"errorCode": "",
"errorMsg": "",
"snapshotId": "s-2zean6oiqkrzwfst3yej"
}

Response Body Attributes(响应Body属性)

AttributeTypeDescription
successboolean执行成功则返回true,失败则返回false
errorCodeString如果指定数量的IP没有全部创建成功,则此属性不为空,可能取值如下:
User.NotAllowed:用户Token无效或过期。
User.NotEnoughBalance:用户账户余额不足。
Cloud.NotEnoughResource:云厂商此刻IP资源不足,客户端在收到此错误码后可以稍等5分钟后再次尝试调用。
errorMsgString具体的错误信息可能取值如下:The user has no right to do this
snapshotIdArray若执行成功则会返回创建的快照ID