创建按量付费或包年包月的云手机实例组。一个实例组可以管理多个实例。可以将具有相同功能定位的实例编入同一个实例组,以便于统一管理。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
BizRegionId |
string |
是 |
地域 ID。可以通过调用 DescribeRegions 查询云手机支持购买的地域列表。 |
cn-hangzhou |
InstanceGroupName |
string |
否 |
实例组名称。 说明
实例组名称长度不超过 30 个字符;请以大/小写字母或中文开头,不能以 |
云手机A |
NumberOfInstances |
integer |
否 |
实例组中的实例数量。最大值为 100。 |
1 |
ChargeType |
string |
否 |
计费类型。 |
PostPaid |
Period |
integer |
否 |
购买资源的时长,单位由 PeriodUnit 指定。 |
1 |
PeriodUnit |
string |
否 |
购买资源的时长单位。 |
Month |
InstanceGroupSpec |
string |
是 |
实例组规格。可以通过调用 DescribeSpec 查询云手机支持购买的规格。 |
acp.basic.small |
AutoPay |
boolean |
否 |
是否自动付费。默认为 false。 |
false |
AutoRenew |
boolean |
否 |
是否开启自动续费。默认为 false。 |
false |
OfficeSiteId |
string |
否 |
网络 ID。 |
cn-hangzhou+dir-745976**** |
VSwitchId |
string |
否 |
交换机 ID。可以通过调用 DescribeVSwitches 查询交换机列表。
|
vsw-uf61uvzhz8ejaw776**** |
PolicyGroupId |
string |
否 |
策略 ID。可以通过调用 ListPolicyGroups 查询策略列表。 |
pg-b7bxrrwxkijjh**** |
ImageId |
string |
是 |
镜像 ID。可以通过调用 DescribeImageList 查询云手机的镜像列表。 |
imgc-06zyt9m93zwax**** |
Amount |
integer |
否 |
实例组数量,默认值为 1,最大值为 100。 |
8 |
GpuAcceleration |
boolean |
否 |
是否开启 GPU 加速。 |
false |
KeyPairId |
string |
否 |
密钥对 ID。创建实例组的时候,如果指定了合法的密钥对 ID,会在这次创建成功的实例上,都绑定该密钥对,不用再重新调用绑定接口。 说明
目前还不支持扩容的时候绑定密钥对。 |
kp-7o9xywwfutc1l**** |
ClientToken |
string |
否 |
用于保证请求的幂等性,防止重复提交请求。不超过 100 个字符。 |
asadbuvwiabdbvchj**** |
EnableIpv6 |
boolean |
否 |
说明
该参数暂未对外开放使用。 |
null |
Ipv6Bandwidth |
integer |
否 |
说明
该参数暂未对外开放使用。 |
null |
Tag |
array<object> |
否 |
资源的标签。 |
|
object |
否 |
资源的标签。 |
||
Value |
string |
否 |
标签值。 |
value |
Key |
string |
否 |
标签键。 |
key |
NetworkInfo |
object |
否 |
||
BandwidthPackageName |
string |
否 |
||
CidrBlock |
string |
否 |
||
LimitedBandwidth |
integer |
否 |
||
InternetChargeType |
string |
否 |
||
IpRatio |
integer |
否 |
||
Isp |
string |
否 |
||
PayType |
string |
否 |
||
Period |
integer |
否 |
||
PeriodUnit |
string |
否 |
||
AutoPay |
boolean |
否 |
||
AutoRenew |
boolean |
否 |
||
VisibleType |
string |
否 |
||
BandwidthPackageType |
string |
否 |
||
BandwidthPackageId |
string |
否 |
||
NetworkType |
string |
否 |
||
PromotionId |
string |
否 |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
返回参数。 |
||
RequestId |
string |
请求 ID。 |
1A923337-44D9-5CAD-9A53-95084BD4**** |
InstanceGroupInfos |
array<object> |
实例组信息。 |
|
object |
|||
InstanceGroupId |
string |
实例组 ID。 |
ag-cuv4scs4obxch**** |
InstanceIds |
array |
实例 ID 列表。 |
|
string |
实例 ID。 |
acp-g40b9at5nhjo9**** |
|
OrderId |
string |
订单 ID。 |
22365781890**** |
InstanceGroupIds |
array |
实例组 ID 列表。 |
|
string |
实例组 ID。 |
ag-cuv4scs4obxch**** |
|
NetworkPackageOrderModel |
object |
||
BandwidthPackageOrderId |
string |
||
BandwidthPackageId |
string |
示例
正常返回示例
JSON
格式
{
"RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
"InstanceGroupInfos": [
{
"InstanceGroupId": "ag-cuv4scs4obxch****",
"InstanceIds": [
"acp-g40b9at5nhjo9****"
]
}
],
"OrderId": "22365781890****",
"InstanceGroupIds": [
"ag-cuv4scs4obxch****"
],
"NetworkPackageOrderModel": {
"BandwidthPackageOrderId": "",
"BandwidthPackageId": ""
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。