创建实例询价
最近更新时间：2018-08-17 17:02:28
1. 接口描述
接口请求域名： cvm.tencentcloudapi.com 。
本接口(InquiryPriceRunInstances)用于创建实例询价。本接口仅允许针对购买限制范围内的实例配置进行询价, 详见：创建实例。
接口请求频率限制：10次/每秒。
注意：本接口支持金融区地域。由于金融区和非金融区是隔离不互通的，因此当公共参数 Region 为金融区地域（例如 ap-shanghai-fsi ）时，需要同时指定带金融区地域的域名，最好和 Region 的地域保持一致，例如：cvm.ap-shanghai-fsi.tencentcloudapi.com 。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：InquiryPriceRunInstances |
| Version | 是 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | String | 公共参数，详见产品支持的地域列表。 |
| Placement | 是 | Placement | 实例所在的位置。通过该参数可以指定实例所属可用区，所属项目等属性。 |
| ImageId | 是 | String | 指定有效的镜像ID，格式形如img-xxx。镜像类型分为四种：可通过以下方式获取可用的镜像ID： 公共镜像、自定义镜像、共享镜像的镜像ID可通过登录控制台查询；服务镜像市场的镜像ID可通过云市场查询。ImageId字段。 |
| InstanceChargeType | 否 | String | 实例计费类型。 默认值：POSTPAID_BY_HOUR。 |
| InstanceChargePrepaid | 否 | InstanceChargePrepaid | 预付费模式，即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 |
| InstanceType | 否 | String | 实例机型。不同实例机型指定了不同的资源规格，具体取值可通过调用接口DescribeInstanceTypeConfigs来获得最新的规格表或参见CVM实例配置描述。若不指定该参数，则默认机型为S1.SMALL1。 |
| SystemDisk | 否 | SystemDisk | 实例系统盘配置信息。若不指定该参数，则按照系统默认值进行分配。 |
| DataDisks.N | 否 | Array of DataDisk | 实例数据盘配置信息。若不指定该参数，则默认不购买数据盘，当前仅支持购买的时候指定一个数据盘。 |
| VirtualPrivateCloud | 否 | VirtualPrivateCloud | 私有网络相关信息配置。通过该参数可以指定私有网络的ID，子网ID等信息。若不指定该参数，则默认使用基础网络。若在此参数中指定了私有网络ip，那么InstanceCount参数只能为1。 |
| InternetAccessible | 否 | InternetAccessible | 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 |
| InstanceCount | 否 | Integer | 购买实例数量。取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见CVM实例购买限制。 |
| InstanceName | 否 | String | 实例显示名称。{R:x}，表示生成数字[x, x+n-1]，其中n表示购买实例的数量，例如server_{R:3}，购买1台时，实例显示名称为server_3；购买2台时，实例显示名称分别为server_3，server_4。支持指定多个模式串{R:x}。1、2...n，其中n表示购买实例的数量，例如server_，购买2台时，实例显示名称分别为server_1，server_2。 |
| LoginSettings | 否 | LoginSettings | 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 |
| SecurityGroupIds.N | 否 | Array of String | 实例所属安全组。该参数可以通过调用 DescribeSecurityGroups 的返回值中的sgId字段来获取。若不指定该参数，则默认不绑定安全组。 |
| EnhancedService | 否 | EnhancedService | 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 |
| ClientToken | 否 | String | 用于保证请求幂等性的字符串。该字符串由客户生成，需保证不同请求之间唯一，最大值不超过64个ASCII字符。若不指定该参数，则无法保证请求的幂等性。 更多详细信息请参阅：如何保证幂等性。 |
| HostName | 否 | String | 云服务器的主机名。 |
| TagSpecification.N | 否 | Array of TagSpecification | 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例，当前仅支持绑定标签到云主机实例。 |
| InstanceMarketOptions | 否 | InstanceMarketOptionsRequest | 实例的市场相关选项，如竞价实例相关参数 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Price | Price | 该参数表示对应配置实例的价格。 |
| RequestId | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| AccountQualificationRestrictions | 该请求账户未通过资格审计。 |
| InstancesQuotaLimitExceeded | 表示当前创建的实例个数超过了该账户允许购买的剩余配额数。 |
| InvalidClientToken.TooLong | 指定的ClientToken字符串长度超出限制，必须小于等于64字节。 |
| InvalidHostId.NotFound | 指定的HostId不存在，或不属于该请求账号所有。 |
| InvalidInstanceName.TooLong | 指定的InstanceName字符串长度超出限制，必须小于等于60字节。 |
| InvalidInstanceType.Malformed | 指定InstanceType参数格式不合法。 |
| InvalidParameterCombination | 表示参数组合不正确。 |
| InvalidParameterValue | 无效参数值。参数值格式错误或者参数值不被支持等。 |
| InvalidParameterValue.Range | 无效参数值。参数值取值范围不合法。 |
| InvalidPassword | 无效密码。指定的密码不符合密码复杂度限制。例如密码长度不符合限制等。 |
| InvalidPeriod | 无效时长。目前只支持时长：[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36]，单位：月。 |
| InvalidPermission | 账户不支持该操作。 |
| InvalidZone.MismatchRegion | 指定的zone不存在。 |
| MissingParameter | 参数缺失。请求没有带必选参数。 |
5. 示例
示例1 最简单参数的购买询价
输入示例
https://cvm.tencentcloudapi.com/?Action=InquiryPriceRunInstances
&Placement.Zone=ap-guangzhou-2
&ImageId=img-pmqg1cw8
&<公共请求参数>输出示例
{
"Response": {
"Price": {
"InstancePrice": {
"ChargeUnit": "HOUR",
"UnitPrice": "0.34"
}
},
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}示例2 包年包月实例购买询价
输入示例
https://cvm.tencentcloudapi.com/?Action=InquiryPriceRunInstances
&Placement.Zone=ap-guangzhou-2
&InstanceChargeType=PREPAID
&InstanceChargePrepaid.Period=1
&InstanceChargePrepaid.RenewFlag=NOTIFY_AND_AUTO_RENEW
&ImageId=img-pmqg1cw7
&InstanceType=S1.SMALL1
&SystemDisk.DiskType=LOCAL_BASIC
&SystemDisk.DiskSize=50
&DataDisks.0.DiskType=LOCAL_BASIC
&DataDisks.0.DiskSize=100
&InternetAccessible.InternetChargeType=TRAFFIC_POSTPAID_BY_HOUR
&InternetAccessible.InternetMaxBandwidthOut=10
&InternetAccessible.PublicIpAssigned=TRUE
&InstanceName=QCLOUD-TEST
&LoginSettings.Password=Qcloud@TestApi123++
&EnhancedService.SecurityService.Enabled=TRUE
&EnhancedService.MonitorService.Enabled=TRUE
&InstanceCount=1
&<公共请求参数>输出示例
{
"Response": {
"Price": {
"BandwidthPrice": {
"ChargeUnit": "GB",
"UnitPrice": "0.80"
},
"InstancePrice": {
"DiscountPrice": "45.00",
"OriginalPrice": "45.00"
}
},
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}示例3 按小时后付费实例购买询价
输入示例
https://cvm.tencentcloudapi.com/?Action=InquiryPriceRunInstances
&Placement.Zone=ap-guangzhou-2
&InstanceChargeType=POSTPAID_BY_HOUR
&ImageId=img-pmqg1cw7
&InstanceType=S1.SMALL1
&SystemDisk.DiskType=LOCAL_BASIC
&SystemDisk.DiskSize=50
&DataDisks.0.DiskType=LOCAL_BASIC
&DataDisks.0.DiskSize=100
&InternetAccessible.InternetChargeType=TRAFFIC_POSTPAID_BY_HOUR
&InternetAccessible.InternetMaxBandwidthOut=10
&InternetAccessible.PublicIpAssigned=TRUE
&InstanceName=QCLOUD-TEST
&LoginSettings.Password=Qcloud@TestApi123++
&EnhancedService.SecurityService.Enabled=TRUE
&EnhancedService.MonitorService.Enabled=TRUE
&InstanceCount=1
&<公共请求参数>输出示例
{
"Response": {
"Price": {
"BandwidthPrice": {
"ChargeUnit": "GB",
"UnitPrice": "0.80"
},
"InstancePrice": {
"ChargeUnit": "HOUR",
"UnitPrice": "0.34"
}
},
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}6. 其他资源
云 API 3.0 提供了配套的开发工具，能更方便的调用 API 。