全部產品
Search
文件中心

Cloud Phone:CreateAndroidInstanceGroup - 建立執行個體組

更新時間:Nov 28, 2025

建立隨用隨付或訂用帳戶的雲手機執行個體組。一個執行個體組可以管理多個執行個體。可以將具有相同功能定位的執行個體編入同一個執行個體組,以便於統一管理。

介面說明

建立雲手機執行個體組時,請注意,建立執行個體組會涉及資源計費,建議您提前瞭解雲手機執行個體組的計費方式

  • 若執行個體組的計費方式為訂用帳戶(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

網路識別碼。

  • 建立共用網路執行個體:網路識別碼 選填。填寫雲手機控制台>網路頁面中類型為共用網路的網路識別碼。如果控制台沒有共用網路,可以不用填寫,將會在建立執行個體組時自動建立一個共用網路。

  • 建立 VPC 網路執行個體:網路識別碼 必填。填寫雲手機控制台>網路頁面中類型為 VPC 網路的網路識別碼,如果控制台沒有 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

BandwidthPackageType

string

BandwidthPackageId

string

NetworkType

string

PromotionId

string

StreamMode

integer

返回參數

名稱

類型

描述

樣本值

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情