实例参数转换
最近更新时间: 2024-06-18 14:31:30
1. 接口描述
接口请求域名： cvm.api3.fincloud.tencent.cn。
本接口自2022年4月14日起停止维护。 本接口 (SwitchParameterRunInstances) 用于创建一个或多个指定配置的实例参数转换。
- 实例创建成功后将自动开机启动，实例状态变为“运行中”。
- 预付费实例的购买会预先扣除本次实例购买所需金额，按小时后付费实例购买会预先冻结本次实例购买一小时内所需金额，在调用本接口前请确保账户余额充足。
- 本接口为异步接口，当创建请求下发成功后会返回一个实例
ID列表，此时实例的创建并立即未完成。在此期间实例的状态将会处于“准备中”，可以通过调用 DescribeInstancesStatus 接口查询对应实例的状态，来判断生产有没有最终成功。如果实例的状态由“准备中”变为“运行中”，则为创建成功。
默认接口请求频率限制：10次/秒。
接口更新时间：2022-11-29 15:47:38。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：SwitchParameterRunInstances |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| HostName | 否 | 否 | String | 1 |
| ClientToken | 否 | 否 | String | 1 |
| Placement | 是 | 否 | Placement | 1 |
| InstanceChargePrepaid | 否 | 否 | InstanceChargePrepaid | 1 |
| InstanceChargeType | 否 | 否 | String | 1 |
| InstanceType | 否 | 否 | String | 1 |
| ImageId | 是 | 否 | String | 1 |
| SystemDisk | 否 | 否 | SystemDisk | 1 |
| DataDisks | 否 | 否 | Array of DataDisk | 1 |
| VirtualPrivateCloud | 否 | 否 | VirtualPrivateCloud | 1 |
| InternetAccessible | 否 | 否 | InternetAccessible | 1 |
| InstanceCount | 否 | 否 | Int64 | 1 |
| InstanceName | 否 | 否 | String | 1 |
| LoginSettings | 否 | 否 | LoginSettings | 1 |
| SecurityGroupIds | 否 | 否 | Array of String | 1 |
| EnhancedService | 否 | 否 | EnhancedService | 1 |
| DryRun | 否 | 否 | Bool | 1 |
| UserData | 否 | 否 | String | 1 |
| AvailableZone | 否 | 否 | String | 1 |
| PurchaseSource | 否 | 否 | String | 1 |
| DisasterRecoverGroupIds | 否 | 否 | Array of String | 1 |
| DesAction | 否 | 否 | String | 1 |
| ActionTimer | 否 | 否 | ActionTimer | 1 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InstanceOrder | InstanceOrder | 此参数对外不可见。 实例订单详情信息。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue | |
| AccountQualificationRestrictions | |
| InvalidParameterValue.Range | |
| InvalidInstanceName.TooLong | |
| InvalidParameterCombination | |
| InvalidInstanceType.Malformed | |
| InvalidHostId.NotFound | |
| InvalidPeriod | |
| InstancesQuotaLimitExceeded | |
| InvalidZone.MismatchRegion | |
| InvalidClientToken.TooLong | |
| MissingParameter | |
| InvalidPassword | |
| VpcIpIsUsed | |
| VpcAddrNotInSubNet | |
| InvalidPermission |