HTTP Post

HTTP Post (http-post)

POST event data to an HTTPS server.

Contents

• Fields

Fields

Field	Type	Required	Description
batch	Batch		Collect Input Events together into batches.
url	url (string)	✅	The URL may contain ${} field expansions.
body-field	event-field (string)		This field will contain the body of the request.
headers	string		HTTP headers of the request.
retry	Retry		How to retry failed requests.
insecure	boolean (bool)		Ignore TLS certificate validation errors (This is unsafe to use).
method	Method		HTTP method to use for the query (either ‘get’ or ‘post’).

Batch Fields

Field	Type	Required	Description
fixed-size	integer		maximum number of events in an output batch.
mode	symbol	✅	If ‘document’ send on end of document generated by input. If ‘fixed’, use fixed_size.
timeout	string	✅	interval after which the batch is sent, to keep throughput going (default 100ms).
header	string		put a header line before the batch.
footer	string		put a header line after the last line of the batch.
use-document-marker	bool		Enrich the job metadata with a document marker (for document handling in batch mode).
wrap-as-json	bool		Format the output batch as a JSON array.

Retry Fields

Field	Type	Required	Description
count	integer		The number of retry attempts. If unspecified, retries will continue indefinitely.
pause	string		How long to pause before re-trying.

Method Options

Value	Name	Description
get	get	Get
post	post	Post
put	put	Put
patch	patch	Patch
delete	delete	Delete
options	options	Options
head	head	Head