This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Migrate to data stream API
editMigrate to data stream API
editConverts an index alias to a data stream.
resp = client.indices.migrate_to_data_stream(
name="my-logs",
)
print(resp)
const response = await client.indices.migrateToDataStream({
name: "my-logs",
});
console.log(response);
POST /_data_stream/_migrate/my-logs
Request
editPOST /_data_stream/_migrate/<alias>
Prerequisites
edit-
If the Elasticsearch security features are enabled, you must have the
manageindex privilege for the index alias. - A matching index template with data stream enabled. See Set up a data stream.
Path parameters
edit-
<alias> -
(Required, string) Name of the index alias to convert to a data stream. The alias must meet the following criteria:
- The alias must have a write index.
-
All indices for the alias have a
@timestampfield mapping of adateordate_nanosfield type. - The alias must not have any filters.
- The alias must not use custom routing.
If successful, the request removes the alias and creates a data stream with the same name. The alias’s indices become hidden backing indices for the stream. The alias’s write index becomes the stream’s write index.