获取主机价格-GetUHostInstancePrice

根据UHost实例配置,获取UHost实例的价格。

Request Parameters

Parameter nameTypeDescriptionRequired
Regionstring地域。 参见 地域和可用区列表Yes
Zonestring可用区。参见 可用区列表No
ProjectIdstring项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口No
ImageIdstring镜像Id,可通过 DescribeImage 获取镜像IDYes
CPUintCPU核数。可选参数:1-64。可选范围参照控制台。默认值: 4Yes
Memoryint内存大小。单位:MB。范围 :[1024, 262144],取值为1024的倍数(可选范围参照好控制台)。默认值:8192Yes
Countint购买台数,范围[1,5]Yes
Disks.N.IsBootstring是否是系统盘。枚举值:
> True,是系统盘
> False,是数据盘(默认)。Disks数组中有且只能有一块盘是系统盘。
Yes
Disks.N.Sizeint磁盘大小,单位GB。请参考磁盘类型Yes
Disks.N.Typestring磁盘类型。请参考磁盘类型Yes
GPUintGPU卡核心数。仅GPU机型支持此字段。No
ChargeTypestring计费模式。枚举值为:
> Year,按年付费;
> Month,按月付费;
> Dynamic,按小时付费
默认为月付。
No
NetCapabilitystring网络增强。枚举值:Normal,不开启; Super,开启网络增强1.0。 默认值为Normal。No
UHostTypestring【待废弃】云主机机型(V1版本概念)。参考云主机机型说明No
MachineTypestring云主机机型(V2版本概念)。枚举值["N", "C", "G", "O"]。参考云主机机型说明No
GpuTypestringGPU类型,枚举值["K80", "P40", "V100"]No
Disks.N.BackupTypestring磁盘备份方案。枚举值:
> NONE,无备份
> DATAARK,数据方舟
当前磁盘支持的备份模式参考 磁盘类型
No
Quantityint购买时长。默认: 1。按小时购买(Dynamic)时无需此参数。 月付时,此参数传0,代表了购买至月末。No

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint操作返回码Yes
Actionstring操作名称Yes
PriceSetarray价格列表 UHostPriceSetNo

UHostPriceSet

Parameter nameTypeDescriptionRequired
ChargeTypestring计费类型。Year,Month,DynamicYes
Pricefloat价格,单位: 元,保留小数点后两位有效数字Yes

Request Example

https://api.ucloud.cn/?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

Response Example

{
    "RetCode": 0,
    "Action": "GetUHostInstancePriceResponse",
    "PriceSet": [
        {
            "ChargeType": "Dynamic",
            "Price": 0.42
        }
    ]
}