Bind Tag to Reserved Instance
Updated at：2025-10-20
This API allows you to bind tags to reserved instances. It supports binding multiple tags to multiple reserved instances simultaneously, with a limit of up to 100 reserved instances per request.
Request structure
Plain Text
1PUT /v{version}/bcc/reserved/tag?{action} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4{
5 // List of reserved instance IDs, maximum 100
6"reservedInstanceIds": ["r-HrztSVk0", "r-9lUk0lnI"],
7"changeTags": [
8
9 {
10 "tagKey":"openapi-1",
11 "tagValue":"test"
12 },
13 {
14 "tagKey":"openapi-2",
15 "tagValue":"test"
16 }
17]}
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. |
| action | String | Yes | Query | Action performed on the instance. Current value: bind. |
| reservedInstanceIds | List<String> | Yes | RequestBody | List of reserved instance IDs, with a limit of up to 100 reserved instances per request. |
| changeTags | List<[TagModel](BCC/API Reference/Appendix.md#TagModel)> | Yes | RequestBody | List of tags to be bound. For the specific data format, refer to the[TagModel](BCC/API Reference/Appendix.md#TagModel). |
Response headers
There are no special headers required beyond the common headers.
Response parameters
Request example
Plain Text
1POST http://bcc.bj.baidubce.com/v2/bcc/reserved/tag?bind
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 // List of reserved instance IDs, maximum 100
6 "reservedInstanceIds": ["r-HrztSVk0", "r-9lUk0lnI"],
7 "changeTags": [
8 {
9 "tagKey":"key1",
10 "tagValue":"value1"
11 },
12 {
13 "tagKey":"key2",
14 "tagValue":"value2"
15 }
16 ]
17}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