调用RunInstances创建一台或多台按量付费或者包年包月ENS实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceType | string | 是 | 实例规格。 | ens.sn1.small |
InstanceChargeType | string | 是 | 实例付费方式。取值:
| PostPaid |
ImageId | string | 否 | 镜像 ID。arm 版卡不能填,其他类型规格必填。 | m-5si16wo6simkt267p8b7h**** |
NetDistrictCode | string | 否 | 地区 Code。 说明
区域级调度时必填,节点级调度时无效。
| 350000 |
Carrier | string | 否 | 运营商。 说明
区域级调度时必填,节点级调度时无效。
| telecom |
ScheduleAreaLevel | string | 是 | 调度层级。通过该字段来执行节点级调度或者区域调度。取值:
| Region |
SchedulingStrategy | string | 否 | 调度策略。取值:
说明
节点级调度时,为 Concentrate;区域级调度时,按客户需求选择。
| Concentrate |
EnsRegionId | string | 否 | 节点 ID。 说明
节点级调度时必填,区域级调度时无效。
| cn-foshan-telecom |
Password | string | 否 | 实例密码。 说明
Password、KeyPairName、PasswordInherit 至少填入一个。
| testPassword |
KeyPairName | string | 否 | 密钥对名称。 说明
Password、KeyPairName、PasswordInherit 至少填入一个。
| wx2-jumpserver |
InternetChargeType | string | 否 | 带宽计费方式。取值:
说明
如果是第一次新购时可以进行选择计费方式,后续此字段值会根据第一次所选择的计费方式进行默认处理。
| BandwidthByDay |
SystemDisk | object | 否 | 系统盘规格。 | |
Size | long | 否 | 系统盘大小,单位:GiB。 | 50 |
Category | string | 否 | 系统盘类型。 | local_ssd |
DataDisk | object [] | 否 | 数据盘规格。 | |
Size | long | 否 | 数据盘大小,单位:GiB。 | 20 |
Category | string | 否 | 磁盘种类。取值:
| cloud_efficiency |
Encrypted | boolean | 否 | 是否加密云盘。取值范围:
| false |
KMSKeyId | string | 否 | 云盘使用的 KMS 密钥 ID。取值范围:
说明
如果 Encrypted 置为 true,KMSKeyId 为空时则使用服务默认密钥。
| false |
Period | long | 否 | 购买资源的时长。
| 1-9,12 |
InternetMaxBandwidthOut | long | 是 | 公网最大带宽,如果本参数的值大于 0,则自动为实例分配公网 IP。 | 1 |
Amount | long | 是 | 创建的实例数量。取值范围:1~100。 | 1 |
NetWorkId | string | 否 | 网络 ID。 说明
只能在节点级调度使用,区域级调度时配置该参数会报错。
| net-id |
VSwitchId | string | 否 | 交换机 ID。 说明
只能在节点级调度使用,区域级调度时配置该参数会报错。
| vsw-5sagnw7m613oulalkd10n**** |
SecurityId | string | 否 | 安全组 ID。 | sg-test |
HostName | string | 否 | 主机名称。 | test-HostName |
InstanceName | string | 否 | 实例名称。长度为 2~128 个字符,必须以大小字母或中文开头,不能以 默认值为实例的 InstanceId。 | TestName |
UniqueSuffix | boolean | 否 | 是否为 HostName 和 InstanceName 添加有序后缀,有序后缀从 001 开始递增,最大不能超过 999。 | True |
UserData | string | 否 | 用户自定义数据,最大支持 16 KB。您可传入 UserData 信息,UserData 以 Base64 的方式编码。 | ZWtest |
AutoRenew | boolean | 否 | 是否自动续费。取值:
说明
按量付费时,该参数无效。
| true |
SchedulingPriceStrategy | string | 否 | 调度价格策略。取值:
| PriceHighPriority |
PrivateIpAddress | string | 否 | 私网 IP 地址。 说明
只能在节点级调度使用,区域级调度时配置该参数会报错。
如果指定了私网 IP,实例数量只能为 1 台,且私网 IP 和交换机 ID 同时非空时,该私网 IP 才生效。
| 10.0.XX.XX |
PeriodUnit | string | 否 | 购买资源的时长单位。取值:
| Month |
PublicIpIdentification | boolean | 否 | 是否启用公网 ipidentification。取值:-true:启用。-false(默认值):不启用。 | true |
PasswordInherit | boolean | 否 | 是否使用镜像预置密码。取值:
说明
Password、KeyPairName、PasswordInherit 至少填入一个。
| false |
InstanceChargeStrategy | string | 否 | 实例计费策略。取值:
| instance |
BillingCycle | string | 否 | 实例计算资源计费周期,仅支持实例级后付费。 取值
| Day |
IpType | string | 否 | IP 类型。取值:
| ipv4 |
AutoUseCoupon | string | 否 | 是否使用代金券,默认为使用,即 AutoUseCoupon=true。 | true |
Tag | object [] | 否 | 实例所绑定的标签 | |
Key | string | 否 | 自定义标签 key | team |
Value | string | 否 | 标签值。不可超过 128 个字符,不能以 | tagValue |
AutoReleaseTime | string | 否 | 按量付费实例的自动释放时间。按照ISO 8601标准表示,使用 UTC+0 时间。格式为:
| 2023-06-28T14:38:52Z |
SpotStrategy | string | 否 | 按量付费实例的竞价策略。当参数
默认值:NoSpot。 | SpotAsPriceGo |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "91E4AFBE-4E35-5D2A-A886-BB477C9953D2",
"InstanceIds": [
"['i-5xxxx26dix05koz15l5413j25o', 'i-5sdmxxxx']"
],
"OrderId": "213177957850399"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Invalid%s | The specified parameter %s is invalid. | 参数不正确 |
400 | Missing%s | You must specify the parameter %s. | 参数为必填 |
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
2024-04-09 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2024-01-25 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-11-07 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-10-19 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-10-17 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-07-27 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-07-27 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-06-13 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-06-08 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-05-10 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
|