获取主机规格调整差价 - GetUHostUpgradePrice
简介
获取UHost实例升级配置的价格。可选配置范围请参考云主机机型说明。
💡 若需查询调整磁盘大小的价格,请调用GetAttachedDiskUpgradePrice。
定义
公共参数
参数名 | 类型 | 描述信息 | 必填 |
---|---|---|---|
Action | string | 对应的 API 指令名称,当前 API 为 GetUHostUpgradePrice | Yes |
PublicKey | string | 用户公钥,可从 控制台 获取 | Yes |
Signature | string | 根据公钥及 API 指令生成的用户签名,参见 签名算法 | Yes |
请求参数
参数名 | 类型 | 描述信息 | 必填 |
---|---|---|---|
Region | string | 地域。 参见 地域和可用区列表 | Yes |
Zone | string | 可用区。参见 可用区列表 | No |
ProjectId | string | 项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口 | No |
UHostId | string | UHost实例ID。 参见 DescribeUHostInstance。 | Yes |
CPU | int | 虚拟CPU核数。可选参数:1-64(可选范围参考控制台)。默认值为当前实例的CPU核数。 | No |
Memory | int | 内存大小。单位:MB。范围 :[1024, 262144],取值为1024的倍数(可选范围参考控制台)。默认值为当前实例的内存大小。 | No |
GPU | int | GPU卡核心数。仅GPU机型支持此字段(可选范围与MachineType+GpuType相关) | No |
NetCapValue | int | 网卡升降级(1,表示升级,2表示降级,0表示不变)。仅支持网络增强1.0和网络增强2.0的开启和关闭,不支持网络增强特性互相转换,如网络增强1.0升级到网络增强2.0是不被支持的。 | No |
响应字段
字段名 | 类型 | 描述信息 | 必填 |
---|---|---|---|
RetCode | int | 返回状态码,为 0 则为成功返回,非 0 为失败 | Yes |
Action | string | 操作指令名称 | Yes |
Message | string | 返回错误消息,当 RetCode 非 0 时提供详细的描述信息 | No |
Price | float | 规格调整差价。精确到小数点后2位。 | No |
OriginalPrice | float | 限时优惠的折前原价 | No |
示例
请求示例
https://api.an-link.com/?Action=GetUHostUpgradePrice
&Region=cn-bj2
&Zone=cn-bj2-04
&ProjectId=org-xxx
&UHostId=uhost-xxx
&CPU=4
&GPU=3
&GPU=8
响应示例
{
"Action": "GetUHostUpgradePriceResponse",
"OriginalPrice": 5.21987,
"Price": 19.96,
"RetCode": 0
}