TagResources - 检索分析服务Elasticsearch版

调试

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

请求头

https://elasticsearch.cn-hangzhou.aliyuncs.com/openapi/tags

请求语法

POST /openapi/tags HTTP/1.1

请求参数

请求参数为空，但需填写RequestBody。

RequestBody中需要填入以下参数，用来定义要创建的资源及标签。


参数	类型	是否必须	示例值	描述
ResourceIds	Array	是	["es-cn-aaa","es-cn-bbb"]	资源ID。
Tags	Array	是	[{"key":"env","value":"IT"}]	新增的标签列表，最多包含20个子项。
ResourceType	String	是	INSTANCE	资源类型，固定为INSTANCE。

说明

除了必传参数，Tags中如果存在key，则必须存在value（可以为空字符串），否则报错InvalidParameter.TagKey。
当传入的键值对重复时，会报错Duplicate.TagKey。
如果在自定义Tags之前已经存在传入的Tag key，则之前的Tag key的value值会被覆盖。

示例如下。


{
    "ResourceIds":["es-cn-oew1q8bev0002****","es-cn-09k1ptccp0009****"],
    "Tags": [
        {
            "key": "env",
            "value": "IT"
        }
    ],
    "ResourceType": "INSTANCE"
}

返回数据


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

返回参数中还包括Result参数，为Boolean类型。返回true表示标签资源关系创建成功，返回false表示创建失败。

示例

请求示例

POST /openapi/tags HTTP/1.1
公共请求头
{
    "ResourceIds":["es-cn-oew1q8bev0002****","es-cn-09k1ptccp0009****"],
    "Tags": [
        {
            "key": "env",
            "value": "IT"
        }
    ],
    "ResourceType": "INSTANCE"
}

正常返回示例

JSON格式

{
	"Result": true,
	"RequestId": "27627E6B-E26A-406F-B6E1-0247882C****"
}

错误码


HttpCode	错误码	错误信息	描述
400	InstanceNotFound	The instanceId provided does not exist.	实例找不到，请核对实例状态。

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