All Products
Search
Document Center

Cloud Phone:ModifyInstanceGroupSpec

Last Updated:Aug 05, 2026

Changes the specifications of instance groups. Currently, only specification upgrades are supported. Specification downgrades are not supported.

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

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

InstanceGroupIds

array

No

The list of instance group IDs.

string

No

The instance group ID.

ag-h67a2cs0zpruy****

InstanceGroupSpec

string

Yes

The instance group specification. You can call DescribeSpec to query the specifications available for purchase for cloud phones.

acp.basic.small

AutoPay

boolean

No

Specifies whether to enable automatic payment. Valid values:

  • true: Automatic payment is enabled. Make sure that your account balance is sufficient.

  • false (default): Only generates an order without deducting fees.

Note

If your payment method balance is insufficient, set this parameter to false. An unpaid order is generated, and you can log on to the Cloud Phone console to complete the payment.

false

PromotionId

string

No

The promotion ID.

50003308011****

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

Id of the request

425F351C-3F8E-5218-A520-B6311D0D****

OrderInfo

array<object>

The order information.

object

The order information.

OrderId

string

The order ID.

296325540190****

InstanceIds

array

The list of instance IDs.

string

The instance ID of the instance for which Upgrade/Downgrade is performed.

acp-fjozvi4s8seyz****

OrderTaskId

string

The order task ID that is returned when specifications of more than 10 instance groups are changed in a batch. You can call the DescribeOrderTasks operation to query the information about each order.

t-aycabdsjsbgd****

Examples

Success response

JSON format

{
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "OrderInfo": [
    {
      "OrderId": "296325540190****",
      "InstanceIds": [
        "acp-fjozvi4s8seyz****"
      ]
    }
  ],
  "OrderTaskId": "t-aycabdsjsbgd****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.