获取主机价格 - GetUHostInstancePrice
简介
根据UHost实例配置，获取UHost实例的价格。
定义
公共参数
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| Action | string | 对应的 API 指令名称，当前 API 为 GetUHostInstancePrice | Yes |
| PublicKey | string | 用户公钥，可从 控制台 获取 | Yes |
| Signature | string | 根据公钥及 API 指令生成的用户签名，参见 签名算法 | Yes |
请求参数
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| Region | string | 地域。 参见 地域和可用区列表 | Yes |
| Zone | string | 可用区。参见 可用区列表 | No |
| ProjectId | string | 项目ID。不填写为默认项目，子帐号必须填写。 请参考GetProjectList接口 | No |
| CPU | int | CPU核数。可选参数：1-64。可选范围参照控制台。默认值: 4 | Yes |
| Memory | int | 内存大小。单位：MB。范围 ：[1024, 262144]，取值为1024的倍数（可选范围参照好控制台）。默认值：8192 | Yes |
| Count | int | 购买台数，范围[1,5] | Yes |
| Disks.N.IsBoot | string | 是否是系统盘。枚举值： > True，是系统盘 > False，是数据盘（默认）。Disks数组中有且只能有一块盘是系统盘。 | Yes |
| Disks.N.Size | int | 磁盘大小，单位GB。请参考磁盘类型。 | Yes |
| Disks.N.Type | string | 磁盘类型。请参考磁盘类型。 | Yes |
| Disks.N.BackupType | string | 磁盘备份方案。枚举值： > NONE，无备份 > DATAARK，数据方舟 > SNAPSHOT，快照 当前磁盘支持的备份模式参考 磁盘类型 | No |
| ImageId | string | 镜像Id，可通过 DescribeImage 获取镜像ID， 如果镜像ID不传，系统盘大小必传 | No |
| GPU | int | GPU卡核心数。仅GPU机型支持此字段。 | No |
| ChargeType | string | 计费模式。枚举值为： > Year，按年付费； > Month，按月付费； > Dynamic，按小时付费 // >Preemptive 抢占式实例 如果不传某个枚举值，默认返回年付、月付、时付的价格组合集。 | No |
| NetCapability | string | 网络增强。枚举值：Normal，不开启; Super，开启网络增强1.0。 默认值为Normal。 | No |
| UHostType | string | 【待废弃】云主机机型（V1版本概念）。参考云主机机型说明。 | No |
| MachineType | string | 云主机机型（V2版本概念）。枚举值[“N”, “C”, “G”, “O”, “OS”, “OPRO”, “OMAX”, “O.BM”, “O.EPC”]。参考云主机机型说明。 | No |
| GpuType | string | GPU类型，枚举值[“K80”, “P40”, “V100”, “T4”,“T4S”,“2080Ti”,“2080Ti-4C”,“1080Ti”, “T4/4”,“MI100”,“V100S”] | No |
| Quantity | int | 购买时长。默认: 1。按小时购买(Dynamic)时无需此参数。 月付时，此参数传0，代表了购买至月末。 | No |
| CpuPlatform | string | 取值”Intel” “Amd”，默认值“Intel” | No |
| UDSetUHostInstance | boolean | 专区云主机。如果要在专区宿主机上创建云主机，该参数可以填写为true | No |
| ShowPriceDetails | boolean | 返回价格详细信息 | No |
响应字段
| 字段名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| RetCode | int | 返回状态码，为 0 则为成功返回，非 0 为失败 | Yes |
| Action | string | 操作指令名称 | Yes |
| Message | string | 返回错误消息，当 RetCode 非 0 时提供详细的描述信息 | No |
| PriceSet | array[UHostPriceSet] | 价格列表 UHostPriceSet | No |
数据模型
UHostPriceSet
| 字段名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| ChargeType | string | 计费类型。Year，Month，Dynamic | Yes |
| Price | float | 价格，单位: 元，保留小数点后两位有效数字 | Yes |
| OriginalPrice | float | 限时优惠的折前原价（即列表价乘以商务折扣后的单价）。 | Yes |
| ListPrice | float | 产品列表价。 | No |
| PriceDetail | PriceDetail | 价格详细信息（只有询价接口返回）。 | No |
| OriginalPriceDetail | PriceDetail | 原价详细信息（只有询价接口返回）。 | No |
| ListPriceDetail | PriceDetail | 列表价详细信息（只有询价接口返回）。 | No |
PriceDetail
| 字段名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| UHost | float | 主机价格 | No |
| UDisk | float | 云盘价格 | No |
| Snapshot | float | 快照价格 | No |
| Volume | float | 数据卷价格 | No |
示例
请求示例
https://api.tnqacloud.com/?Action=GetUHostInstancePrice
&Region=cn-bj2
&Zone=cn-bj2-04
&ProjectId=org-xxx
&ImageId=xxx
&MachineType=N
&CPU=2
&Memory=4096
&Count=1
&ChargeType=Dynamic
&Disks.0.Size=40
&Disks.0.IsBoot=True
&Disks.0.Type=CLOUD_SSD
&CpuPlatform=pmuJsysU
&Volumes.N.Type=asluorww
&Volumes.N.Size=3
&Volumes.N.IsBoot=eHeLEeHi
&HpcEnhanced=false
&GpuTyp=pmujj
&GPU=1
&UDSetUHostInstance=true
&ShowPriceDetails=true响应示例
{
"Action": "GetUHostInstancePriceResponse",
"PriceSet": [
{
"ChargeType": "Dynamic",
"Price": 0.42
}
],
"RetCode": 0
}