調用InstallLogstashSystemPlugin,安裝插件。

調用該接口前,請注意:

待安裝的插件必須包含在阿里云Logstash的系統默認插件列表中,不支持外部開源插件。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求頭

該接口使用公共請求頭,無特殊請求頭。請參見公共請求參數文檔。

請求語法

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

用于保證請求的冪等性。由客戶端生成該參數值,要保證在不同請求間唯一,最大不超過64個ASCII字符。

RequestBody

RequestBody中還需填入待安裝的插件名稱,格式為["pluginName1","pluginName2",...,"pluginNamen"],示例如下。


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

返回數據

名稱 類型 示例值 描述
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC4****

請求ID。

Result Array of String ["logstash-input-datahub", "logstash-input-maxcompute"]

安裝成功的插件列表。

返回數據中還包含Headers參數,表示返回頭信息。

示例

請求示例

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" : { }
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InstanceActivating Instance is activating. 實例目前處于生效中。
400 InstanceNotFound The instanceId provided does not exist. 實例找不到,請核對實例狀態。

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