调用 TagResources 接口，为资源添加用户标签。 ## 使用说明 * 为同一个资源重复添加相同标签键的标签，则后添加的标签值会自动覆盖之前的标签值。 * 每个资源最多可添加50个用户标签，每次调用该接口最多可添加50个用户标签。 * Tags.N.a类型的参数中，“N”表示标签信息的序号，需按照数字顺序从1开始填写，取值范围为1～20。多个标签之间使用&分隔。 ## 调试 ## 请求参数 |**名称** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |TagResources |要执行的操作，取值为TagResources。 | |Version |String |是 |2020\-04\-01 |API版本信息，当前版本为2020\-04\-01。 | |ResourceType |String |是 |clb |资源的类型，取值如下：|\ | | | | ||\ | | | | |* clb：负载均衡实例。|\ | | | | |* listener：监听器。|\ | | | | |* servergroup：后端服务器组。|\ | | | | |* acl：访问控制。|\ | | | | |* certificate：证书。 | |ResourceIds.N |String |是 |ResourceIds.1=clb\-273sdsdsxxxxxp8u2j\*\*\*\*&ResourceIds.2=clb\-2fe6fszjgeznk5oxruv0u\*\*\*\* |资源的ID。|\ | | | | ||\ | | | | |* 参数 \- N：表示资源 ID的序号，单次调用数量上限50个。|\ | | | | |* 多个资源 ID之间使用&分隔。|\ | | | | |* 您可以调用如下接口获得资源ID：|\ | | | | | * [DescribeLoadBalancers](https://www.volcengine.com/docs/6406/71772)|\ | | | | | * [DescribeListeners](https://www.volcengine.com/docs/6406/71776)|\ | | | | | * [DescribeServerGroups](https://www.volcengine.com/docs/6406/71782)|\ | | | | | * [DescribeAcls](https://www.volcengine.com/docs/6406/71791)|\ | | | | | * [DescribeCertificates](https://www.volcengine.com/docs/6406/71799) | |Tags.N.Key |String |是 |Tags.1.Key=k1&Tags.2.Key=k2 |用户标签的标签键。|\ | | | | ||\ | | | | |* 长度限制为1～128个字符。|\ | | | | |* 大小写敏感，不能以`volc:`或`sys:`的任意大小写组合开头。|\ | | | | |* 不能以空格开头或结尾。|\ | | | | |* 允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（\-）和@。|\ | | | | ||\ | | | | |> 同一资源的标签键不允许重复。如果传入的`Tags.N.Key`与已有标签的标签键重复，则后添加的标签会覆盖原有标签。 | |Tags.N.Value |String |否 |Tags.1.Value=v1&Tags.2.Value=v2 |用户标签的标签值。|\ | | | | ||\ | | | | |* 长度限制为1～256个字符。|\ | | | | |* 大小写敏感，不能以空格开头或结尾。|\ | | | | |* 允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（\-）和@。|\ | | | | ||\ | | | | |> 如果传入该参数，则必须先传入`Tags.N.Key`。 | ## 返回参数 |名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2021062415303301022514515207C4\*\*\*\* |请求ID。 | ## 请求示例 ```json GET /?Action=TagResources&Version=2020-04-01&ResourceType=clb&ResourceIds.1=clb-273sdsdsxxxxxp8u2j****&ResourceIds.2=clb-2fe6fszjgeznk5oxruv0u****&Tags.1.Key=k1&Tags.2.Key=k2&Tags.1.Value=v1&Tags.2.Value=v2 HTTP/1.1 Host: open.volcengineapi.com ServiceName: clb Region: cn-beijing ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "TagResources", "Version": "2020-04-01", "Service": "clb", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/71761)文档。 |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |InvalidIncorrectOrder.Malformed |The specified index order is malformed. |指定的索引顺序参数格式不合法。 | |400 |InvalidResourceType.Malformed |The specified ResourceType is malformed. |指定的 ResourceType 参数格式不合法。 | |400 |InvalidTagKey.Malformed |The specified TagKey is malformed. |指定的 TagKey 参数格式不合法。 | |400 |InvalidTagValue.Malformed |The specified TagValue is malformed. |指定的 TagValue 参数格式不合法。 | |400 |LimitExceeded.Resource |You've reached the limit on the number of resources that you can operate at a time. |已达到单次可操作资源数量的上限。 | |400 |LimitExceeded.ServiceManagedTag |You've reached the limit on the number of service managed tags that you can create. |已达到单次可创建受管资源标签键值数量的上限。 | |400 |LimitExceeded.TagOperation |You've reached the limit on the number of tags that you can operate at a time. |已达到单次可操作的标签条目数量上限。 | |400 |QuotaExceeded.ResourceCustomTags |You've reached the limit on the number of resource tags that you can create. |已达到单个资源可创建用户标签的数量的配额上限。 | |400 |QuotaExceeded.ResourceSystemTags |You've reached the limit on the number of system tags that you can create. |已达到单个资源可创建系统标签的数量的配额上限。 | |403 |Forbidden |You are not authorized to perform operations on the service managed tag. |无权限对指定资源打上受管标签。 | |403 |InvalidResourceType.ServcieManaged |The specified ResourceType is managed by a service. |指定的资源是服务托管资源。 | |404 |InvalidResource.NotFound |The specified resource does not exist. |指定的资源不存在。 |