全部產品
Search
文件中心

Cloud Phone:CreateAndroidInstanceGroup

更新時間:Jul 13, 2026

建立按量付費或包年包月的雲端手機執行個體群組。一個執行個體群組可以管理多個執行個體。您可以將具有相同功能定位的執行個體編入同一個執行個體群組,以便於統一管理。

介面說明

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

  • 若執行個體群組的計費方式為包年包月(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

返回參數

名稱

類型

描述

樣本值

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

錯誤碼

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

變更歷史

更多資訊,參考變更詳情