调用ListLogstashPlugins,获取所有或指定插件的详细信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

GET /openapi/logstashes/{InstanceId}/plugins HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
InstanceId String Path ls-cn-oew1qbgl****

实例ID。

name String Query logstash-filter-clone

插件名称。

page Integer Query 10

插件列表的分页数。默认值:1,最小值:1,最大值:200。

size Integer Query 3

分页查询时设置的每页条数。最小值:1,最大值:200。

source String Query USER

插件来源。可选值:

  • USER:自定义插件
  • SYSTEM:系统预置插件

返回数据

名称 类型 示例值 描述
RequestId String 99407AB-2FA9-489E-A259-40CF6DCC****

请求ID。

Result Array of Result

返回结果。

description String The clone filter is for duplicating events.

插件描述。

specificationUrl String https://xxx.html

插件的说明文档地址。

state String INSTALLED

插件的状态。支持:

  • INSTALLED:已安装
  • UNINSTALLED:未安装
  • INSTALLING:安装中
  • UNINSTALLING:卸载中
  • UPGRADING:升级中
  • FAILED:安装失败
  • UNKNOWN:集群失联无法获取到创建状态
source String SYSTEM

插件来源。

name String logstash-filter-clone

插件名称。

返回数据中还包含以下参数。

名称

类型

示例值

描述

Headers

Struct

返回头信息。

└X-Total-Count

Integer

131

返回的插件数量。

说明 └表示子参数。

示例

请求示例

GET /openapi/logstashes/ls-cn-oew1qbgl****/plugins?name=logstash-filter-clone&page=10&size=3&source=USER HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

正常返回示例

JSON格式

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

{
  "Result" : [ {
    "name" : "logstash-filter-clone",
    "state" : "INSTALLED",
    "source" : "SYSTEM",
    "description" : "The clone filter is for duplicating events. A clone will be created for each type in the clone list.",
    "specificationUrl" : "https://www.elastic.co/guide/en/logstash/6.7/plugins-filters-clone.html"
  }, {
    "name" : "logstash-filter-csv",
    "state" : "INSTALLED",
    "source" : "SYSTEM",
    "description" : "The CSV filter takes an event field containing CSV data, parses it, and stores it as individual fields (can optionally specify the names). This filter can also parse data with any separator, not just commas.",
    "specificationUrl" : "https://www.elastic.co/guide/en/logstash/6.7/plugins-filters-csv.html"
  }, {
    "name" : "logstash-filter-date",
    "state" : "INSTALLED",
    "source" : "SYSTEM",
    "description" : "The date filter is used for parsing dates from fields, and then using that date or timestamp as the logstash timestamp for the event.",
    "specificationUrl" : "https://www.elastic.co/guide/en/logstash/6.7/plugins-filters-date.html"
  } ],
  "RequestId" : "40C0570B-AB40-48BA-8CAE-66EA230A****",
  "Headers" : {
    "X-Total-Count" : 131
  }
}

错误码

访问错误中心查看更多错误码。