参数名称 | 类型 | 必填 | 描述 |
|---|
| Action | String | 是 | 公共参数，本接口取值：RunInstances。 |
| Version | String | 是 | 公共参数，本接口取值：2016-03-04。 |
| ImageId | String | 是 | 镜像ID 示例值：标准UUID格式，形如`^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$` |
| DedicatedHostId | String | 否 | 专属宿主机ID |
| InstanceType | String | 否 | 实例套餐类型 示例值： DVM1.NONE，DVM2.NONE |
| DataDiskGb | Int | 否 | 数据卷容量，单位GB |
| MaxCount | Int | 是 | 最大实例数，如果指定的实例数大于金山云在本人Region所能创建的最大实例数，则会创建大于MinCount数量的最大允许实例数。 示例值： 最小值1，最大值为**当前用户实例剩余配额** |
| MinCount | Int | 是 | 最小实例数，如果指定的实例数大于金山云在本Region所能创建的最大实例数，则不会创建任何实例。 示例值： 最小值1，最大值为**当前用户实例剩余配额** |
| SubnetId | String | 是 | VPC环境下的子网ID，绑定到主网卡 示例值：标准UUID格式，形如`^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$` |
| InstancePassword | String | 否 | 实例开机密码 示例值：最短8字符，最长32字符，必须包含大小写英文字符和数字，支持其他可见字符 |
| ChargeType | String | 是 | 调用时需要明确指定，无默认值 示例值：Monthly(包年包月）、Daily（按量付费（按日月结）)、 HourlyInstantSettlement（按量付费（按小时月结）） |
| PurchaseTime | Int | 否 | 购买时长，单位月 示例值：当计费类型为Monthly（包年包月）时，有效值1-36；其他计费类型时，强制要求参数值为0 |
| SecurityGroupId.N | String | 是 | 实例绑定的安全组，目前仅支持绑定一个安全组 示例值：标准UUID格式，形如`^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$` |
| PrivateIpAddress | String | 否 | 私有IP地址，指定子网IP地址范围内的任意有效值，代表实例的主IP地址，只能选择一个，绑定到主网卡；如果未指定该参数，系统自动从有效地址池中随机选取一个 示例值：标准IP地址格式 |
| InstanceName | String | 否 | 实例名称，如果未指定，则自动生成，形如 示例值：最短2字符，最长64字符，支持中英文 |
| InstanceNameSuffix | String | 否 | 实例名称后缀，InstanceName参数如果缺省，此参数不生效；当大于1台的批量创建主机，后缀编号自动+1，例如后缀输入5，主机名输入"host"，批量3台，则生成的三台主机名分别为："host-5"、"host-6"、"host-7"； 示例值：0到9999 默认值：空 |
| ProjectId | Long | 否 | 实例所属项目ID 示例值：账户有权限的项目ID，0为默认项目 默认值：默认项目 |
| DataDisk.N | Object | 否 | 数据盘是否随实例释放 示例值： 默认值：false |
| DeleteWithInstance | Boolean | 否 | 数据盘是否随实例释放 示例值： |
| Type | String | 否 | 数据盘类型 |
| Size | Int | 否 | 数据盘大小 |
| SnapshotId | String | 否 | 创建云盘所用的快照 示例值：479ede4b-8b15-49d6-8d10-bc64f2c78831 |
| NetworkInterface.N | Object | 否 | 辅网卡 |
| SubnetId | String | 否 | 辅网卡的子网id不创建辅网卡时非必填，创建辅网卡时必填 |
| SecurityGroupId.N | String | 否 | 辅网卡的安全组id不创建辅网卡时非必填，创建辅网卡时必填 |
| PrivateIpAddress | String | 否 | 辅网卡的内网ip,创建辅网卡传了按传的ip开机，不传自动分配 |
| UserData | String | 否 | 用户自定义数据 |
| SystemDisk | Object | 否 | 系统盘 |
| DiskType | String | 否 | 系统盘类型 |
| DiskSize | Int | 否 | 系统盘大小 |
| ModelId | String | 否 | 实例启动模版ID，如填写了此项，则启动模板中已包含的RunInstances其他参数不生效，启动模板未指定的参数若调用RunInstances时额外传入则可生效，如果批量创建，实例名称后缀依然存在。【传modelId，使用默认版本。传modelId和modelVersion，使用传递的版本】 示例值：3f0d6229-ed2d-4c9c-8554-b9433517cf8b |
| ModelVersion | Long | 否 | 实例启动模板版本号。如不指定，则采用默认版本号 示例值：3 |
| AssembledImageDataDiskType | String | 否 | 整机镜像所开云盘数据盘的类型 示例值：SSD3.0 默认值：SSD3.0 |
| AutoCreateEbs | Boolean | 否 | 整机镜像是否展开镜像中的数据盘 示例值：false 默认值：true |
| LineId | String | 否 | 弹性IP的链路类型的ID |
| AddressBandWidth | Int | 否 | 弹性IP的带宽，1，如果购买EIP，AddressBandWidth、LineId、AddressChargeType三个接口参数必须同时存在，如有其中任意一个接口参数，判断是否存在其他两个参数；2，如果选择预付费计费方式，必须有购买时长参数； | |
| AddressChargeType | String | 否 | PrePaidByMonth ：包年包月，有到期时间，只能升带宽；PostPaidByPeak：按峰值月结，无到期时间，可升降带宽；PostPaidByDay：按日月结，无到期时间，可升降带宽；PostPaidByTransfer：按流量月结，无到期时间，可升降带宽；PostPaidByHour：按小时月结，无到期时间，可升降带宽 |
| AddressProjectId | String | 否 | 弹性IP项目的ID,默认值为0 |
| BandWidthShareId | String | 否 | 共享带宽ID |
| AddressPurchaseTime | Int | 否 | 购买时长 |
| KeyId.N | String | 否 | 秘钥ID |
| KeepImageLogin | Boolean | 否 | 是否保留镜像设置 |
| HostName | String | 否 | 操作系统内部的计算机名 |
| HostNameSuffix | Int | 否 | 创建多台实例时为HostName增加有序后缀，有序后缀从1增加，例如host-1 |
| FailureAutoDelete | Boolean | 否 | 开机失败是否对外删除 ，默认值是false |
| Tag.N | Object | 否 | 标签信息 |
| Key | String | 否 | 标签键值 |
| Id | Long | 否 | 标签Id |
| Value | String | 否 | 标签值 |
| DataGuardId | String | 否 | 容灾组id |
| InstanceConfigure | Object | 否 | |
| VCPU | String | 否 | cpu |
| MemoryGb | String | 否 | 内存 |
| DataDiskGb | String | 否 | 数据卷容量，单位GB |
| SriovNetSupport | Boolean | 否 | 是否支持联网增强 |
| DistributeIpv6 | Boolean | 否 | 是否分配ipv6 |
| LocalVolumeSnapshotId | String | 否 | 本地盘快照id |
| SyncTag | Boolean | 否 | 是否同步ebs标签 |
| IamRoleName | String | 否 | iam角色名称 |
| AutoDeleteTime | String | 否 | 定时删除时间 |
| AutoDeleteEip | Boolean | 否 | 是否自动删除eip |
| IsProtect | Boolean | 否 | 是否开启资源保护 |
参数名称 | 类型 | 描述 |
|---|
| RequestId | String | 示例值：a831f245-2694-47de-a417-a5e7d8b250f1012 |
| InstancesSet | Object[] | |
| InstanceId | String | 示例值：2d6234da-d9b7-4d54-bd1a-63fe343a5879 |
| InstanceName | String | 示例值：xytest2 |
JSON格式
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码
错误码 | 错误信息 | Http状态码 | 描述 |
|---|
| InvalidParameter.ModelIdNotExist | InvalidParameter.ModelIdNotExist | 400 | 模版ID不正确 |
| ModelVersionLimitExceed | The time of modified templates has reached the limit. | 400 | 修改模板次数已达上限 |
| SecurityGroupIdRequired | SecurityGroupId is required | 400 | SecurityGroupId必传 |
| ImageIdInvalidParameterValue | An invalid or out-of-range value was supplied for the "ImageId" parameter. | 400 | “镜像ID”参数的取值无效或者超出有效范围 |
| SubnetInvalidParameterValue | An invalid or out-of-range value was supplied for the "Subnet"([{0}]) parameter. | 400 | “子网”([{0}])参数的取值无效或者超出有效范围 |
| CheckVMCount | When the specified MAC address is turned on, the values of maxcount and mincount can only be 1. | 400 | 指定mac地址开机时，MaxCount 与 MinCount 的值均只能为1 |
| CheckMacAddress | The Mac address format of the input is incorrect. | 400 | 输入的主网卡mac地址内容格式不正确 |
| InstanceTypeNoneInvalid | Create or upgrade does not support non-standard instancetype. | 400 | 创建、升配不支持非标套餐. |
| InstanceOrderMustInUse | The "InstanceOrder" parameter must be used when calling directly from console. | 400 | 使用控制台调用必须传递“实例订单”参数 |
| InstanceOrderNotInUse | The "InstanceOrder" parameter should not be used when calling directly from SDK or OpCenter. | 400 | 使用SDK或者运营平台调用不应该传递“实例订单”参数 |
| MaxCountGreatSubOrders | Max_count must equal vmSubOrders. | 400 | 创建最大数量必须等于虚机的子订单数 |
| VMCountNotConsistentWithDataGuardCount | 暂无解释 | 400 | 暂无解释 |
| InstanceTypeInvalidParameterValue | An invalid or out-of-range value was supplied for the "InstanceType" parameter. | 400 | “实例套餐类型”参数的取值无效或者超出有效范围 |
| ProductTypeNotSupportSnapshot | The specified instance type does not support using snapshot to create disk. | 400 | 该实例类型不支持快照开盘 |
| ChargeTypeInvalidParameterValue | An invalid or out-of-range value was supplied for the "ChargeType" parameter | 400 | “计费类型”参数的取值无效或者超出有效范围 |
| PurchaseTimeInvalidParameterValue | An invalid or out-of-range value was supplied for the "PurchaseTime" parameter. | 400 | “购买时长”参数的取值无效或者超出有效范围 |
| MinCountNotMoreThanMaxCount | The value of "MinCount" parameter should be no more than that of "MaxCount" parameter | 400 | “最小实例数”参数的取值不应超出“最大实例数”参数的取值 |
| BindingEBSTypeInvalidParameterValue | binding EBS type is required. | 400 | EBS盘类型不允许为空 |
| DiskDataPerformanceMode | The specified types of ESSD disks can not be attached to one instance in the meantime. | 400 | 暂不支持单实例同时挂载选中的多类型的极速云盘 |
| DataGuardIdInvalid | DataGuardId is invalid | 400 | 容灾分组ID无效 |
| VMNotSupportAddDamainDataGuard | 暂无解释 | 400 | 暂无解释 |
| ProductTypeNotSupportDataGuard | 暂无解释 | 400 | 暂无解释 |
| ProductPermissionDenied | This package can not be used | 400 | 用户不能使用该套餐 |
| DamainDataGuardNotSupportSpot | 暂无解释 | 400 | 暂无解释 |
| SnapshotServiceArrears | Your snapshot charge is overdue, please renew it. | 400 | 您的账号已欠费，请先充值. |
| SnapshotServiceStopped | Your snapshot service has been stopped. Please contact customer service. | 400 | 您的快照服务已关停，如需开通请联系金山云客服 |
| SnapshotServiceRecycling | Your snapshot resources are recycled. Please contact customer service. | 400 | 您的快照资源已被回收，如有疑问请提工单或联系金山云客服 |
| SnapshotServiceNotOpened | Snapshot service is not ordered. Please go to the console to enable the snapshot service. | 400 | 快照服务未开通, 请登录控制台界面快照列表开通快照服务. |
| SnapshotTypeInvalidParameterValue | The specified snapshot does not support creating images. | 400 | 该快照不支持制作镜像 |
| SnapshotSizeInvalidDataDiskSize | The snapshot size does not match the data disk size | 400 | 快照大小和数据盘大小不匹配 |
| SnapshotStateInvalidParameterValue | 暂无解释 | 400 | 暂无解释 |
| SubnetNotInTheSameAvailabilityZone | The Subnets are not in the same availability Zone. | 400 | 网卡信息不在同一个可用区下，请重新填写 |
| SecurityGroupInvalidParameterValue | An invalid or out-of-range value was supplied for the "SecurityGroupId"([{0}]) parameter. | 400 | “安全组”([{0}]) 参数的取值无效或者超出有效范围 |
| PrivateIpAddressDuplicate | The specified IP of the ENIs is duplicated. Please modify. | 400 | 网卡指定IP重复，请修改 |
| SubnetIsNotNormal | Subnet type must be Normal | 400 | 选择的子网的类型必须是普通子网 |
| PrivateIPEqualsGatewayIP | PrivateIpAddress is not allowed to equal Subnet's gateway ip | 400 | PrivateIpAddress不允许等于子网的网关IP |
| PrivateIPNotMatchDhcp | PrivateIpAddress exceeds Subnet's DHCP Range | 400 | PrivateIpAddress超过子网设置的DHCP范围 |
| SubnetInvalidParameterValue | An invalid or out-of-range value was supplied for the "Subnet"([{0}]) parameter. | 400 | “子网”([{0}])参数的取值无效或者超出有效范围 |
| SubnetAndSecurityGroupNotInTheSameVPC | The SubnetId and SecurityGroupId are not in the same VPC. | 400 | 所选 SubnetId 与 SecurityGroupId 不在同一个VPC下，请重新填写。 |
| VolumeSnapshotIdInvalidParameterValue | Volume snapshot id is invalid | 400 | 磁盘快照ID参数不正确 |
| VolumeSnapshotESSDTypeErrorParameterValue | The specified snapshot can not be used to create the disk of this type. | 400 | 暂不支持此类型快照创建此类型数据盘 |
| SnapshotDiskTypeNotSupportParamDiskType | The disk type of the local snapshot does not match the disk type of the parameter | 400 | 本地快照的盘类型和参数的盘类型不匹配 |
| SnapshotZoneNotSupportParamZone | The availability of the local snapshot does not match the parameters or subnet availability | 400 | 本地快照的可用区和参数或者子网可用区不匹配 |
| VolumeSnapshotESSDTypeErrorParameterValue | The specified snapshot can not be used to create the disk of this type. | 400 | 暂不支持此类型快照创建此类型数据盘 |
| InsufficientInventory | Insufficient inventory or user's spot instances exceed the maximum number. | 400 | 库存不足或超过竞价实例可开最大数量 |
| IamRoleNotSupportKecInstance | The IAM role was not support for the Kec Insrance. | 400 | 指定的 IAM 角色没有授权。 |
| IamRoleNotFound | The IAM role was not found. | 400 | 指定的IAM角色不存在 |
| NoPermissionCreationOptimization | Your account does not support RunOptimized creation. | 400 | 您的账号不支持批量开机优化功能 |
| DiskTypeNotSupportOptimised | ProductPermissionDeniedDisk type does not support optimised. | 400 | 磁盘类型不支持optimised |
| MoreThanNetworkInterfaceQuota | The current package only supports {0} ENIs. Please reduce the number of ENIs | 400 | 当前套餐只支持挂载{0}块网卡，请减少网卡数量 |
| ProductSellOutInvalid | product is already sold out. | 400 | 此商品在该机房已售罄. |
| SpotPriceLimitCanNotNull | The parameter "SpotPriceLimit" can not null when the SpotStrategy is SpotWithPriceLimit. | 400 | 当竞价实例的抢占策略为SpotWithPriceLimit时，参数“SpotPriceLimit”不允许为空 |
| SpotPriceLimitInvalid | An invalid or out-of-range value was supplied for the "SpotPriceLimit" parameter. | 400 | “SpotPriceLimit”参数的取值无效或者超出有效值范围 |
| SpotStrategyInvalid | An invalid or out-of-range value was supplied for the "SpotStrategy" parameter. | 400 | “SpotStrategy” 参数的取值无效或者超出有效值范围 |
| SpotStrategyAndSpotPriceLimitNotAllow | It does not support the parameters "SpotPriceLimit" and "SpotStrategy" when the billType is not spot. | 400 | 非竞价实例计费类型不支持参数 “SpotPriceLimit” 和 “SpotStrategy” |
| EbsSystemDiskProductSellOutInvalid | ebs system disk [{0}] product already sold out. | 400 | 此ebs系统盘[{0}]商品在该机房已售罄. |
| BindingEBSSizeInvalidParameterValue | binding EBS size is required. | 400 | EBS盘大小不允许为空 |
| EbsProductPermissionDenied | The EBS package can not be used | 400 | 用户不能使用该EBS套餐 |
| InstanceTypeNotSupportBindingEBS | instance type does not support binding EBS. | 400 | 实例类型不支持绑定ebs数据盘 |
| BindingEBSNumberInvalid | binding EBS number is invalid. | 400 | 超过实例绑定ebs数据盘数量限制 |
| BindingEBSSizeParamInvalid | The size of the EBS disk out-of-range, should be [{0} - {1}], and the multiple of [{2}]. | 400 | EBS数据盘大小超出有效范围：[{0} - {1}]，且为[{2}]的倍数。 |
| CreateEBSProductError | Create EBS product fail [{0}]. | 400 | 创建ebs商品失败[{0}] |
| AddressBandWidthRequired | AddressBandWidth is not set. | 400 | 没有设置弹性IP带宽 |
| EipNotAllowAttach | The current user is not allowed to bind EIP. Please contact customer service. | 400 | 当前用户不允许绑定eip请联系客服 |
| EipDailyQuotaExceed | The number of daily EIPs is insufficient. | 400 | 弹性ip 的数量超过您账号的额度限制，若需调整限额请提工单 |
| EipAccountQuotaExceed | Elastic IP address quota exceeded. | 400 | 弹性ip 的数量超过您今日可购买限额，若需调整限额请提工单 |
| AddressPurchaseTimeRequired | The current billing method is prepaid. Please set the purchase time. | 400 | 计费方式为包年包月，没有设置购买时长 |
| AddressPurchaseTimeInvalidParameterValue | An invalid or out-of-range value was supplied for the "AddressPurchaseTime" parameter. | 400 | “购买时长”参数的取值无效或者超出有效范围 |
| ProjectMemberNotExist | User is not a member of Project [{0}] | 400 | 当前用户并不在项目[{0}]中 |
| AddressBandWidthInvalidParameterValue | An invalid or out-of-range value was supplied for the "AddressBandWidth" parameter. | 400 | “弹性IP的带宽”参数的取值无效或者超出有效范围 |
| PaymentCreateProductFailed | create product failed | 400 | 创建商品失败 |
| SystemDiskTypeInvalid | An invalid or out-of-range value was supplied for the "SystemDisk.DiskType" parameter. | 400 | “系统盘类型”参数的取值无效或者超出有效范围. |
| InstanceIdInvalid | The instance Resource id is invalid | 400 | 实例资源ID无效 |
| RootDiskSizeLessThanImageSize | RootDiskSizeLessThanImageSize | 400 | 系统盘容量不能小于镜像最小需求容量或者缺省容量 |
| VMCountGreaterThanDataGuardCount | Create instance fail, because Data Guard Groups ({0}) has insufficient room | 400 | 创建失败，容灾组({0})的可用容量不足，请选择其他容灾组 |
| NotSufficientFunds | NotSufficientFunds | 400 | 余额不足，支付失败 |
| RockyLinuxOnlySupport2048ForRsaKey | The specified image only support RSA 2048 bit key pair. | 400 | 该镜像类型仅支持RSA 2048位的密钥 |
| InternalError | The request processing has failed due to some unknown error. | 400 | 内部错误，请重试。 |
| LocalImageOnlySupportSSD3ForCreateInstance | To create an instance by local image, you must use SSD EBS 3.0 volumes as system and data disks which associated with the image. | 400 | 使用本地镜像创建实例，镜像关联的系统盘和数据盘仅支持ssd3.0 |
| SecurityGroupIdLimitExceeded | The number of security groups has reached the limit 5 | 400 | 安全组数量已达到上限{0} |
| SubnetAndPrivateIpAddressNotMatch | Private ip address is not in the sub network IP range or has been used | 400 | 私网IP不在子网的IP范围内或者已经被占用 |
| 403001 | 价格体系-无使用该计费方式的权限 | 400 | 价格体系-无使用该计费方式的权限 |
| 400001 | 价格体系-产品类型不支持该计费方式 | 400 | 价格体系-产品类型不支持该计费方式 |
| AvailableIpNumberNotEnough | 系统盘容量不能小于镜像最小需求容量或者缺省容量 | 400 | 系统盘容量不能小于镜像最小需求容量或者缺省容量 |
| TrustCanNotAttachEip | Instance under Trust VPC are not allowed to attach EIP. | 400 | 互信vpc下的云主机不允许绑定eip |
| ImageTypeNotSupportedCloudInit | The ImageType for this not supported CloudInit | 400 | 该镜像类型不支持CloudInit |
| ImageSizeNotSupportInstanceType | ImageSizeNotSupportInstanceType | 400 | 镜像需求容量大于当前机型支持的系统盘容量 |
| ImageTypeOnlySupportedKeepImageLogin | The ImageType for this only supported keepImageLogin | 400 | 该镜像类型仅支持保留镜像设置 |
| ImageModeAdapt | The speficied instance type does not support the specified image's boot mode | 400 | 当前机型不支持所选镜像的启动模式 |
纯净模式
