全量更新资源的绑定关系
更新时间：2021-05-07
描述
- 本接口用于更新资源与标签的绑定关系
- 传参是需传入资源的全量标签信息，如原有3个标签，现删除1个标签的情况下新增2个标签，则应传入全量4个标签
请求
请求结构
POST /v{version}/tag?createAndAssign HTTP/1.1
Authorization: bce-auth-v1/f0c3d360f64211e8acd0d73d11c152de/2018-12-02T16:00:00Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/c022ed024e2cc6cc743858b16efc2ea19c090cb575f3b08b46071be98118a919
{
"resources": [
{
"serviceType": "BLB",
"resourceId": "lb-db523ce9",
"associationType": "floating",
"region": "bj",
"tags": [
{
"tagValue": "value",
"tagKey": "key"
}
]
}
]
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 示例值 |
|---|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 | 1 |
| createAndAssign | - | 必选 | Query参数 | 接口标记 | - |
| resources | List<ResouceWithTag> | 必须 | RequestBody参数 | 资源及对应标签 | - |
返回
返回头域
除公共头域，无其它特殊头域。
返回参数
无
错误码
无特殊返回错误码
示例
请求示例
POST /v{version}/tag?createAndAssign HTTP/1.1
Authorization: bce-auth-v1/f0c3d360f64211e8acd0d73d11c152de/2018-12-02T16:00:00Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/c022ed024e2cc6cc743858b16efc2ea19c090cb575f3b08b46071be98118a919
{
"resources": [
{
"serviceType": "BLB",
"resourceId": "lb-db523ce9",
"associationType": "floating",
"region": "bj",
"tags": [
{
"tagValue": "value",
"tagKey": "key"
}
]
}
]
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Bce-Request-Id: b45001e8-6957-44af-b93d-a4880e61398cModel对象定义
ResouceWithTag
| 参数名称 | 类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| serviceType | string | 必须 | 服务类型 | BLB |
| resourceId | string | 必须 | 资源ID | lb-db523ce9 |
| associationType | string | 必须 | 关联类型，填写floating即可 | floating |
| region | string | 必须 | 资源所在region，全局服务可填global | bj |
| tags | List<Tag> | 必须 | 资源的全量标签信息 | - |
Tag
| 参数名称 | 类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| tagValue | string | 必须 | 标签的值，可包含大小写字母、数字、中文以及-_ /.特殊字符，长度0-65 | value |
| tagKey | string | 必须 | 标签的键，可包含大小写字母、数字、中文以及-_ /.特殊字符，长度1-65 | key |