CreateAndroidInstanceGroup - 创建实例组

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

接口说明

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

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

  • 若实例组的计费方式为包年包月(PrePaid),默认 AutoPay(自动支付)的值为 false,调用接口后需要前往阿里云费用与成本手动支付订单。

  • 如果需要自动支付则设置 AutoPay 的值为 true。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

BizRegionId

string

地域 ID。可以通过调用 DescribeRegions 查询云手机支持购买的地域列表。

cn-hangzhou

InstanceGroupName

string

实例组名称。

说明

实例组名称长度不超过 30 个字符;请以大/小写字母或中文开头,不能以http://https://开头,仅支持中文、英文、数字、半角冒号(:)、下划线(_)、点号(.)或者连字符(-)。

云手机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。

  • 创建共享网络实例:网络 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

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": ""
  }
}

错误码

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

变更历史

更多信息,参考变更详情