All Products
Search
Document Center

:ChangeCloudPhoneNode

Last Updated:Nov 06, 2025

Changes the configuration of a cloud phone matrix, such as the instance type and the number of cloud phone instances.

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 ID of the cloud phone matrix.

cpn-0ugbptfu473fy****

InstanceType

string

No

The instance type.

Valid values:

  • ac.max :

    Nvidia T4, 8 vCPUs, 12 GiB

  • ac.plus :

    Nvidia T4, 4 vCPUs, 6 GiB

ac.max

PhoneCount

integer

No

The number of cloud phone instances. For more information about the minimum and maximum number of instances allowed, see DescribeSpec.

20

UpBandwidthLimit

integer

No

The upstream bandwidth throttling limit. Unit: Mbps.

50

DownBandwidthLimit

integer

No

The downstream bandwidth throttling limit. Unit: Mbps.

50

PhoneDataVolume

integer

No

The phone storage size. The value must be between 10 GiB and 4,000 GiB. If you leave this parameter empty, the initial size is retained.

10

AutoPay

boolean

No

Specifies whether to enable automatic payment. The default value is false.

false

PromotionId

string

No

The promotion ID.

50003308011****

DisplayConfig

string

No

Response elements

Element

Type

Description

Example

object

The response schema.

RequestId

string

The request ID.

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

NodeInfos

array<object>

The information about the cloud phone matrix.

array<object>

The information about the cloud phone matrix.

NodeId

string

The ID of the cloud phone matrix.

cpn-e5kxgjyt8s1mb****

InstanceInfos

array<object>

The information about the cloud phone instances.

object

The information about the cloud phone instance.

InstanceId

string

The instance ID.

cpn-jewjt8xryuitu****

PhoneDataVolume

integer

The internal storage capacity of the cloud phone.

200

ShareDataVolume

integer

If the matrix uses the internal storage of the cloud phones, a non-modifiable 64 GiB shared storage space is allocated by default to store global matrix files, such as images. If the matrix uses the shared storage, which is configured at purchase, this storage space is shared by 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.