调用TagResources,创建标签资源关系。

注意 只能操作用户标签。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

请求语法

POST|PATCH /openapi/tags HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
Resource_Ids String ["es-cn-aaa","es-cn-bbb"]

要删除的实例ID列表。

ResourceType String INSTANCE

资源类型定义,固定值为INSTANCE

Tags String [{"key":"env","value":"IT"}]

对应新增的标签列表,最多包含20个子项。

  • 除了必传参数,Tags中键值对如果存在Key,则必须存在Value,可以为空字符串,否则报错InvalidParameter.TagKey。
  • 当传入的键值对有重复时,重复的Key报错Duplicate.TagKey。
  • 如果在自定义Tag之前已经存在传入的资源及Tag Key,则覆盖之前的Tag Value。

返回数据

名称 类型 示例值 描述
RequestId String 3D8795D9-8FF5-46B2-86E6-E3B407*****

请求ID。

示例

请求示例

{
  "ResourceType":"INSTANCE",
  "ResourceIds":["es-cn-78v1g8t6t00****"],
  "Tags":[{"key":"env","value":"IT"}]
}

正常返回示例

XML 格式

<RequestId>B576F68B-F2B9-4111-941C-4156A****</RequestId>
<TagResources>
    <TagResource>
        <ResourceType>ALIYUN::ELASTICSEARCH::INSTANCE</ResourceType>
        <ResourceId>es-cn-78v1g8t6t00****</ResourceId>
        <TagKey>dep</TagKey>
        <TagValue>IT</TagValue>
    </TagResource>
    <TagResource>
        <ResourceType>ALIYUN::ELASTICSEARCH::INSTANCE</ResourceType>
        <ResourceId>es-cn-78v1g8t6t00****</ResourceId>
        <TagKey>env</TagKey>
        <TagValue>IT</TagValue>
    </TagResource>
</TagResources>

JSON 格式

{
    "RequestId": "B576F68B-F2B9-4111-941C-4156A****",
    "TagResources": {
        "TagResource": [
            {
                "ResourceType": "ALIYUN::ELASTICSEARCH::INSTANCE",
                "ResourceId": "es-cn-78v1g8t6t00****",
                "TagKey": "dep",
                "TagValue": "IT"
            },
            {
                "ResourceType": "ALIYUN::ELASTICSEARCH::INSTANCE",
                "ResourceId": "es-cn-78v1g8t6t00****",
                "TagKey": "env",
                "TagValue": "IT"
            }
        ]
    }
}

错误码

访问错误中心查看更多错误码。