Change the instance VPC
Updated at：2025-10-20
This API is used to change the VPC of an instance.
- EBC instances do not support VPC changes while in a stopped state.
Request structure
Plain Text
1PUT /v{version}/vpc/changeVpc?clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4{
5 "instanceId": instanceId,
6 "subnetId": subnetId,
7 "internalIp": internalIp,
8 "securityGroupIds": [securityGroupId],
9 "reboot": reboot
10}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number. |
| clientToken | String | Yes | Query | Idempotence Token, which is an ASCII string with a length not exceeding 64 bits. For details, see the [Idempotence ](BCC/API Reference/General Description.md#Idempotence). |
| instanceId | String | Yes | RequestBody | Virtual machine ID |
| subnetId | String | Yes | RequestBody | Subnet ID of the target VPC |
| internalIp | String | No | RequestBody | Internal IP address |
| securityGroupIds | List | No | RequestBody | Security group list |
| enterpriseSecurityGroupIds | List | No | RequestBody | List of enterprise security groups. Both regular and enterprise security groups cannot be specified simultaneously |
Response headers
There are no special headers required beyond the common headers.
Response parameters
No parameters
Request example
Plain Text
1PUT http://bcc.bj.baidubce.com/v2/vpc/changeVpc?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "instanceId": "i-sj7rj9Gu",
6 "subnetId": "a0k74h216-b6f7-47fe-a4d6-4f3wjg7543f",
7 "securityGroupIds": ["7ef30e08-4cea-550a-9d61-3201496b3dc7"]
8}Response example
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS