Modify data streams API

edit

Performs one or more data stream modification actions in a single atomic operation.

resp = client.indices.modify_data_stream(
    actions=[
        {
            "remove_backing_index": {
                "data_stream": "my-logs",
                "index": ".ds-my-logs-2099.01.01-000001"
            }
        },
        {
            "add_backing_index": {
                "data_stream": "my-logs",
                "index": "index-to-add"
            }
        }
    ],
)
print(resp)
const response = await client.indices.modifyDataStream({
  actions: [
    {
      remove_backing_index: {
        data_stream: "my-logs",
        index: ".ds-my-logs-2099.01.01-000001",
      },
    },
    {
      add_backing_index: {
        data_stream: "my-logs",
        index: "index-to-add",
      },
    },
  ],
});
console.log(response);
POST _data_stream/_modify
{
  "actions": [
    {
      "remove_backing_index": {
        "data_stream": "my-logs",
        "index": ".ds-my-logs-2099.01.01-000001"
      }
    },
    {
      "add_backing_index": {
        "data_stream": "my-logs",
        "index": "index-to-add"
      }
    }
  ]
}

Request

edit

POST /_data_stream/_modify

Request body

edit
actions

(Required, array of objects) Actions to perform.

Properties of actions objects
<action>

(Required, object) The key is the action type. At least one action is required.

Valid <action> keys
add_backing_index
Adds an existing index as a backing index for a data stream. The index is hidden as part of this operation.

Adding indices with the add_backing_index action can potentially result in improper data stream behavior. This should be considered an expert level API.

remove_backing_index
Removes a backing index from a data stream. The index is unhidden as part of this operation. A data stream’s write index cannot be removed.

The object body contains options for the action.

Properties of <action>
data_stream
(Required*, string) Data stream targeted by the action.
index
(Required*, string) Index for the action.