# 获取主机价格 - GetUHostInstancePrice

## 简介

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





## 定义

### 公共参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Action**     | string  | 对应的 API 指令名称，当前 API 为 `GetUHostInstancePrice`                        | **Yes** |
| **PublicKey**  | string  | 用户公钥，可从 [控制台](https://console.dezai.com/uaccount/api_manage) 获取                                             | **Yes** |
| **Signature**  | string  | 根据公钥及 API 指令生成的用户签名，参见 [签名算法](/docs/api/summary/signature.md)  | **Yes** |

### 请求参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Region** | string | 地域。 参见 [地域和可用区列表](/docs/api/summary/regionlist) |**Yes**|
| **Zone** | string | 可用区。参见 [可用区列表](/docs/api/summary/regionlist) |No|
| **ProjectId** | string | 项目ID。不填写为默认项目，子帐号必须填写。 请参考[GetProjectList接口](/docs/api/summary/get_project_list) |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 | 是否是系统盘。枚举值：<br /><br /> > True，是系统盘 <br /><br /> > False，是数据盘（默认）。Disks数组中有且只能有一块盘是系统盘。 |**Yes**|
| **Disks.N.Size** | int | 磁盘大小，单位GB。请参考[磁盘类型](api/uhost-api/disk_type)。 |**Yes**|
| **Disks.N.Type** | string | 磁盘类型。请参考[磁盘类型](api/uhost-api/disk_type)。 |**Yes**|
| **Disks.N.BackupType** | string | 磁盘备份方案。枚举值：<br /><br /> > NONE，无备份 <br /><br /> > DATAARK，数据方舟 <br /><br /> > SNAPSHOT，快照<br /><br /> 当前磁盘支持的备份模式参考 [磁盘类型](api/uhost-api/disk_type) |No|
| **ImageId** | string | 镜像Id，可通过 [DescribeImage](api/uhost-api/describe_image) 获取镜像ID， 如果镜像ID不传，系统盘大小必传 |No|
| **GPU** | int | GPU卡核心数。仅GPU机型支持此字段。 |No|
| **ChargeType** | string | 计费模式。枚举值为： <br /><br /> > Year，按年付费； <br /><br /> > Month，按月付费；<br /><br /> > Dynamic，按小时付费 // >Spot 抢占式实例 <br /><br /> 如果不传某个枚举值，默认返回年付、月付、时付的价格组合集。 |No|
| **NetCapability** | string | 网络增强。枚举值：Normal，不开启; Super，开启网络增强1.0。 默认值为Normal。 |No|
| **UHostType** | string | 【待废弃】云主机机型（V1版本概念）。参考[云主机机型说明](api/uhost-api/uhost_type)。 |No|
| **MachineType** | string | 云主机机型（V2版本概念）。枚举值["N", "C", "G", "O", "OS", "OPRO", "OMAX", "O.BM", "O.EPC"]。参考[云主机机型说明](api/uhost-api/uhost_type)。 |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 平台组成，用于指定云主机的硬件类型与处理器平台。<br />当 MachineType 为 "O"（快杰型）时，支持以下取值： <br />- o1i：快杰型 O1 代，Intel 平台 <br />- o1a：快杰型 O1 代，AMD 平台<br />- o1r：快杰型 O1 代，ARM 平台 <br />- o2i：快杰型 O2 代，Intel 平台 默认值：o1i 或 o1a或o1r<br />当 MachineType 为 "OM"（快杰共享型）时，支持以下取值： <br />- om1i：快杰内存增强型 OM1 代，Intel 平台 <br />- om2i：快杰内存增强型 OM2 代，Intel 平台<br />注意：规格族必须与 MachineType 匹配，否则请求将被拒绝。 |No|

### 响应字段

| 字段名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **RetCode** | int | 返回状态码，为 0 则为成功返回，非 0 为失败 |**Yes**|
| **Action** | string | 操作指令名称 |**Yes**|
| **Message** | string | 返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息 |No|
| **PriceSet** | array[[*UHostPriceSet*](#UHostPriceSet)] | 价格列表 UHostPriceSet |No|

#### 数据模型


#### UHostPriceSet

| 字段名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **ChargeType** | string | 计费类型。Year，Month，Dynamic |**Yes**|
| **Price** | float | 价格，单位: 元，保留小数点后两位有效数字 |**Yes**|
| **OriginalPrice** | float | 限时优惠的折前原价。 |**Yes**|
| **PriceDetail** | [*PriceDetail*](#PriceDetail) | 价格详细信息（只有询价接口返回）。 |No|
| **OriginalPriceDetail** | [*PriceDetail*](#PriceDetail) | 原价详细信息（只有询价接口返回）。 |No|

#### PriceDetail

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

## 示例

### 请求示例
    
```
https://api.dezai.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
```

### 响应示例
    
```json
{
  "Action": "GetUHostInstancePriceResponse",
  "PriceSet": [
    {
      "ChargeType": "Dynamic",
      "Price": 0.42
    }
  ],
  "RetCode": 0
}
```