创建实例询价
最近更新时间:2019-01-11 16:56:43
在这篇文章中:
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 | 实例数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定11块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含10块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 |
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. 示例
示例1 最简单参数的购买询价
只传必传的Zone和镜像ID,其他均采用系统默认值,具体配置如下:实例所在位置为广州二区,镜像ID为:img-pmqg1cw7。
输入示例
https://cvm.tencentcloudapi.com/?Action=InquiryPriceRunInstances
&Placement.Zone=ap-guangzhou-2
&ImageId=img-pmqg1cw8
&<公共请求参数>
输出示例
{
"Response": {
"Price": {
"InstancePrice": {
"UnitPrice": "0.34",
"ChargeUnit": "HOUR"
}
},
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}
示例2 包年包月实例购买询价
实例所在位置为广州二区,付费模式为包年包月,购买一个月,到期自动续费,镜像ID为:img-pmqg1cw7,选择机型为:1C1G标准型(S1.SMALL1),50G大小本地普通系统盘,带100G大小本地普通数据盘,基础网络,公网付费模式为流量按小时后付费,外网带宽上限10Mbps,分配公网IP,实例命名为QCLOUD-TEST,设置登录密码未Qcloud@TestApi123++,安装云监控云安全,购买数量为1台。
输入示例
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": {
"InstancePrice": {
"OriginalPrice": "45.00",
"DiscountPrice": "45.00"
},
"BandwidthPrice": {
"UnitPrice": "0.80",
"ChargeUnit": "GB"
}
},
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}
示例3 按小时后付费实例购买询价
实例所在位置为广州二区,付费模式为按小时后付费,镜像ID为:img-pmqg1cw7,选择机型为:1C1G标准型(S1.SMALL1),50G大小本地普通系统盘,带100G大小本地普通数据盘,基础网络,公网付费模式为流量按小时后付费,外网带宽上限10Mbps,分配公网IP,实例命名为QCLOUD-TEST,设置登录密码未Qcloud@TestApi123++,安装云监控云安全,购买数量为1台。
输入示例
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": {
"InstancePrice": {
"UnitPrice": "0.34",
"ChargeUnit": "HOUR"
},
"BandwidthPrice": {
"UnitPrice": "0.80",
"ChargeUnit": "GB"
}
},
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}
5. 开发者资源
API Explorer
该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python
- Tencent Cloud SDK 3.0 for Java
- Tencent Cloud SDK 3.0 for PHP
- Tencent Cloud SDK 3.0 for Go
- Tencent Cloud SDK 3.0 for NodeJS
- Tencent Cloud SDK 3.0 for .NET
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
错误码 | 描述 |
---|---|
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 | 参数缺失。请求没有带必选参数。 |
如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >