Create data stream APIedit

Creates a new data stream.

Data streams require a matching index template. See Set up a data stream.

PUT /_data_stream/my-data-stream

Requestedit

PUT /_data_stream/<data-stream>

Prerequisitesedit

  • If the Elasticsearch security features are enabled, you must have the create_index or manage index privilege for the data stream.

Path parametersedit

<data-stream>

(Required, string) Name of the data stream to create.

Data stream names must meet the following criteria:

  • Lowercase only
  • Cannot include \, /, *, ?, ", <, >, |, ` ` (space character), ,, #, :
  • Cannot start with -, _, +, .
  • Cannot be . or ..
  • Cannot be longer than 255 bytes (note it is bytes, so multi-byte characters will count towards the 255 limit faster)