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://开头，仅支持中文、英文、数字、半角冒号（:）、下划线（_）、点号（.）或者连字符（-）	云手机A
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 加速，默认值为 false。 true：开启。 false：关闭。	false
KeyPairId	string	否	密钥对 ID。创建实例组的时候，如果指定了合法的密钥对 ID，会在这次创建成功的实例上，都绑定该密钥对，不用再重新调用绑定接口。说明：目前还不支持扩容的时候绑定密钥对。	kp-7o9xywwfutc1l****
ClientToken	string	否	用于保证请求的幂等性，防止重复提交请求。不超过 100 个字符。	asadbuvwiabdbvchjsbj

返回参数

名称	类型	描述	示例值
	object	返回参数。
RequestId	string	请求 ID。	1A923337-44D9-5CAD-9A53-95084BD4****
InstanceGroupInfos	array<object>	实例组信息。
InstanceGroupInfos	object
InstanceGroupId	string	实例组 ID。	ag-cuv4scs4obxch****
InstanceIds	array	实例 ID 列表。
InstanceIds	string	实例 ID。	acp-g40b9at5nhjo9****
OrderId	string	订单 ID。	22365781890****
InstanceGroupIds	array	实例组 ID 列表。
InstanceGroupIds	string	实例组 ID。	ag-cuv4scs4obxch****

示例

正常返回示例

JSON格式

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "InstanceGroupInfos": [
    {
      "InstanceGroupId": "ag-cuv4scs4obxch****",
      "InstanceIds": [
        "acp-g40b9at5nhjo9****"
      ]
    }
  ],
  "OrderId": "22365781890****",
  "InstanceGroupIds": [
    "ag-cuv4scs4obxch****"
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-10-24	OpenAPI 入参发生变更	查看变更详情
2024-08-19	OpenAPI 返回结构发生变更	查看变更详情
2024-07-24	OpenAPI 入参发生变更	查看变更详情
2024-07-02	OpenAPI 入参发生变更	查看变更详情