全部产品
Search

搜索本产品

    ：CreateCloudPhoneNode - 创建云手机矩阵

    文档中心

    ：CreateCloudPhoneNode - 创建云手机矩阵

    更新时间：Jul 13, 2026

    创建云手机矩阵。 在无影云手机系统中，矩阵（Cloud Phone Server）是一个逻辑上的资源管理单元，代表一个物理服务器实例。该物理服务器可以被划分为多个独立运行的云手机实例，这些实例共享矩阵底层的计算、存储和网络资源。创建一个矩阵，即相当于获得一台物理服务器，您可以在其上创建相应的云手机实例（配置不同对应的云手机数量不同）。

    调试

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

    调试

    授权信息

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

    请求语法

    GET  HTTP/1.1

    请求参数

    名称

    类型

    必填

    描述

    示例值
    BizRegionId

    string

    是

    地域 ID。

    枚举值：

    • cn-shanghai :

      华东 2（上海）

    • ap-southeast-1 :

      新加坡

    • eu-central-1 :

      德国（法兰克福）

    • cn-hangzhou :

      华东 1（杭州）

    cn-hangzhou
    NodeName

    string

    否

    云手机矩阵名称。

    node_name
    ServerType

    string

    是

    云手机矩阵规格。

    枚举值：

    • cpm.gx7.10xlarge :

      cpm.gx7.10xlarge

    • cpm.gx8.16xlarge :

      cpm.gx8.16xlarge

    cpm.gx7.10xlarge
    InstanceType

    string

    否

    实例规格。

    说明

    如需购买更多规格，您可以联系售前咨询。

    枚举值：

    • ac.max :

      该规格下默认实例开数为 25 开，可通过设置 PhoneCount 参数调整开数设置（最小 4 开，最大 40 开）

    • ac.plus :

      该规格下默认实例开数为 40 开，可通过设置 PhoneCount 参数调整开数设置（最小 4 开，最大 40 开）

    ac.max
    ChargeType

    string

    否

    付费类型。当前仅支持包年包月类型。

    枚举值：

    • PrePaid :

      包年包月

    PrePaid
    PeriodUnit

    string

    否

    购买资源的时长单位。

    枚举值：

    • Month :

      月 [默认值]

    • Year :

      年

    Month
    Period

    integer

    否

    购买资源的时长，单位由PeriodUnit指定。

    • 当PeriodUnit为 year 时，取值只能为 1。

    • 当PeriodUnit为 month 时，取值范围为 1、2、3、6。

    1
    AutoPay

    boolean

    否

    是否自动付费。

    枚举值：

    • flase :

      需要前往阿里云费用与成本中心手动支付 [默认值]

    • true :

      自动支付

    true
    AutoRenew

    boolean

    否

    是否开启自动续费。

    枚举值：

    • true :

      启用自动续费，实例到期后由系统自动续费

    • false :

      不自动续费，实例到期后手动续费 [默认值]

    true
    ImageId

    string

    否

    镜像 ID。

    imgc-075cllfeuazh0****
    Count

    string

    否

    云手机矩阵的购买数量。

    1
    NetworkId

    string

    否

    办公网络 ID。

    cn-hangzhou+dir-5mwr9azebliva****
    VSwitchId

    string

    否

    交换机 ID。

    vsw-2zeekryyc1q3sm72l****
    Tag

    array<object>

    否

    资源的标签。

    object

    否

    资源的标签。

    Key

    string

    否

    标签键。

    keyname
    Value

    string

    否

    标签值。

    valuename
    PhoneDataVolume

    integer

    否

    独立机身存储的大小。单位：GiB。

    10
    ServerShareDataVolume

    integer

    否

    共享机身存储的大小。单位：GiB。

    说明

    共享机身存储最小值需大于矩阵下的实例开数乘以 10GiB。

    200
    ResolutionHeight

    integer

    否

    分辨率的高度。单位：像素。

    1280
    ResolutionWidth

    integer

    否

    分辨率的宽度。单位：像素。

    720
    PhoneCount

    integer

    否

    单个矩阵中创建云手机实例数量。

    25
    DisplayConfig

    object

    否

    显示设置。

    Dpi

    integer

    否

    DPI。取值范围 72～600。

    240
    Fps

    integer

    否

    说明

    该参数暂未对外开放使用。

    null
    LockResolution

    string

    否

    是否锁定分辨率。

    枚举值：

    • off :

      关闭

    • on :

      开启

    off
    StreamMode

    integer

    否

    云手机矩阵下实例的串流模式，该参数不传默认为抢占模式。

    枚举值：

    • 1 :

      抢占模式

    • 2 :

      协同模式

    1
    NetworkType

    string

    否

    实例的网络类型。

    枚举值：

    • network_pro_ecd :

      云电脑高级办公网络

    network_pro_ecd
    NetworkInfo

    object

    否

    实例网络映射信息。

    BandwidthPackageName

    string

    否

    带宽包名称

    inst-bandwidth-pkg-1
    CidrBlock

    string

    否

    私网网段

    10.10.13.0/24
    LimitedBandwidth

    integer

    否

    带宽包限速峰值，单位 Mbps。使用该带宽包的所有实例（求和）受该带宽上限限制。

    200
    InternetChargeType

    string

    否

    带宽包的计费方式。取值：

    - **PayByBandwidth**（默认值）：按带宽计费。

    枚举值：

    • PayBy95 :

      按传统 95 计费

    • PayByBandwidth :

      按带宽计费

    PayByBandwidth
    IpRatio

    integer

    否

    IP 与实例比。

    枚举值：

    • 128 :

      128 个云手机实例对应一个 EIP（公网出口 IP）

    128
    Isp

    string

    否

    线路类型。

    枚举值：

    • ChinaUnicom :

      中国联通

    • ChinaTelecom :

      中国电信

    • ChinaMobile :

      中国移动

    • BGP :

      BGP（多线）线路

    ChinaTelecom
    PayType

    string

    否

    付费类型。

    枚举值：

    • PostPaid :

      按量付费

    • PrePaid :

      包年包月

    PostPaid
    VisibleType

    string

    否

    可见范围

    CPS
    PaidCallbackUrl

    string

    否

    BandwidthPackageType

    string

    否

    带宽类型。

    枚举值：

    • cbwp_ecd :

      精品带宽包

    cbwp_ecd
    BandwidthPackageId

    string

    否

    共享带宽实例的 ID。

    cbwp-uf6g3hgg*******8s3lxiob3
    UpBandwidthLimit

    integer

    否

    上行带宽限速，单位 Mbps

    50
    DownBandwidthLimit

    integer

    否

    下行带宽限速，单位 Mbps

    50
    UseTemplate

    string

    否

    创建时是否使用模板。如果使用模版列表的随机模板，则取值为Random，如果传入模板 ID，则使用该模板 ID。

    Random
    PromotionId

    string

    否

    PaidCallBackUrl

    string

    否

    SwapSize

    integer

    否

    IsSingleImgDisk

    boolean

    否

    ChannelCookie

    string

    否

    返回参数

    名称

    类型

    描述

    示例值

    object

    请求信息。

    RequestId

    string

    请求 ID。

    69BCBBE4-FCF2-59B8-AD9D-531EB422****
    OrderId

    string

    订单 ID。

    223684716098****
    NodeInfos

    array<object>

    云手机矩阵信息。

    object

    云手机矩阵信息。

    NodeId

    string

    云手机矩阵 ID。

    cpn-e5kxgjyt8s1mb****
    InstanceIds

    array

    云手机实例 ID 列表。

    string

    云手机实例 ID。

    cpn-e5kxgjyt8s1mb****
    NetworkPackageOrderModel

    object

    带宽包订单信息

    BandwidthPackageOrderId

    string

    带宽包订单 ID

    25954415983*****
    BandwidthPackageId

    string

    共享带宽的 ID。

    cbwp-uf63gsv8j0ir53*****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "69BCBBE4-FCF2-59B8-AD9D-531EB422****",
  "OrderId": "223684716098****",
  "NodeInfos": [
    {
      "NodeId": "cpn-e5kxgjyt8s1mb****",
      "InstanceIds": [
        "cpn-e5kxgjyt8s1mb****"
      ]
    }
  ],
  "NetworkPackageOrderModel": {
    "BandwidthPackageOrderId": "25954415983*****",
    "BandwidthPackageId": "cbwp-uf63gsv8j0ir53*****"
  }
}

    错误码

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

    变更历史

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