Logstash システムプラグインのインストール - Elasticsearch

プラグインをインストールします。

この操作を呼び出す前に、次の点に注意してください。

インストールするプラグインは、Alibaba Cloud Logstash のシステムデフォルトプラグインリストに含まれている必要があります。外部のオープンソースプラグインはサポートされていません。

デバッグ

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

リクエストヘッダー

GetLogs 操作には操作固有のリクエストヘッダーはなく、共通のリクエストヘッダーのみを使用します。詳細については、「API リファレンス」の「共通 HTTP ヘッダー」トピックの「共通リクエストヘッダー」セクションをご参照ください。

リクエスト構文

POST /openapi/logstashes/{InstanceId}/plugins/system/actions/install HTTP/1.1

リクエストパラメーター

パラメーター	タイプ	位置	必須	例	説明
InstanceId	String	Path	はい	ls-cn-oew1qbgl****	インスタンスの ID。
clientToken	String	Query	いいえ	5A2CFF0E-5718-45B5-9D4D-70B3FF****	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

リクエスト本文

リクエスト本文では、["pluginName1","pluginName2",.."pluginNamen"] 形式でインストールするプラグインの名前も入力する必要があります。例：


[
    "logstash-input-datahub",
    "logstash-input-maxcompute"
]

レスポンスパラメーター

パラメーター	タイプ	例	説明
RequestId	String	F99407AB-2FA9-489E-A259-40CF6DCC4****	リクエストの ID。
Result	String の配列	["logstash-input-datahub", "logstash-input-maxcompute"]	正常にインストールされたプラグインのリスト。

返されるデータには、ヘッダー パラメーターも含まれており、ヘッダー情報が返されることを示します。

例

リクエストの例

POST /openapi/logstashes/ls-cn-oew1qbgl****/plugins/system/actions/install?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
[
    "logstash-input-datahub",
    "logstash-input-maxcompute"
]

成功レスポンスの例

JSON 形式

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

{
  "Result" : [ "logstash-input-datahub", "logstash-input-maxcompute" ],
  "RequestId" : "93DE9165-49A9-455E-AD7E-64B6694F****",
  "Headers" : { }
}

エラーコード

HTTP コード	エラーコード	エラーメッセージ	説明
400	InstanceActivating	Instance is activating.	インスタンスは現在有効化中です。
400	InstanceNotFound	The instanceId provided does not exist.	インスタンスが見つからないため返されたエラーメッセージ。インスタンスの状態を確認してください。

エラーコードのリストについては、API エラーセンターをご覧ください。