Changes the application instance group for an Elastic Compute Service (ECS) instance in an ECS cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only the common request header. For more information, see Common request parameters.

Request syntax

POST /pop/v5/changeorder/co_change_group HTTP/1.1

Request parameters

Parameter Type Position Required Example Description
AppId String Query Yes 3616cdca-4f92-**********

The ID of the application.
EccInfo String Query Yes 0cf49a6c-95a8-4aa8******

The ID of the elastic compute component (ECC) that corresponds to the ECS instance. You want to change the application instance group for the ECS instance. You can call the ListApplicationEcc operation to query the ECC ID. For more information, see ListApplicationEcc.

<note>The application instance group can be changed for only one ECS instance at a time.</note>

GroupName String Query Yes test

The name of the application instance group, such as group_a and group_b. The parameter value for the default application instance group is _DEFAULT_GROUP.

ForceStatus Boolean Query No true

Specifies whether to forcibly change the application instance group if the deployment package version of the ECC is inconsistent with that of the application instance group.

Response parameters

Parameter Type Example Description
ChangeOrderId String 435f-regfr4********************

The ID of the change process.
Code Integer 200

The HTTP status code.
Message String success

The returned message that indicates whether the request is successful.
RequestId String F9E4-FDS4-****************

The ID of the request.

Examples

Sample requests

POST /pop/v5/changeorder/co_change_group HTTP/1.1
Common request header
{
  "AppId": ""
  "EccInfo": ""
  "GroupName": ""
}

Sample success responses

XML format 

<RequestId>F9E4-FDS4-****************</RequestId>
<Message>success</Message>
<ChangeOrderId>435f-regfr4********************</ChangeOrderId>
<Code>200</Code>

JSON format 

{
    "RequestId": "F9E4-FDS4-****************",
    "Message": "success",
    "ChangeOrderId": "435f-regfr4********************",
    "Code": 200
}

Error codes

For a list of error codes, visit the API Error Center.