All Products
Search
Document Center

:ChangeCloudPhoneNode

Last Updated:Sep 24, 2026

Modifies the configuration of a cloud phone matrix. Currently, only instance type changes and cloud phone instance count changes are supported (the instance count refers to the number of instances in the cloud phone matrix).

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

NodeId

string

No

The cloud phone matrix ID.

cpn-0ugbptfu473fy****

InstanceType

string

No

The instance type.

Valid values:

  • ac2.plus :

    cpm.gx8.16xlarge——4vCPU 6GiB

  • ac2.max :

    cpm.gx8.16xlarge——8vCPU 12GiB

  • ac.max :

    cpm.gx7.10xlarge——8vCPU 12GiB

  • ac.plus :

    cpm.gx7.10xlarge——4vCPU 6GiB

ac.max

PhoneCount

integer

No

The number of cloud phone instances. You can call DescribeSpec to query the maximum and minimum instance count limits.

20

UpBandwidthLimit

integer

No

The upstream bandwidth throttling. Unit: Mbit/s.

50

DownBandwidthLimit

integer

No

The downstream bandwidth throttling. Unit: Mbit/s.

50

PhoneDataVolume

integer

No

The device storage size. Valid range: 10 GiB to 4000 GiB. If this parameter is left empty, the original size is retained.

10

AutoPay

boolean

No

Specifies whether to enable automatic payment. Default value: false.

false

PromotionId

string

No

The promotional activity ID.

50003308011****

DisplayConfig

string

No

SwapSize

integer

No

ShareDataVolume

integer

No

The shared storage size. Unit: GiB.

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

4610632D-D661-5982-B3D7-5D3FD183F****

NodeInfos

array<object>

The cloud phone matrix information.

array<object>

The cloud phone matrix information.

NodeId

string

The cloud phone matrix ID.

cpn-e5kxgjyt8s1mb****

InstanceInfos

array<object>

The cloud phone instance information.

object

The cloud phone instance information.

InstanceId

string

The instance ID.

cpn-jewjt8xryuitu****

PhoneDataVolume

integer

The independent device storage capacity.

200

ShareDataVolume

integer

When the matrix uses independent device storage, 64 GiB of shared storage space is allocated by default (not modifiable) for storing images and other matrix-wide files. When the matrix uses shared device storage (with the size set at purchase), this storage space is shared among all instances.

100

OrderId

string

The generated order ID.

223684716098****

Examples

Success response

JSON format

{
  "RequestId": "4610632D-D661-5982-B3D7-5D3FD183F****",
  "NodeInfos": [
    {
      "NodeId": "cpn-e5kxgjyt8s1mb****",
      "InstanceInfos": [
        {
          "InstanceId": "cpn-jewjt8xryuitu****",
          "PhoneDataVolume": 200
        }
      ],
      "ShareDataVolume": 100
    }
  ],
  "OrderId": "223684716098****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.