IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
Elastic Docs ›Elasticsearch Guide [7.10] ›REST APIs ›Data stream APIs
« Data stream APIs Delete data stream API »

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.

We recommend using the Elastic data stream naming scheme. 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)
« Data stream APIs Delete data stream API »