创建实例
最近更新时间: 2025-01-20 17:15:19
1. 接口描述
接口请求域名： bms.api3.fincloud.tencent.cn。
本接口 (RunInstances) 用于创建一个或多个指定配置的实例。
默认接口请求频率限制：10次/秒。
接口更新时间：2023-09-07 15:44:11。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：RunInstances |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-08-13 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| HostName | 否 | 否 | String | 云服务器的主机名。<br><li>点号（.）和短横线（-）不能作为 HostName 的首尾字符，不能连续使用。<br><li>Windows 实例：名字符长度为[2, 15]，允许字母（不限制大小写）、数字和短横线（-）组成，不支持点号（.），不能全是数字。<br><li>其他类型（Linux 等）实例：字符长度为[2, 30]，允许支持多个点号，点之间为一段，每段允许字母（不限制大小写）、数字和短横线（-）组成。 |
| Placement | 是 | 否 | Placement | 实例所在的位置。通过该参数可以指定实例所属可用区，所属项目。 |
| FlavorId | 是 | 否 | String | 套餐ID。 |
| OperatingSystemType | 是 | 否 | String | 系统类型，支持Linux/Windows。 |
| OperatingSystem | 是 | 否 | String | 系统的发行版本号。 |
| VirtualPrivateCloud | 是 | 否 | VirtualPrivateCloud | 私有网络相关信息配置。通过该参数可以指定私有网络的ID，子网ID等信息。若在此参数中指定了私有网络ip，InstanceCount参数必须与私有网络ip的个数一致。 |
| InternetAccessible | 否 | 否 | InternetAccessible | 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 |
| InstanceCount | 否 | 否 | Int64 | 实例数量。 |
| InstanceName | 否 | 否 | String | 实例显示名称。 |
| LoginSettings | 是 | 否 | LoginSettings | 实例登录设置，通过该参数可以设置实例的登录方式密码。 |
| EnhancedService | 否 | 否 | EnhancedService | 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 |
| RaidType | 是 | 否 | String | RAID类型 |
| Tags | 否 | 否 | Array of Tag | 绑定标签参数 |
| GroupId | 否 | 否 | String | 分散置放群组ID列表，可通过[DescribeDisasterRecoverGroups]接口获取。 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | 此参数对外不可见。 返回改任务的taskid,可通过taskid查询任务运行情况 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。