调用 TagResources 接口，为资源添加用户标签。 ## 使用说明每秒最多提交 5 个 API 请求。 ## 调试 ## 请求参数 **Action** `String` %%require%% 示例值：`TagResources` 接口名称。当前 API 的名称为 `TagResources`。 **Version** `String` %%require%% 示例值：`2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **ResourceType** `String` %%require%% 示例值：`loadbalancer` 资源类型。取值如下： * loadbalancer：负载均衡实例。 * listener：监听器。 * servergroup：后端服务器组。 * certificate：证书。 * acl：访问控制策略组。 * healthchecktemplate：健康检查模板。 * customizedcfg：个性化配置。 **ResourceIds.N** `String[]` %%require%% 示例值：`ResourceIds.1=alb-273sdsdsxxxxxp8u2j****&ResourceIds.2=alb-2fe6fszjgeznk5oxruv0u****` 资源的ID。 * 参数 \- N：表示资源 ID的序号，单次调用数量上限50个。 * 多个资源 ID之间使用 & 分隔。 **Tags.N.Key** `String[]` %%require%% 示例值：`Tags.1.Key=k1&Tags.2.Key=k2` 标签的标签键。规则如下： * 长度限制为1～128个字符。 * 大小写敏感，不能以volc:的任意大小写组合开头。 * 不能以空格开头或结尾。 * 允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（\-）和@。 * 同一资源的标签键不允许重复。 **Tags.N.Value** `String[]` %%require%% 示例值：`Tags.1.Value=v1&Tags.2.Value=v2` 标签的标签值。具体规则如下： * 长度限制为0～256个字符。 * 大小写敏感，不能以空格开头或结尾。 * 允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（\-）和@。 * 如果传入该参数，则必须先传入Tags.N.Key。 ## 返回参数 **RequestId** `String` `可选` 示例值：`2021062415303301022514515207C4****` 请求ID。 ## 请求示例 ```JSON GET /?Action=TagResources&ResourceType=loadbalancer&ResourceIds.1=alb-r1rvlqgt58u83dvb46c1j2fi&Tags.1.Key=yxl12&Tags.1.Value=yxl12&Tags.2.Key=yxl13&Tags.2.Value=yxl13&Version=2020-04-01&AccountId=2100052283" -H "X-Top-Account-Id: 2100052283" Host: alb.cn-beijing.volcengineapi.com X-Date: 20251121T094038Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/alb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f ``` ## 返回示例 ```JSON { "ResponseMetadata":{ "RequestId":"a295610f-5602-4ba8-ab73-84158c7b5dd7", "Action":"TagResources", "Version":"2020-04-01" }, "Result":{ "RequestId":"a295610f-5602-4ba8-ab73-84158c7b5dd7" } } ``` ## 错误码如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/113579)。 |**状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |400 |LimitExceed.Tag |You've reached the limit on the number of tags that you can operate at a time. |已达到单次可操作的标签的数量上限。 | |400 |InvalidResourceType.Malformed |The specified ResourceType is malformed. |指定的 ResourceType 参数格式不合法。 | |400 |LimitExceed.Resource |You've reached the limit on the number of resources that you can operate at a time. |已达到单次可操作的资源的数量上限。 | |400 |MissingParameter |The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, 'Tags'. |该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如: Tags。 | |400 |InvalidIndexOrder.Malformed |The specified index order is malformed. |指定的索引顺序参数格式不合法。 | |400 |InvalidTags.Key.Malformed |The specified Tags.Key is malformed. |指定的 Tags.Key 参数格式不合法。 | |400 |InvalidTags.Value.Malformed |The specified Tags.Value is malformed. |指定的 Tags.Value 参数格式不合法。 | |400 |InvalidTags.Key.Duplicated |The specified Tags.Key is duplicated. |指定的 Tags.Key 重复。 | |404 |InvalidResource.NotFound |The specified Resource does not exist. |指定的资源不存在。 |