创建实例询价
最近更新时间: 2024-10-18 10:38:39
1. 接口描述
接口请求域名： cvm.api3.fincloud.tencent.cn。
本接口(InquiryPriceRunInstances)用于创建实例询价。本接口仅允许针对购买限制范围内的实例配置进行询价, 详见: RunInstances。
默认接口请求频率限制：10次/秒。
接口更新时间：2022-10-27 11:28:18。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：InquiryPriceRunInstances |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| InstanceChargeType | 否 | 否 | String | 实例计费类型。<br><li>PREPAID：预付费，即包年包月<br><li>POSTPAID_BY_HOUR：按小时后付费<br>默认值：POSTPAID_BY_HOUR。 |
| InstanceChargePrepaid | 否 | 否 | InstanceChargePrepaid | 预付费模式，即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 |
| Placement | 是 | 否 | Placement | 实例所在的位置。通过该参数可以指定实例所属可用区，所属项目等属性。 |
| InstanceType | 否 | 否 | String | 实例机型。不同实例机型指定了不同的资源规格，具体取值可通过调用接口DescribeInstanceTypeConfigs来获得最新的规格表。若不指定该参数，则默认机型为S1.SMALL1。 |
| ImageId | 是 | 否 | String | 指定有效的镜像ID，格式形如img-xxx。镜像类型分为四种：<br/><li>公共镜像</li><li>自定义镜像</li><li>共享镜像</li><li>服务市场镜像</li><br/>可通过以下方式获取可用的镜像ID：<br/><li>公共镜像、自定义镜像、共享镜像的镜像ID可通过登录控制台查询。 |
| SystemDisk | 否 | 否 | SystemDisk | 实例系统盘配置信息。若不指定该参数，则按照系统默认值进行分配。 |
| DataDisks | 否 | 否 | Array of DataDisk | 实例数据盘配置信息。若不指定该参数，则默认不购买数据盘，购买时可指定多个数据盘。 |
| VirtualPrivateCloud | 否 | 否 | VirtualPrivateCloud | 私有网络相关信息配置。通过该参数可以指定私有网络的ID，子网ID等信息。若不指定该参数，则默认使用基础网络。若在此参数中指定了私有网络ip，那么InstanceCount参数只能为1。 |
| InternetAccessible | 否 | 否 | InternetAccessible | 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 |
| InstanceCount | 否 | 否 | Int64 | 购买实例数量。取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量。 |
| InstanceName | 否 | 否 | String | 实例显示名称。如果不指定则默认显示 |
| LoginSettings | 否 | 否 | LoginSettings | 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 |
| SecurityGroupIds | 否 | 否 | Array of String | 实例所属安全组。若不指定该参数，则默认不绑定安全组。 |
| EnhancedService | 否 | 否 | EnhancedService | 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 |
| ClientToken | 否 | 否 | String | 用于保证请求幂等性的字符串。该字符串由客户生成，需保证不同请求之间唯一，最大值不超过64个ASCII字符。若不指定该参数，则无法保证请求的幂等性。<br>更多详细信息请参阅：如何保证幂等性。 |
| PurchaseSource | 否 | 否 | String | 此参数对外不可见。 内部参数，购买来源。前端调用的来源是MC |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Price | Price | 此参数对外不可见。 该参数表示对应配置实例的价格。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue | |
| AccountQualificationRestrictions | |
| InvalidParameterValue.Range | |
| InvalidInstanceName.TooLong | |
| InvalidParameterCombination | |
| InvalidInstanceType.Malformed | |
| InvalidHostId.NotFound | |
| InvalidPeriod | |
| InstancesQuotaLimitExceeded | |
| InvalidZone.MismatchRegion | |
| InvalidClientToken.TooLong | |
| MissingParameter | |
| InvalidPassword | |
| InvalidPermission |