调用CreateAndroidInstanceGroup接口创建云手机实例组-无影云手机-阿里云-无影云手机(Cloud Phone)-阿里云帮助中心

创建按量付费或包年包月的云手机实例组。一个实例组可以管理多个实例。可以将具有相同功能定位的实例编入同一个实例组，以便于统一管理。

接口说明

创建云手机实例组前，需要完成实名认证。详细信息，参见个人实名认证。

创建云手机实例组时，请注意，创建实例组会涉及资源计费，建议您提前了解云手机实例组的计费方式。

若实例组的计费方式为包年包月（PrePaid），默认 AutoPay（自动支付）的值为 false，调用接口后需要前往阿里云费用与成本手动支付订单。
如果需要自动支付则设置 AutoPay 的值为 true。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
BizRegionId	string	是	地域 ID。可以通过调用 DescribeRegions 查询云手机支持购买的地域列表。枚举值： cn-shenzhen : 深圳 cn-beijing : 北京 cn-shanghai : 上海 cn-hongkong : 中国香港 ap-southeast-1 : 新加坡 cn-hangzhou : 杭州	cn-hangzhou
InstanceGroupName	string	否	实例组名称。说明实例组名称长度不超过 30 个字符；请以大/小写字母或中文开头，不能以`http://`和`https://`开头，仅支持中文、英文、数字、半角冒号（:）、下划线（_）、点号（.）或者连字符（-）。	Cloud phoneA
NumberOfInstances	integer	否	实例组中的实例数量。最大值为 100。	1
ChargeType	string	否	计费类型。枚举值： PostPaid : 后付费 PrePaid : 预付费	PostPaid
Period	integer	否	购买资源的时长，单位由 PeriodUnit 指定。	1
PeriodUnit	string	否	购买资源的时长单位。枚举值： Month : 月 Year : 年 Hour : 小时，只能用于按量付费方式	Month
InstanceGroupSpec	string	是	实例组规格。可以通过调用 DescribeSpec 查询云手机支持购买的规格。枚举值： acp.perf.large : 性能型（8vCPU、16GiB 内存、32GiB 存储） acp.basic.small : 轻量型（2vCPU、4GiB 内存、32GiB 存储） acp.std.large : 标准型（4vCPU、8GiB 内存、32GiB 存储）	acp.basic.small
AutoPay	boolean	否	是否自动付费。默认为 false。枚举值： true : 自动付费，请确保账号有足够的余额 false : 手动付费	false
AutoRenew	boolean	否	是否开启自动续费。默认为 false。枚举值： true : 预付费资源到期后自动续费 false : 预付费资源到期后需要手动续费	false
OfficeSiteId	string	否	网络 ID。创建共享网络实例：网络 ID 选填。填写云手机控制台>网络页面中类型为共享网络的网络 ID。如果控制台没有共享网络，可以不用填写，将会在创建实例组时自动创建一个共享网络。创建 VPC 网络实例：网络 ID 必填。填写云手机控制台>网络页面中类型为 VPC 网络的网络 ID，如果控制台没有 VPC 网络，则需要先创建网络。	cn-hangzhou+dir-745976****
VSwitchId	string	否	交换机 ID。可以通过调用 DescribeVSwitches 查询交换机列表。创建共享网络实例：不填写。创建 VPC 网络实例：交换机 ID 必填。选用此交换机来创建实例。	vsw-uf61uvzhz8ejaw776****
PolicyGroupId	string	否	策略 ID。可以通过调用 ListPolicyGroups 查询策略列表。	pg-b7bxrrwxkijjh****
ImageId	string	是	镜像 ID。可以通过调用 DescribeImageList 查询云手机的镜像列表。	imgc-06zyt9m93zwax****
Amount	integer	否	实例组数量，默认值为 1，最大值为 100。	8
GpuAcceleration	boolean	否	是否开启 GPU 加速。枚举值： true : 开启 false : 不开启 [默认值]	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	否
PromotionId	string	否
PaidCallbackUrl	string	否
BandwidthPackageType	string	否
BandwidthPackageId	string	否
NetworkType	string	否
PromotionId	string	否
StreamMode	integer	否
PaidCallBackUrl	string	否		wya.wuying.aliyun.com/instanceGroup
SaleMode	string	否
InstanceVersion	string	否
ChannelCookie	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": ""
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。