You need to enable JavaScript to run this app.
导航
容器服务
  • 文档首页
    • /
  • 容器服务

TagResources

最近更新时间：2024.02.26 20:17:37

首次发布时间：2022.12.07 17:14:42

我的收藏

为指定的资源绑定标签。

使用说明

  • 当为资源绑定标签时，如果 Key 不存在，则为其新建一个标签；如果已存在相同 Key 的标签，则更新对应标签的 Value。
  • 标签分为用户自定义标签与系统标签。目前只允许为资源绑定自定义标签。
  • 每个资源可绑定的自定义标签上限为 50 个。

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见 公共参数。

参数名称类型是否必选示例值描述
ActionString是TagResources公共参数，本接口值：TagResources。
VersionString是2022-05-12公共参数，本接口值：2022-05-12。

ResourceType

String

是

Cluster

绑定标签的资源类型。当前仅支持为集群和节点池绑定资源标签：

  • Cluster：集群
  • NodePool：节点池

ResourceIds

Array of String

是

["cc5silumrsfeq****"]

资源 ID 列表，即集群 ID 列表或节点池 ID 列表。
可以调用 ListClusters 接口获取集群 ID，调用 ListNodePools 接口获取节点池 ID。

注意

  • 传入多个资源 ID 时，ID 不可重复。
  • 最多传入 50 个资源 ID。

Tags

Array of Tag

是

资源绑定标签信息。

  • Tags 中各个 Key 不可重复。
  • 资源已有相同 Tags.Key 的情况下，重复绑定 Tags.Key 不会报错，会更新为最新的 Tags.Value。
  • 单个资源最多支持绑定50个 Tags。
  • Tags 中的 Key、Value 不允许在最前或最后输入空格。

请求示例

POST /?Action=TagResources&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
    {
    "ResourceType": "Cluster",
    "ResourceIds": [
        "cc5silumrsfeq****"
    ],
    "Tags": [
        {
            "Key": "key",
            "Value": "value"
        }
    ]
}

返回参数

本接口无专有返回参数，公共返回参数请参见 返回结果。

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "021635330810134****",
        "Action": "TagResources",
        "Version": "2022-05-12",
        "Service": "vke",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

本接口错误码如下表所示，公共错误码请参见 公共错误码。

HTTP状态码错误码错误信息描述
400QuotaExceeded.{{ResourceType}}The quota of {{ResourceType}} has reached the limit.创建标签资源达到系统限额。