Unbind a tag from an instance
Updated at：2025-10-20
This API is used to unbind tags from an associated instance.
- You can unbind multiple tags at the same time.
Request structure
Plain Text
1PUT /v{version}/instance/{instanceId}/tag?{action} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "changeTags": [
7 {
8 "tagKey" : tagKey,
9 "tagValue": tagValue
10 }
11 ]
12}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| instanceId | String | Yes | RequestBody | Virtual machine instance ID |
| action | String | Yes | Query | Action performed on the instance, current value: unbind |
| attachRelatedResourceTag | boolean | No | RequestBody | Specify whether tags of associated resources, such as CDS system disks, data disks, EIPs, snapshots, and snapshot chains, should also be unbound. True means the associated resources will also be unbound; false means they will not. If not specified, the default is False. |
| changeTags | List<[TagModel](BCC/API Reference/Appendix.md#TagModel)> | Yes | RequestBody | List of tags to be unbound. For the specific data format, refer to the following [TagModel](BCC/API Reference/Appendix.md#TagModel) |
Response headers
No special headers are required beyond the standard ones.
Response parameters
No special response parameters are available.
Request example
Plain Text
1PUT /v2/instance/i-yect8WnR/tag?unbind HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "changeTags": [
7 {
8 "tagKey" : "company",
9 "tagValue": "bd"
10 }
11 ]
12}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS