Call the CreatePipelines to create a Logstash pipeline.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. You can use OpenAPI Explorer to search for API operations, call API operations, and dynamically generate SDK sample code.

Request header

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

Request syntax

POST /openapi/logstashes/[InstanceId]/pipelines HTTPS|HTTP

Request parameters

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

The ID of the Logstash instance.

trigger Boolean No false

Indicates whether to deploy immediately.

ClientToken String No 5A2CFF0E-5718-45B5-9D4D-70B3FF****

A unique token generated by the client to guarantee the idempotency of the request. The value of this parameter is generated by the client and is unique among different requests. The maximum length is 64 ASCII characters.

RequestBody

To specify the pipeline information, you must enter the following parameters in RequestBody:

Parameter

Type

Required

Example

Description

pipelineId

String

Yes

pipeline-test

The ID of the pipeline.

description

String

No

this is a test

The description of the pipeline.

config

String

Yes

input { } filter { } output { }

The specific configuration of the pipeline.

workers

Integer

No

2

The number of pipeline workers.

batchSize

Integer

No

125

Pipeline batch size.

batchDelay

Integer

No

50

Pipeline batch delay.

queueType

String

No

MEMORY

The type of the queue. Valid values: MEMORY and PERSISTED.

pipelineStatus

String

No

RUNNING

The status of the pipeline. Valid values: NOT_DEPLOYED, RUNNING, and DELETED. This parameter is required when the trigger parameter is set to true.

queueMaxBytes

Integer

No

1024

The maximum number of bytes in the queue.

queueCheckPointWrites

Integer

No

1024

The number of queue checkpoint writes.

Sample code:

[{
    "pipelineId":"test",
    "config":"input {\n\n}\nfilter {\n\n}\noutput {\n\n}"
}]

Response parameters

Parameter Type Example Description
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

The ID of the request.

Result Boolean true

Returned results:

  • true: creation succeed
  • false: creation failed

Examples

Sample requests

POST /openapi/logstashes/logstashes/ls-cn-oew1qbgl****/pipelines?trigger=false HTTP/1.1
common request headers
 [{
    "pipelineId":"test",
    "config":"input {\n\n}\nfilter {\n\n}\noutput {\n\n}"
}]

Sample success responses

XML format

<Result>true</Result>
<RequestId>732A60FB-1899-4466-83D2-E96DA455****</RequestId>

JSON Syntax

{
	"Result": true,
	"RequestId": "732A60FB-1899-4466-83D2-E96DA455****"
}

Error code

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