Queries the detailed information of all plug-ins or a specified plug-in.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only the common request header. For more information, see Common request parameters.

Request syntax

     GET /openapi/logstashes/[InstanceId]/plugins HTTP/1.1 

Request parameters

Parameter Type Position Required Example Description
InstanceId String Path Yes ls-cn-oew1qbgl****

The ID of the instance.

name String Query No logstash-filter-clone

The name of the plug-in.

page Integer Query No 10

The number of pages in the plug-in list. Default value: 1, minimum value: 1, maximum value: 200.

size Integer Query No 3

The number of entries to return on each page. Minimum value: 1, maximum value: 200.

source String Query No USER

The source of the plug-in. Valid values:

  • USER: custom plug-ins
  • SYSTEM: system preset plug-in

Response parameters

Parameter Type Example Description
RequestId String 99407AB-2FA9-489E-A259-40CF6DCC****

The ID of the request.

Result Array of Result

The return results.

description String The clone filter is for duplicating events.

The description of the plug-in.

name String logstash-filter-clone

The name of the plug-in.

source String SYSTEM

The source of the plug-in.

specificationUrl String https://xxx.html

The description document address of the plug-in.

state String INSTALLED

The status of the plug-in.

The following parameters are also included in the returned data.







The header of the response.




The number of returned plug-ins.

Note └ indicates a child parameter.


Sample requests

     GET /openapi/logstashes/ls-cn-oew1qbgl****/plugins?name=logstash-filter-clone&page=10&size=3 HTTP/1.1 public request header 

Sample success responses

JSON format

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

Error codes

HttpCode Error code Error message Description
400 InstanceNotFound The instanceId provided does not exist. The instance cannot be found. Please check the instance status.

For a list of error codes, visit the API Error Center.