获取主机价格 - 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，按小时付费 // >Spot 抢占式实例如果不传某个枚举值，默认返回年付、月付、时付的价格组合集。	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”,“T4A”, “T4S”,“2080Ti”,“2080Ti-4C”,“1080Ti”, “T4/4”, “MI100”, “V100S”,2080”,“2080TiS”,“2080TiPro”,“3090”,“4090”,“4090Pro”,“A100”,“A800”]	No
Quantity	int	购买时长。默认: 1。按小时购买(Dynamic)时无需此参数。月付时，此参数传0，代表了购买至月末。	No
CpuPlatform	string	取值”Intel” “Amd”，默认值“Intel”	No
UDSetUHostInstance	boolean	专区云主机。如果要在专区宿主机上创建云主机，该参数可以填写为true	No
ShowPriceDetails	boolean	返回价格详细信息	No
UHostFamily	string	规格族。由机型代号和 CPU 平台组成，用于指定云主机的硬件类型与处理器平台。当 MachineType 为 “O”（快杰型）时，支持以下取值： - o1i：快杰型 O1 代，Intel 平台 - o1a：快杰型 O1 代，AMD 平台 - o1r：快杰型 O1 代，ARM 平台 - o2i：快杰型 O2 代，Intel 平台默认值：o1i 或 o1a或o1r（系统将根据资源情况自动选择）当 MachineType 为 “OM”（快杰共享型）时，支持以下取值： - om1i：快杰内存增强型 OM1 代，Intel 平台 - om2i：快杰内存增强型 OM2 代，Intel 平台注意：规格族必须与 MachineType 匹配，否则请求将被拒绝。	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
PriceDetail	PriceDetail	价格详细信息（只有询价接口返回）。	No
OriginalPriceDetail	PriceDetail	原价详细信息（只有询价接口返回）。	No

PriceDetail

字段名	类型	描述信息	必填
UHost	float	主机价格	No
UDisk	float	云盘价格	No
Snapshot	float	快照价格	No
Volume	float	数据卷价格	No

示例

请求示例


https://api.ziguang.unicloud.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
&UHostFamily=cFaXhzxa

响应示例


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