調用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. | 實例找不到,請核對實例狀態。 |
訪問錯誤中心查看更多錯誤碼。