TagResources - Elasticsearch

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

要求標頭

該介面使用公用要求標頭，無特殊要求標頭。請參見公用請求參數文檔。

請求文法

POST /openapi/tags HTTP/1.1

請求參數

名稱	類型	位置	是否必選	樣本值	描述
	Object	Body	否		要建立的資源及標籤資訊。
ResourceIds	Array of String	Body	是	["es-cn-aaa","es-cn-bbb"]	資源ID列表。採用JSON數組格式，最多支援20個子項。
Tags	Array	Body	是		標籤。最多可建立20個標籤。
key	String	Body	是	env	標籤鍵。
value	String	Body	是	IT	標籤值。
ResourceType	String	Body	是	INSTANCE	資源類型，固定為INSTANCE。

說明

Tags中如果存在key，則必須存在value（可以為空白字串），否則報錯InvalidParameter.TagKey。
當傳入的索引值對重複時，會報錯Duplicate.TagKey。
如果在自訂Tags之前已經存在相同的Tag key，則之前的Tag key的value值會被覆蓋。

返回資料

名稱

類型

樣本值

描述

Result

Boolean

true

返回結果：

true：標籤資源關聯建立成功。
false：標籤資源關聯建立失敗。

RequestId

String

3D8795D9-8FF5-46B2-86E6-E3B407*******

請求ID。

樣本

請求樣本

POST /openapi/tags HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

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

正常返回樣本

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。