RunInstances
批量创建并启动实例
服务地址：
华东1（杭州）
输入参数
只看必填
RegionId地域
InstanceName实例名称
Description实例的描述
InstanceType实例规格
ImageId镜像ID
SecurityGroupId安全组ID
VSwitchId虚拟交换机ID
EipBandwidthEIP带宽值
Resolution云手机实例选用的分辨率
Amount指定创建ECS实例的数量
KeyPairName云手机实例密钥对名称
ChargeType实例的付费方式
PeriodUnit包年包月计费方式的时长单位
AutoRenew是否要自动续费
请选择布尔值
AutoPay是否自动支付
请选择布尔值
Period周期时长
Tag实例的标签集合
0标签列表
Key实例的标签键
Value实例的标签值
添加
PrivateIpAddress云手机私网IP地址
幂等性参数
ClientToken保证请求幂等性
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

准备工作：

注意事项：

  • 单次最多能创建 100 台实例。
  • 接口功能为创建并启动实例。
  • 当遇到由于库存不足等不可抗因素导致的实例生产失败，实例会被自动回滚释放。

请求参数

字段名称字段详情
RegionIdstring

地域

示例值:cn-hangzhou参考取值来源:
    ListRegions
InstanceNamestring

实例名称。长度为 2~128 个字符，必须以大小字母或中文开头，不能以http://或https://开头。可以包含中文、英文、数字、半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。默认值为实例的 InstanceId。

示例值:instance参考取值来源:
    ListInstances
Descriptionstring

实例的描述。长度为 2~256 个英文或中文字符，不能以http://或https://开头。

示例值:cloudphone instance
InstanceTypestring

实例规格

示例值:ecp.ce.large参考取值来源:
    ListInstanceTypes
ImageIdstring

镜像 ID

示例值:cpm-xxxx参考取值来源:
    ImportImage
    CopyImage
    ListImages
    CreateImage
SecurityGroupIdstring

安全组 ID，与 ECS 使用相同的安全组。

示例值:sg-xxxxx
VSwitchIdstring

虚拟交换机 ID

示例值:vsw-xxxx
EipBandwidthinteger<int32>

EIP 带宽值，取值范围 1-200。设置此参数，将自动创建对应带宽的 EIP 实例，并将 EIP 实例绑定到云手机实例。实例释放时，此 EIP 实例会一起释放回收。

示例值:2
Resolutionstring

云手机实例选用的分辨率，可通过 DescribeInstanceTypes 接口查询当前规格支持的分辨率列表，选择合适的分辨率。

示例值:1920*1080
Amountinteger<int32>

指定创建 ECS 实例的数量。取值范围：1~100展开详情

示例值:10
KeyPairNamestring

云手机实例密钥对名称。可通过 ImportKeyPair 接口导入云手机密钥。

示例值:keypair参考取值来源:
    ImportKeyPair
    ListKeyPairs
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多详情，请参见如何保证幂等性。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
ChargeTypestring

实例的付费方式。取值范围：展开详情

示例值:PostPaid
PeriodUnitstring

包年包月计费方式的时长单位。取值范围：展开详情

示例值:Month
AutoRenewboolean

是否要自动续费。当参数 InstanceChargeType 取值 PrePaid 时才生效。取值范围：展开详情

示例值:true
AutoPayboolean

是否自动支付，默认为 true

示例值:true
Periodinteger<int64>

周期时长，默认 1。展开详情

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:1
Tagarray<object>

实例的标签集合。

子级条数 <= 21
PrivateIpAddressstring

云手机私网 IP 地址。云手机实例设置私网 IP 地址时，必须从虚拟交换机（VSwitchId）的空闲网段中选择。展开详情

示例值:192.168.157.224

返回参数

字段名称字段详情
RequestIdstring

请求 ID

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
OrderIdstring

订单号

示例值:9611111323245
TradePricenumber<float>

价格

示例值:133.32
InstanceIdsobject
变更历史
变更时间变更内容概要操作
2022-06-10
新增请求参数PrivateIpAddress