配额和快照接口
获取实例配额
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeInstanceQuota |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
InstanceQuota | int | 当前租户实例配额 |
InstanceUsage | int | 已使用的实例配额 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeInstanceQuota&Version=2017-12-14
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"InstanceQuota": 10,
"InstanceUsage": 3
}
获取快照配额
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeSnapshotQuota |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
InstanceId | String | 是 | 要获取配额信息的云服务器uuid |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
AutoSnapshotQuota | int | 当前自动快照配额 |
AutoSnapshotUsage | int | 已使用的自动快照配额 |
ManualSnapshotQuota | int | 当前手动快照配额 |
ManualSnapshotUsage | int | 已使用的手动快照配额 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeSnapshotQuota&Version=2017-12-14
&InstanceId=08220b8f-fb5f-11e7-99b3-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"AutoSnapshotQuota": 7,
"AutoSnapshotUsage": 3
"ManualSnapshotQuota": 3,
"ManualSnapshotUsage": 0
}
创建云服务器快照
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:CreateSnapshot |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
InstanceId | String | 是 | 要创建快照的云服务器uuid |
Name | String | 是 | 快照名称 3-63字符,数字或者中划线组成,以字母开头 |
Description | String | 否 | 描述信息 base64格式 编码后一百字符以内 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
SnapshotId | String | 快照id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=CreateSnapshot&Version=2017-12-14
&InstanceId=08220b8f-fb5f-11e7-99b3-3200174de000&Name=testSnapshot
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"SnapshotId": "a6af71c0-fb5b-11e7-b619-3200174de000"
}
获取云服务器快照列表
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeSnapshots |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
InstanceId | String | 是 | 云服务器uuid |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
TotalCount | int | 快照总数 |
Snapshots | List<Object> | 快照列表 |
Snapshots参数
名称 | 类型 | 描述 |
SnapshotId | String | 快照id |
SnapshotName | String | 快照名称 |
InstanceId | String | 快照所属云服务器 |
Type | String | 快照类型 |
Status | String | 快照状态 |
Description | String | 快照描述 |
CreateAt | String | 快照创建时间 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeSnapshots&Version=2017-12-14
&InstanceId=08220b8f-fb5f-11e7-99b3-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"TotalCount": "2",
"Snapshots": [
{
"CreateAt": "2017-12-11T12:26:53Z",
"InstanceId": "30199b08-572d-4fec-834e-9453d4671151",
"SnapshotId": "7e0771db-1694-4c62-bb6d-9e0b156ebfa9",
"SnapshotName": "testSnapshot3",
"Status": "ACTIVE",
"Type": "manual"
},
{
"CreateAt": "2017-12-11T12:26:53Z",
"InstanceId": "30199b08-572d-4fec-834e-9453d4671151",
"SnapshotId": "3c9aedd0-f5f9-4fcc-93d8-3c6e20c8f6d6",
"SnapshotName": "testSnapshot2",
"Status": "ACTIVE",
"Type": "manual"
}
]
}
删除云服务器快照
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DeleteSnapshot |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
SnapshotId | String | 是 | 快照id |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DeleteSnapshot&Version=2017-12-14
&SnapshotId=3c9aedd0-f5f9-4fcc-93d8-3c6e20c8f6d6
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
}
保存云服务器快照为镜像
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:CreateImageFromSnapshot |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
SnapshotId | String | 是 | 快照id |
ImageName | String | 是 | 镜像名称 3-32字符,数字或者中划线组成,以字母开头 |
ImageDescription | String | 否 | 镜像描述信息 base64格式 编码后一百字符以内 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
ImageId | String | 镜像id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=CreateImageFromSnapshot&Version=2017-12-14
&SnapshotId=3c9aedd0-f5f9-4fcc-93d8-3c6e20c8f6d6&ImageName=testImage
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"ImageId": "a6af71c0-fb5b-11e7-b619-3200174de000"
}
从快照恢复云服务器
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:RevertFromSnapshot |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
SnapshotId | String | 是 | 快照id |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=RevertFromSnapshot&Version=2017-12-14
&SnapshotId=08220b8f-fb5f-11e7-99b3-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
}
创建自动快照策略
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:CreateSnapshotStrategy |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
Name | String | 是 | 快照策略名称 3-32字符,数字或者中划线组成,以字母开头 |
StrategyPattern | String | 是 | crontab格式 表示快照周期 base64格式编码 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
StrategyId | String | 快照策略Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=CreateSnapshotStrategy&Version=2017-12-14
&StrategyPattern=MCAwIDktMTcgKiAqIE1PTi1GUkk=
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"StrategyId": "a6af71c0-fb5b-11e7-b619-3200174de000"
}
修改自动快照策略
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:ModifySnapshotStrategy |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
StrategyId | String | 快照策略Id | |
StrategyPattern | String | 是 | crontab格式 表示快照周期 base64格式编码 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=ModifySnapshotStrategy&Version=2017-12-14
&StrategyId=a6af71c0-fb5b-11e7-b619-3200174de000
&StrategyPattern=MCAwIDktMTcgKiAqIE1PTi1GUkk=
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
}
删除自动快照策略
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DeleteSnapshotStrategy |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
StrategyId | String | 快照策略Id | |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DeleteSnapshotStrategy&Version=2017-12-14
&StrategyId=08220b8f-fb5f-11e7-99b3-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
}
自动快照策略关联云服务器
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:ApplySnapshotStrategy |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
InstanceId | String | 是 | 云服务器uuid |
StrategyId | String | 是 | 自动快照id |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=ApplySnapshotStrategy&Version=2017-12-14
&InstanceId=08220b8f-fb5f-11e7-99b3-3200174de000
&StrategyId=a6af71c0-fb5b-11e7-b619-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
}
取消云服务器自动快照策略
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:CancelSnapshotStrategy |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
InstanceId | String | 是 | 云服务器uuid |
StrategyId | String | 是 | 自动快照id |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=CancelSnapshotStrategy&Version=2017-12-14
&InstanceId=08220b8f-fb5f-11e7-99b3-3200174de000
&StrategyId=a6af71c0-fb5b-11e7-b619-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
}
获取云服务器自动快照策略详细信息
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeSnapshotStrategies |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
Limit | int | 否 | 查询结果每页结果数量 默认20 |
Offset | int | 否 | 查询结果起始序号 默认0 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
TotalCount | int | 自动快照策略数量 |
SnapshotStrategies | List<Object> | 自动快照策略列表 |
SnapshotStrategies参数
名称 | 类型 | 描述 |
StrategyName | String | 快照策略名称 |
StrategyId | String | 快照策略Id |
StrategyPattern | String | 快照策略内容 |
StrategyMappingCount | String | 快照策略关联的云服务器数量 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeSnapshotStrategies&Version=2017-12-14
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"TotalCount": "2",
"SnapshotStrategies": [
{
"StrategyId": "30199b08-572d-4fec-834e-9453d4671151",
"StrategyName": "testStrategy1",
"StrategyPattern": "0 0 9-17 * * MON-FRI",
"StrategyMappingCount": 1
},
{
"StrategyId": "51318d9b-4971-4392-9e46-2b99a9fcab13",
"StrategyName": "testStrategy2",
"StrategyPattern": "0 0 1 * * *",
"StrategyMappingCount": 1
}
]
}
获取自动快照关联的云主机列表
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeSnapshotStrategyAttachedInstances |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
StrategyId | String | 是 | 自动快照id |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
TotalCount | int | 自动快照策略数量 |
Instances | List<Object> | 快照策略关联的主机id列表 |
Instances参数
名称 | 类型 | 描述 |
InstanceId | String | 云服务器Id |
InstanceName | String | 云服务器名称 |
Status | String | 云服务器状态 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeSnapshotStrategyAttachedInstances&Version=2017-12-14
&StrategyId=a6af71c0-fb5b-11e7-b619-3200174de000
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626"
"TotalCount": 2,
"Instances": [
{
"InstanceId": "e37303c5-ad35-4e66-acaa-0d7d687c517f",
"InstanceName": "testvpc9",
"Status": "ACTIVE"
},
{
"InstanceId": "34fc5987-8c58-4967-871f-b5925db7ccef",
"InstanceName": "OpenApiTest1501526552545",
"Status": "ACTIVE"
}
]
}
获取未关联自动快照策略的云主机列表
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeInstancesWithoutSnapshotStrategy |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
TotalCount | int | 自动快照策略数量 |
Instances | List<Object> | 快照策略关联的主机id列表 |
Instances参数
名称 | 类型 | 描述 |
InstanceId | String | 云服务器Id |
InstanceName | String | 云服务器名称 |
Status | String | 云服务器状态 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeInstancesWithoutSnapshotStrategy&Version=2017-12-14
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"TotalCount": 2,
"Instances": [
{
"InstanceId": "e37303c5-ad35-4e66-acaa-0d7d687c517f",
"InstanceName": "testvpc9",
"Status": "ACTIVE"
},
{
"InstanceId": "34fc5987-8c58-4967-871f-b5925db7ccef",
"InstanceName": "OpenApiTest1501526552545",
"Status": "ACTIVE"
}
]
}
获取快照策略关联主机配额
接口方法: GET
url参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 固定值:DescribeSnapshotStrategyMapQuota |
Version | String | 是 | API版本号 当前版本 2017-12-14 |
StrategyId | String | 是 | 快照策略Id |
返回参数
名称 | 类型 | 描述 |
Code | String | 仅返回http status code非200时有效 指示错误类型 |
Message | String | 仅返回http status code非200时有效 指示详细错误信息 |
RequestId | String | 请求Id |
StrategyMapQuota | int | 当前配额 |
StrategyMapUsage | int | 已使用配额 |
请求示例
https://open.cn-east-1.163yun.com/nvm?Action=DescribeSnapshotStrategyMapQuota&Version=2017-12-14&StrategyId=8259ea90-43d4-43bf-9664-ac4eb1e799d4
返回示例
{
"RequestId": "d2025d02-7922-11e8-a014-f48e3886a626",
"StrategyMapQuota": 20,
"StrategyMapUsage": 1
}