Type to search.

Enable a named stream

  • POST /_streams/{name}/_enable
Auth The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Experimental since 9.1 This functionality is experimental and is not ready for production usage. Experimental features may change or be removed at any time. Elastic will work to fix any issues, but experimental features are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Turn on the named stream feature for this cluster.

Note

To protect existing data, this feature can be turned on only if the cluster does not have existing indices or data streams that match the pattern <name>|<name>.* for the enabled stream type name. If those indices or data streams exist, a 409 - Conflict response and error is returned.

Required privileges

Cluster privileges manage

Path parameters

name enum required

The stream type to enable.

Supported values include:

  • logs: The logs stream type.
  • logs.otel: The logs.otel stream type, meant for OTel-formatted data.
  • logs.ecs: The logs.ecs stream type, meant for ECS-formatted data.
Values: logs logs.otel logs.ecs

Query parameters

master_timeout union oneOf · default: 30s

The period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.

Values: -1 0
timeout union oneOf · default: 30s

The period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

Values: -1 0

Responses

application/json
acknowledged boolean required

For a successful response, this value is always true. On failure, an exception is returned instead.