配额和快照接口

获取实例配额

接口方法: GET

url参数

名称类型是否必须描述
ActionString固定值:DescribeInstanceQuota
VersionStringAPI版本号 当前版本 2017-12-14

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
InstanceQuotaint当前租户实例配额
InstanceUsageint已使用的实例配额

请求示例

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参数

名称类型是否必须描述
ActionString固定值:DescribeSnapshotQuota
VersionStringAPI版本号 当前版本 2017-12-14
InstanceIdString要获取配额信息的云服务器uuid

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
AutoSnapshotQuotaint当前自动快照配额
AutoSnapshotUsageint已使用的自动快照配额
ManualSnapshotQuotaint当前手动快照配额
ManualSnapshotUsageint已使用的手动快照配额

请求示例

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参数

名称类型是否必须描述
ActionString固定值:CreateSnapshot
VersionStringAPI版本号 当前版本 2017-12-14
InstanceIdString要创建快照的云服务器uuid
NameString快照名称 3-63字符,数字或者中划线组成,以字母开头
DescriptionString描述信息 base64格式 编码后一百字符以内

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
SnapshotIdString快照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参数

名称类型是否必须描述
ActionString固定值:DescribeSnapshots
VersionStringAPI版本号 当前版本 2017-12-14
InstanceIdString云服务器uuid

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
TotalCountint快照总数
SnapshotsList<Object>快照列表

Snapshots参数

名称类型描述
SnapshotIdString快照id
SnapshotNameString快照名称
InstanceIdString快照所属云服务器
TypeString快照类型
StatusString快照状态
DescriptionString快照描述
CreateAtString快照创建时间

请求示例

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参数

名称类型是否必须描述
ActionString固定值:DeleteSnapshot
VersionStringAPI版本号 当前版本 2017-12-14
SnapshotIdString快照id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求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参数

名称类型是否必须描述
ActionString固定值:CreateImageFromSnapshot
VersionStringAPI版本号 当前版本 2017-12-14
SnapshotIdString快照id
ImageNameString镜像名称 3-32字符,数字或者中划线组成,以字母开头
ImageDescriptionString镜像描述信息 base64格式 编码后一百字符以内

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
ImageIdString镜像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参数

名称类型是否必须描述
ActionString固定值:RevertFromSnapshot
VersionStringAPI版本号 当前版本 2017-12-14
SnapshotIdString快照id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求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参数

名称类型是否必须描述
ActionString固定值:CreateSnapshotStrategy
VersionStringAPI版本号 当前版本 2017-12-14
NameString快照策略名称 3-32字符,数字或者中划线组成,以字母开头
StrategyPatternStringcrontab格式 表示快照周期 base64格式编码

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
StrategyIdString快照策略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参数

名称类型是否必须描述
ActionString固定值:ModifySnapshotStrategy
VersionStringAPI版本号 当前版本 2017-12-14
StrategyIdString快照策略Id
StrategyPatternStringcrontab格式 表示快照周期 base64格式编码

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求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参数

名称类型是否必须描述
ActionString固定值:DeleteSnapshotStrategy
VersionStringAPI版本号 当前版本 2017-12-14
StrategyIdString快照策略Id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求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参数

名称类型是否必须描述
ActionString固定值:ApplySnapshotStrategy
VersionStringAPI版本号 当前版本 2017-12-14
InstanceIdString云服务器uuid
StrategyIdString自动快照id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求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参数

名称类型是否必须描述
ActionString固定值:CancelSnapshotStrategy
VersionStringAPI版本号 当前版本 2017-12-14
InstanceIdString云服务器uuid
StrategyIdString自动快照id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求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参数

名称类型是否必须描述
ActionString固定值:DescribeSnapshotStrategies
VersionStringAPI版本号 当前版本 2017-12-14
Limitint查询结果每页结果数量 默认20
Offsetint查询结果起始序号 默认0

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
TotalCountint自动快照策略数量
SnapshotStrategiesList<Object>自动快照策略列表

SnapshotStrategies参数

名称类型描述
StrategyNameString快照策略名称
StrategyIdString快照策略Id
StrategyPatternString快照策略内容
StrategyMappingCountString快照策略关联的云服务器数量

请求示例

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参数

名称类型是否必须描述
ActionString固定值:DescribeSnapshotStrategyAttachedInstances
VersionStringAPI版本号 当前版本 2017-12-14
StrategyIdString自动快照id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
TotalCountint自动快照策略数量
InstancesList<Object>快照策略关联的主机id列表

Instances参数

名称类型描述
InstanceIdString云服务器Id
InstanceNameString云服务器名称
StatusString云服务器状态

请求示例

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参数

名称类型是否必须描述
ActionString固定值:DescribeInstancesWithoutSnapshotStrategy
VersionStringAPI版本号 当前版本 2017-12-14

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
TotalCountint自动快照策略数量
InstancesList<Object>快照策略关联的主机id列表

Instances参数

名称类型描述
InstanceIdString云服务器Id
InstanceNameString云服务器名称
StatusString云服务器状态

请求示例

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参数

名称类型是否必须描述
ActionString固定值:DescribeSnapshotStrategyMapQuota
VersionStringAPI版本号 当前版本 2017-12-14
StrategyIdString快照策略Id

返回参数

名称类型描述
CodeString仅返回http status code非200时有效 指示错误类型
MessageString仅返回http status code非200时有效 指示详细错误信息
RequestIdString请求Id
StrategyMapQuotaint当前配额
StrategyMapUsageint已使用配额

请求示例

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
}