TagResources - Elasticsearch - Alibaba Cloud ドキュメントセンター

リソースにタグを追加します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。利便性を高めるために、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。詳細については、「共通のリクエストヘッダー」をご参照ください。

リクエスト構文

POST /openapi/tags HTTP/1.1

リクエストパラメーター

パラメーター	タイプ	位置	必須	例	説明
	Object	Body	No		クラスターとタグに関する情報。
ResourceIds	String の配列	Body	Yes	["es-cn-aaa","es-cn-bbb"]	リソース ID。 JSON 配列を使用して ID を指定します。最大 20 個の ID を指定できます。
Tags	配列	Body	Yes		インスタンスのタグ。最大 20 個のタグを作成できます。
key	String	Body	Yes	env	タグのキー。
value	String	Body	Yes	IT	タグの値。
ResourceType	String	Body	Yes	INSTANCE	リソースタイプ。値を INSTANCE に設定します。

説明

key パラメーターを設定する場合、value パラメーターも設定する必要があります。そうしないと、InvalidParameter.TagKey エラーが報告されます。 value パラメーターには空の文字列を指定できます。
重複するキーと値のペアが指定されている場合、Duplicate.TagKey エラーが報告されます。
指定したタグキーがすでに存在する場合、指定したタグ値は既存のタグ値を上書きします。

レスポンスパラメーター

パラメーター

タイプ

例

説明

Result

ブール値

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****"
}

HTTP ステータスコード

エラーコードのリストについては、「サービスエラーコード」をご参照ください。