绑定和解绑实例标签
更新时间：2026-06-18
描述
本接口用于修改 RapidFS 缓存实例的标签绑定关系，采用全量覆盖的更新策略，具体规则如下：
- 全量提交：每次请求需传入资源的完整标签集合。例如，若资源原有 3 个标签，需删除 1 个并新增 2 个，包含剩余 2 个旧标签和 2 个新标签在内的的 4 个标签组成的列表；
- 清空标签：若传入空列表（tags=[]），系统将解除该资源的所有标签绑定；
- 如果传入的是新的标签，会新建该标签并绑定到实例；
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
使用该接口时，需要注意以下事项：
- 标签更新后，监控及账单系统可能需 1-10 分钟同步数据；
- 单次请求建议绑定不超过100 个资源，上限为 1000 个，超出可能引发接口超时或性能下降；
- 若在业务中标签被用于权限策略（如 IAM），修改后请及时检查业务影响；
请求结构
Plain Text
1POST /v{version}/tag?action=CreateAndAssignTag&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "tagResources": [
7 {
8 "instanceId": "rapidfs-6MlqHdszZuJH",
9 "tags": [
10 {
11 "tagKey": "key",
12 "tagValue": "value"
13 }
14 ]
15 }
16 ]
17}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | Query参数 | 保证API调用的幂等性 |
| tagResources | List<TagResource> | 是 | RequestBody参数 | 需要修改的实例及标签信息，支持批量修改，见数据类型 TagResource，仅支持 RapidFS 实例绑定标签 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无
请求示例
Plain Text
1POST /v2/tag?action=CreateAndAssignTag&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "tagResources": [
6 {
7 "instanceId": "rapidfs-6MlqHdszZuJH",
8 "tags": [
9 {
10 "tagKey": "key",
11 "tagValue": "value"
12 }
13 ]
14 }
15 ]
16}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4{}评价此篇文章