From 8822ec09d46c337ad46429fc74cd315a6b928cad Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Thu, 23 Jan 2025 18:07:33 +0400 Subject: [PATCH] Move migrate APIs to indices namespace (#3579) (#3582) (cherry picked from commit c15f4cf66e0ddb5120a95fadfeaca04e7644ecbf) --- output/openapi/elasticsearch-openapi.json | 684 ++++---- output/schema/schema-serverless.json | 226 +-- output/schema/schema.json | 1451 +++++++++-------- output/typescript/types.ts | 138 +- ...on => indices.cancel_migrate_reindex.json} | 2 +- ...ate_from.json => indices.create_from.json} | 2 +- ...> indices.get_migrate_reindex_status.json} | 2 +- ...ndex.json => indices.migrate_reindex.json} | 2 +- .../MigrateCancelReindexRequest.ts | 2 +- .../MigrateCancelReindexResponse.ts | 0 .../create_from/MigrateCreateFromRequest.ts | 2 +- .../create_from/MigrateCreateFromResponse.ts | 0 .../MigrateGetReindexStatusRequest.ts | 2 +- .../MigrateGetReindexStatusResponse.ts | 0 .../migrate_reindex}/MigrateReindexRequest.ts | 2 +- .../MigrateReindexResponse.ts | 0 16 files changed, 1278 insertions(+), 1237 deletions(-) rename specification/_json_spec/{migrate.cancel_reindex.json => indices.cancel_migrate_reindex.json} (95%) rename specification/_json_spec/{migrate.create_from.json => indices.create_from.json} (97%) rename specification/_json_spec/{migrate.get_reindex_status.json => indices.get_migrate_reindex_status.json} (94%) rename specification/_json_spec/{migrate.reindex.json => indices.migrate_reindex.json} (96%) rename specification/{migrate/cancel_reindex => indices/cancel_migrate_reindex}/MigrateCancelReindexRequest.ts (96%) rename specification/{migrate/cancel_reindex => indices/cancel_migrate_reindex}/MigrateCancelReindexResponse.ts (100%) rename specification/{migrate => indices}/create_from/MigrateCreateFromRequest.ts (98%) rename specification/{migrate => indices}/create_from/MigrateCreateFromResponse.ts (100%) rename specification/{migrate/get_reindex_status => indices/get_migrate_reindex_status}/MigrateGetReindexStatusRequest.ts (95%) rename specification/{migrate/get_reindex_status => indices/get_migrate_reindex_status}/MigrateGetReindexStatusResponse.ts (100%) rename specification/{migrate/reindex => indices/migrate_reindex}/MigrateReindexRequest.ts (97%) rename specification/{migrate/reindex => indices/migrate_reindex}/MigrateReindexResponse.ts (100%) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 65b09f2c49..544b5336d9 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -11445,6 +11445,41 @@ } } }, + "/_migration/reindex/{index}/_cancel": { + "post": { + "tags": [ + "migration" + ], + "summary": "This API cancels a migration reindex attempt for a data stream or index", + "operationId": "indices-cancel-migrate-reindex", + "parameters": [ + { + "in": "path", + "name": "index", + "description": "The index or data stream name", + "required": true, + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Indices" + }, + "style": "simple" + } + ], + "responses": { + "200": { + "description": "", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/_types:AcknowledgedResponseBase" + } + } + } + } + }, + "x-state": "Technical preview" + } + }, "/_cache/clear": { "post": { "tags": [ @@ -12242,6 +12277,58 @@ "x-state": "Added in 7.9.0" } }, + "/_create_from/{source}/{dest}": { + "put": { + "tags": [ + "migration" + ], + "summary": "This API creates a destination from a source index", + "description": "It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", + "operationId": "indices-create-from", + "parameters": [ + { + "$ref": "#/components/parameters/indices.create_from#source" + }, + { + "$ref": "#/components/parameters/indices.create_from#dest" + } + ], + "requestBody": { + "$ref": "#/components/requestBodies/indices.create_from" + }, + "responses": { + "200": { + "$ref": "#/components/responses/indices.create_from#200" + } + }, + "x-state": "Technical preview" + }, + "post": { + "tags": [ + "migration" + ], + "summary": "This API creates a destination from a source index", + "description": "It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", + "operationId": "indices-create-from-1", + "parameters": [ + { + "$ref": "#/components/parameters/indices.create_from#source" + }, + { + "$ref": "#/components/parameters/indices.create_from#dest" + } + ], + "requestBody": { + "$ref": "#/components/requestBodies/indices.create_from" + }, + "responses": { + "200": { + "$ref": "#/components/responses/indices.create_from#200" + } + }, + "x-state": "Technical preview" + } + }, "/_data_stream/_stats": { "get": { "tags": [ @@ -14118,6 +14205,89 @@ } } }, + "/_migration/reindex/{index}/_status": { + "get": { + "tags": [ + "migration" + ], + "summary": "This API returns the status of a migration reindex attempt for a data stream or index", + "operationId": "indices-get-migrate-reindex-status", + "parameters": [ + { + "in": "path", + "name": "index", + "description": "The index or data stream name", + "required": true, + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Indices" + }, + "style": "simple" + } + ], + "responses": { + "200": { + "description": "", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "start_time": { + "$ref": "#/components/schemas/_types:DateTime" + }, + "start_time_millis": { + "$ref": "#/components/schemas/_types:EpochTimeUnitMillis" + }, + "complete": { + "type": "boolean" + }, + "total_indices_in_data_stream": { + "type": "number" + }, + "total_indices_requiring_upgrade": { + "type": "number" + }, + "successes": { + "type": "number" + }, + "in_progress": { + "type": "array", + "items": { + "$ref": "#/components/schemas/indices.get_migrate_reindex_status:StatusInProgress" + } + }, + "pending": { + "type": "number" + }, + "errors": { + "type": "array", + "items": { + "$ref": "#/components/schemas/indices.get_migrate_reindex_status:StatusError" + } + }, + "exception": { + "type": "string" + } + }, + "required": [ + "start_time_millis", + "complete", + "total_indices_in_data_stream", + "total_indices_requiring_upgrade", + "successes", + "in_progress", + "pending", + "errors" + ] + } + } + } + } + }, + "x-state": "Technical preview" + } + }, "/_settings": { "get": { "tags": [ @@ -14398,6 +14568,39 @@ } } }, + "/_migration/reindex": { + "post": { + "tags": [ + "migration" + ], + "summary": "\"This API reindexes all legacy backing indices for a data stream", + "description": "It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task", + "operationId": "indices-migrate-reindex", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/indices.migrate_reindex:MigrateReindex" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/_types:AcknowledgedResponseBase" + } + } + } + } + }, + "x-state": "Technical preview" + } + }, "/_data_stream/_migrate/{name}": { "post": { "tags": [ @@ -17993,209 +18196,6 @@ "x-state": "Added in 1.3.0" } }, - "/_migration/reindex/{index}/_cancel": { - "post": { - "tags": [ - "migration" - ], - "summary": "This API cancels a migration reindex attempt for a data stream or index", - "operationId": "migrate-cancel-reindex", - "parameters": [ - { - "in": "path", - "name": "index", - "description": "The index or data stream name", - "required": true, - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Indices" - }, - "style": "simple" - } - ], - "responses": { - "200": { - "description": "", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/_types:AcknowledgedResponseBase" - } - } - } - } - }, - "x-state": "Technical preview" - } - }, - "/_create_from/{source}/{dest}": { - "put": { - "tags": [ - "migration" - ], - "summary": "This API creates a destination from a source index", - "description": "It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", - "operationId": "migrate-create-from", - "parameters": [ - { - "$ref": "#/components/parameters/migrate.create_from#source" - }, - { - "$ref": "#/components/parameters/migrate.create_from#dest" - } - ], - "requestBody": { - "$ref": "#/components/requestBodies/migrate.create_from" - }, - "responses": { - "200": { - "$ref": "#/components/responses/migrate.create_from#200" - } - }, - "x-state": "Technical preview" - }, - "post": { - "tags": [ - "migration" - ], - "summary": "This API creates a destination from a source index", - "description": "It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", - "operationId": "migrate-create-from-1", - "parameters": [ - { - "$ref": "#/components/parameters/migrate.create_from#source" - }, - { - "$ref": "#/components/parameters/migrate.create_from#dest" - } - ], - "requestBody": { - "$ref": "#/components/requestBodies/migrate.create_from" - }, - "responses": { - "200": { - "$ref": "#/components/responses/migrate.create_from#200" - } - }, - "x-state": "Technical preview" - } - }, - "/_migration/reindex/{index}/_status": { - "get": { - "tags": [ - "migration" - ], - "summary": "This API returns the status of a migration reindex attempt for a data stream or index", - "operationId": "migrate-get-reindex-status", - "parameters": [ - { - "in": "path", - "name": "index", - "description": "The index or data stream name", - "required": true, - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Indices" - }, - "style": "simple" - } - ], - "responses": { - "200": { - "description": "", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "start_time": { - "$ref": "#/components/schemas/_types:DateTime" - }, - "start_time_millis": { - "$ref": "#/components/schemas/_types:EpochTimeUnitMillis" - }, - "complete": { - "type": "boolean" - }, - "total_indices_in_data_stream": { - "type": "number" - }, - "total_indices_requiring_upgrade": { - "type": "number" - }, - "successes": { - "type": "number" - }, - "in_progress": { - "type": "array", - "items": { - "$ref": "#/components/schemas/migrate.get_reindex_status:StatusInProgress" - } - }, - "pending": { - "type": "number" - }, - "errors": { - "type": "array", - "items": { - "$ref": "#/components/schemas/migrate.get_reindex_status:StatusError" - } - }, - "exception": { - "type": "string" - } - }, - "required": [ - "start_time_millis", - "complete", - "total_indices_in_data_stream", - "total_indices_requiring_upgrade", - "successes", - "in_progress", - "pending", - "errors" - ] - } - } - } - } - }, - "x-state": "Technical preview" - } - }, - "/_migration/reindex": { - "post": { - "tags": [ - "migration" - ], - "summary": "\"This API reindexes all legacy backing indices for a data stream", - "description": "It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task", - "operationId": "migrate-reindex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/migrate.reindex:MigrateReindex" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/_types:AcknowledgedResponseBase" - } - } - } - } - }, - "x-state": "Technical preview" - } - }, "/_migration/deprecations": { "get": { "tags": [ @@ -71124,6 +71124,21 @@ "failures" ] }, + "indices.create_from:CreateFrom": { + "type": "object", + "properties": { + "mappings_override": { + "$ref": "#/components/schemas/_types.mapping:TypeMapping" + }, + "settings_override": { + "$ref": "#/components/schemas/indices._types:IndexSettings" + }, + "remove_index_blocks": { + "description": "If index blocks should be removed when creating destination index (optional)", + "type": "boolean" + } + } + }, "indices.data_streams_stats:DataStreamsStatsItem": { "type": "object", "properties": { @@ -71600,6 +71615,40 @@ "mappings" ] }, + "indices.get_migrate_reindex_status:StatusInProgress": { + "type": "object", + "properties": { + "index": { + "type": "string" + }, + "total_doc_count": { + "type": "number" + }, + "reindexed_doc_count": { + "type": "number" + } + }, + "required": [ + "index", + "total_doc_count", + "reindexed_doc_count" + ] + }, + "indices.get_migrate_reindex_status:StatusError": { + "type": "object", + "properties": { + "index": { + "type": "string" + }, + "message": { + "type": "string" + } + }, + "required": [ + "index", + "message" + ] + }, "indices._types:TemplateMapping": { "type": "object", "properties": { @@ -71639,6 +71688,38 @@ "settings" ] }, + "indices.migrate_reindex:MigrateReindex": { + "type": "object", + "properties": { + "mode": { + "$ref": "#/components/schemas/indices.migrate_reindex:ModeEnum" + }, + "source": { + "$ref": "#/components/schemas/indices.migrate_reindex:SourceIndex" + } + }, + "required": [ + "mode", + "source" + ] + }, + "indices.migrate_reindex:ModeEnum": { + "type": "string", + "enum": [ + "upgrade" + ] + }, + "indices.migrate_reindex:SourceIndex": { + "type": "object", + "properties": { + "index": { + "$ref": "#/components/schemas/_types:IndexName" + } + }, + "required": [ + "index" + ] + }, "indices.modify_data_stream:Action": { "type": "object", "properties": { @@ -76359,87 +76440,6 @@ "_index" ] }, - "migrate.create_from:CreateFrom": { - "type": "object", - "properties": { - "mappings_override": { - "$ref": "#/components/schemas/_types.mapping:TypeMapping" - }, - "settings_override": { - "$ref": "#/components/schemas/indices._types:IndexSettings" - }, - "remove_index_blocks": { - "description": "If index blocks should be removed when creating destination index (optional)", - "type": "boolean" - } - } - }, - "migrate.get_reindex_status:StatusInProgress": { - "type": "object", - "properties": { - "index": { - "type": "string" - }, - "total_doc_count": { - "type": "number" - }, - "reindexed_doc_count": { - "type": "number" - } - }, - "required": [ - "index", - "total_doc_count", - "reindexed_doc_count" - ] - }, - "migrate.get_reindex_status:StatusError": { - "type": "object", - "properties": { - "index": { - "type": "string" - }, - "message": { - "type": "string" - } - }, - "required": [ - "index", - "message" - ] - }, - "migrate.reindex:MigrateReindex": { - "type": "object", - "properties": { - "mode": { - "$ref": "#/components/schemas/migrate.reindex:ModeEnum" - }, - "source": { - "$ref": "#/components/schemas/migrate.reindex:SourceIndex" - } - }, - "required": [ - "mode", - "source" - ] - }, - "migrate.reindex:ModeEnum": { - "type": "string", - "enum": [ - "upgrade" - ] - }, - "migrate.reindex:SourceIndex": { - "type": "object", - "properties": { - "index": { - "$ref": "#/components/schemas/_types:IndexName" - } - }, - "required": [ - "index" - ] - }, "migration.deprecations:Deprecation": { "type": "object", "properties": { @@ -94815,6 +94815,32 @@ } } }, + "indices.create_from#200": { + "description": "", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "acknowledged": { + "type": "boolean" + }, + "index": { + "$ref": "#/components/schemas/_types:IndexName" + }, + "shards_acknowledged": { + "type": "boolean" + } + }, + "required": [ + "acknowledged", + "index", + "shards_acknowledged" + ] + } + } + } + }, "indices.data_streams_stats#200": { "description": "", "content": { @@ -95569,32 +95595,6 @@ } } }, - "migrate.create_from#200": { - "description": "", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - }, - "index": { - "$ref": "#/components/schemas/_types:IndexName" - }, - "shards_acknowledged": { - "type": "boolean" - } - }, - "required": [ - "acknowledged", - "index", - "shards_acknowledged" - ] - } - } - } - }, "migration.deprecations#200": { "description": "", "content": { @@ -101112,6 +101112,28 @@ }, "style": "form" }, + "indices.create_from#source": { + "in": "path", + "name": "source", + "description": "The source index or data stream name", + "required": true, + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:IndexName" + }, + "style": "simple" + }, + "indices.create_from#dest": { + "in": "path", + "name": "dest", + "description": "The destination index or data stream name", + "required": true, + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:IndexName" + }, + "style": "simple" + }, "indices.data_streams_stats#name": { "in": "path", "name": "name", @@ -103220,28 +103242,6 @@ }, "style": "form" }, - "migrate.create_from#source": { - "in": "path", - "name": "source", - "description": "The source index or data stream name", - "required": true, - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:IndexName" - }, - "style": "simple" - }, - "migrate.create_from#dest": { - "in": "path", - "name": "dest", - "description": "The destination index or data stream name", - "required": true, - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:IndexName" - }, - "style": "simple" - }, "migration.deprecations#index": { "in": "path", "name": "index", @@ -108138,6 +108138,16 @@ } } }, + "indices.create_from": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/indices.create_from:CreateFrom" + } + } + }, + "required": true + }, "indices.put_alias": { "content": { "application/json": { @@ -108745,16 +108755,6 @@ }, "required": true }, - "migrate.create_from": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/migrate.create_from:CreateFrom" - } - } - }, - "required": true - }, "ml.delete_expired_data": { "content": { "application/json": { diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json index 7116a98b77..78ca55a27c 100644 --- a/output/schema/schema-serverless.json +++ b/output/schema/schema-serverless.json @@ -7643,7 +7643,7 @@ "stability": "stable" } }, - "description": "Open a point in time.\n\nA search request by default runs against the most recent visible data of the target indices,\nwhich is called point in time. Elasticsearch pit (point in time) is a lightweight view into the\nstate of the data as it existed when initiated. In some cases, it’s preferred to perform multiple\nsearch requests using the same point in time. For example, if refreshes happen between\n`search_after` requests, then the results of those requests might not be consistent as changes happening\nbetween searches are only visible to the more recent point in time.\n\nA point in time must be opened explicitly before being used in search requests.\nThe `keep_alive` parameter tells Elasticsearch how long it should persist.", + "description": "Open a point in time.\n\nA search request by default runs against the most recent visible data of the target indices,\nwhich is called point in time. Elasticsearch pit (point in time) is a lightweight view into the\nstate of the data as it existed when initiated. In some cases, it’s preferred to perform multiple\nsearch requests using the same point in time. For example, if refreshes happen between\n`search_after` requests, then the results of those requests might not be consistent as changes happening\nbetween searches are only visible to the more recent point in time.\n\nA point in time must be opened explicitly before being used in search requests.\n\nA subsequent search request with the `pit` parameter must not specify `index`, `routing`, or `preference` values as these parameters are copied from the point in time.\n\nJust like regular searches, you can use `from` and `size` to page through point in time search results, up to the first 10,000 hits.\nIf you want to retrieve more hits, use PIT with `search_after`.\n\nIMPORTANT: The open point in time request and each subsequent search request can return different identifiers; always use the most recently received ID for the next search request.\n\nWhen a PIT that contains shard failures is used in a search request, the missing are always reported in the search response as a `NoShardAvailableActionException` exception.\nTo get rid of these exceptions, a new PIT needs to be created so that shards missing from the previous PIT can be handled, assuming they become available in the meantime.\n\n**Keeping point in time alive**\n\nThe `keep_alive` parameter, which is passed to a open point in time request and search request, extends the time to live of the corresponding point in time.\nThe value does not need to be long enough to process all data — it just needs to be long enough for the next request.\n\nNormally, the background merge process optimizes the index by merging together smaller segments to create new, bigger segments.\nOnce the smaller segments are no longer needed they are deleted.\nHowever, open point-in-times prevent the old segments from being deleted since they are still in use.\n\nTIP: Keeping older segments alive means that more disk space and file handles are needed.\nEnsure that you have configured your nodes to have ample free file handles.\n\nAdditionally, if a segment contains deleted or updated documents then the point in time must keep track of whether each document in the segment was live at the time of the initial search request.\nEnsure that your nodes have sufficient heap space if you have many open point-in-times on an index that is subject to ongoing deletes or updates.\nNote that a point-in-time doesn't prevent its associated indices from being deleted.\nYou can check how many point-in-times (that is, search contexts) are open with the nodes stats API.", "docId": "point-in-time-api", "docTag": "search", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/point-in-time-api.html", @@ -8345,8 +8345,10 @@ "stability": "stable" } }, - "description": "Run a search.\n\nGet search hits that match the query defined in the request.\nYou can provide search queries using the `q` query string parameter or the request body.\nIf both are specified, only the query parameter is used.", + "description": "Run a search.\n\nGet search hits that match the query defined in the request.\nYou can provide search queries using the `q` query string parameter or the request body.\nIf both are specified, only the query parameter is used.\n\nIf the Elasticsearch security features are enabled, you must have the read index privilege for the target data stream, index, or alias. For cross-cluster search, refer to the documentation about configuring CCS privileges.\nTo search a point in time (PIT) for an alias, you must have the `read` index privilege for the alias's data streams or indices.\n\n**Search slicing**\n\nWhen paging through a large number of documents, it can be helpful to split the search into multiple slices to consume them independently with the `slice` and `pit` properties.\nBy default the splitting is done first on the shards, then locally on each shard.\nThe local splitting partitions the shard into contiguous ranges based on Lucene document IDs.\n\nFor instance if the number of shards is equal to 2 and you request 4 slices, the slices 0 and 2 are assigned to the first shard and the slices 1 and 3 are assigned to the second shard.\n\nIMPORTANT: The same point-in-time ID should be used for all slices.\nIf different PIT IDs are used, slices can overlap and miss documents.\nThis situation can occur because the splitting criterion is based on Lucene document IDs, which are not stable across changes to the index.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-search.html", + "extDocId": "ccs-privileges", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/remote-clusters-cert.html#remote-clusters-privileges-ccs", "name": "search", "privileges": { "index": [ @@ -35468,7 +35470,7 @@ "kind": "properties", "properties": [ { - "description": "Allows to filter indices if the provided query rewrites to `match_none` on every shard.", + "description": "Filter indices if the provided query rewrites to `match_none` on every shard.", "name": "index_filter", "required": false, "type": { @@ -35481,7 +35483,7 @@ } ] }, - "description": "Open a point in time.\n\nA search request by default runs against the most recent visible data of the target indices,\nwhich is called point in time. Elasticsearch pit (point in time) is a lightweight view into the\nstate of the data as it existed when initiated. In some cases, it’s preferred to perform multiple\nsearch requests using the same point in time. For example, if refreshes happen between\n`search_after` requests, then the results of those requests might not be consistent as changes happening\nbetween searches are only visible to the more recent point in time.\n\nA point in time must be opened explicitly before being used in search requests.\nThe `keep_alive` parameter tells Elasticsearch how long it should persist.", + "description": "Open a point in time.\n\nA search request by default runs against the most recent visible data of the target indices,\nwhich is called point in time. Elasticsearch pit (point in time) is a lightweight view into the\nstate of the data as it existed when initiated. In some cases, it’s preferred to perform multiple\nsearch requests using the same point in time. For example, if refreshes happen between\n`search_after` requests, then the results of those requests might not be consistent as changes happening\nbetween searches are only visible to the more recent point in time.\n\nA point in time must be opened explicitly before being used in search requests.\n\nA subsequent search request with the `pit` parameter must not specify `index`, `routing`, or `preference` values as these parameters are copied from the point in time.\n\nJust like regular searches, you can use `from` and `size` to page through point in time search results, up to the first 10,000 hits.\nIf you want to retrieve more hits, use PIT with `search_after`.\n\nIMPORTANT: The open point in time request and each subsequent search request can return different identifiers; always use the most recently received ID for the next search request.\n\nWhen a PIT that contains shard failures is used in a search request, the missing are always reported in the search response as a `NoShardAvailableActionException` exception.\nTo get rid of these exceptions, a new PIT needs to be created so that shards missing from the previous PIT can be handled, assuming they become available in the meantime.\n\n**Keeping point in time alive**\n\nThe `keep_alive` parameter, which is passed to a open point in time request and search request, extends the time to live of the corresponding point in time.\nThe value does not need to be long enough to process all data — it just needs to be long enough for the next request.\n\nNormally, the background merge process optimizes the index by merging together smaller segments to create new, bigger segments.\nOnce the smaller segments are no longer needed they are deleted.\nHowever, open point-in-times prevent the old segments from being deleted since they are still in use.\n\nTIP: Keeping older segments alive means that more disk space and file handles are needed.\nEnsure that you have configured your nodes to have ample free file handles.\n\nAdditionally, if a segment contains deleted or updated documents then the point in time must keep track of whether each document in the segment was live at the time of the initial search request.\nEnsure that your nodes have sufficient heap space if you have many open point-in-times on an index that is subject to ongoing deletes or updates.\nNote that a point-in-time doesn't prevent its associated indices from being deleted.\nYou can check how many point-in-times (that is, search contexts) are open with the nodes stats API.", "inherits": { "type": { "name": "RequestBase", @@ -35509,7 +35511,7 @@ ], "query": [ { - "description": "Extends the time to live of the corresponding point in time.", + "description": "Extend the length of time that the point in time persists.", "name": "keep_alive", "required": true, "type": { @@ -35534,7 +35536,7 @@ } }, { - "description": "Specifies the node or shard the operation should be performed on.\nRandom by default.", + "description": "The node or shard the operation should be performed on.\nBy default, it is random.", "name": "preference", "required": false, "type": { @@ -35546,7 +35548,7 @@ } }, { - "description": "Custom value used to route operations to a specific shard.", + "description": "A custom value that is used to route operations to a specific shard.", "name": "routing", "required": false, "type": { @@ -35558,7 +35560,7 @@ } }, { - "description": "Type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nSupports comma-separated values, such as `open,hidden`. Valid values are: `all`, `open`, `closed`, `hidden`, `none`.", + "description": "The type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nIt supports comma-separated values, such as `open,hidden`. Valid values are: `all`, `open`, `closed`, `hidden`, `none`.", "name": "expand_wildcards", "required": false, "serverDefault": "open", @@ -35571,7 +35573,7 @@ } }, { - "description": "If `false`, creating a point in time request when a shard is missing or unavailable will throw an exception.\nIf `true`, the point in time will contain all the shards that are available at the time of the request.", + "description": "Indicates whether the point in time tolerates unavailable shards or shard failures when initially creating the PIT.\nIf `false`, creating a point in time request when a shard is missing or unavailable will throw an exception.\nIf `true`, the point in time will contain all the shards that are available at the time of the request.", "name": "allow_partial_search_results", "required": false, "serverDefault": false, @@ -35584,7 +35586,7 @@ } } ], - "specLocation": "_global/open_point_in_time/OpenPointInTimeRequest.ts#L25-L93" + "specLocation": "_global/open_point_in_time/OpenPointInTimeRequest.ts#L25-L121" }, { "body": { @@ -37423,7 +37425,7 @@ } }, { - "description": "If true, returns detailed information about score computation as part of a hit.", + "description": "If `true`, the request returns detailed information about score computation as part of a hit.", "name": "explain", "required": false, "serverDefault": false, @@ -37455,7 +37457,7 @@ } }, { - "description": "Starting document offset.\nNeeds to be non-negative.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", + "description": "The starting document offset, which must be non-negative.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", "name": "from", "required": false, "serverDefault": 0, @@ -37493,7 +37495,9 @@ } }, { - "description": "Boosts the _score of documents from specified indices.", + "description": "Boost the `_score` of documents from specified indices.\nThe boost value is the factor by which scores are multiplied.\nA boost value greater than `1.0` increases the score.\nA boost value between `0` and `1.0` decreases the score.", + "extDocId": "relevance-scores", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/query-filter-context.html#relevance-scores", "name": "indices_boost", "required": false, "type": { @@ -37519,7 +37523,9 @@ } }, { - "description": "Array of wildcard (`*`) patterns.\nThe request returns doc values for field names matching these patterns in the `hits.fields` property of the response.", + "description": "An array of wildcard (`*`) field patterns.\nThe request returns doc values for field names matching these patterns in the `hits.fields` property of the response.", + "extDocId": "docvalue-fields", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-fields.html#docvalue-fields", "name": "docvalue_fields", "required": false, "type": { @@ -37540,7 +37546,9 @@ "since": "8.4.0" } }, - "description": "Defines the approximate kNN search to run.", + "description": "The approximate kNN search to run.", + "extDocId": "knn-approximate", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/knn-search.html#approximate-knn", "name": "knn", "required": false, "type": { @@ -37567,7 +37575,7 @@ } }, { - "description": "Minimum `_score` for matching documents.\nDocuments with a lower `_score` are not included in the search results.", + "description": "The minimum `_score` for matching documents.\nDocuments with a lower `_score` are not included in the search results.", "name": "min_score", "required": false, "type": { @@ -37604,7 +37612,9 @@ } }, { - "description": "Defines the search definition using the Query DSL.", + "description": "The search definition using the Query DSL.", + "extDocId": "query-dsl", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/query-dsl.html", "name": "query", "required": false, "type": { @@ -37652,7 +37662,7 @@ "stability": "stable" } }, - "description": "A retriever is a specification to describe top documents returned from a search. A retriever replaces other elements of the search API that also return top documents such as query and knn.", + "description": "A retriever is a specification to describe top documents returned from a search.\nA retriever replaces other elements of the search API that also return top documents such as `query` and `knn`.", "name": "retriever", "required": false, "type": { @@ -37699,7 +37709,7 @@ } }, { - "description": "The number of hits to return.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", + "description": "The number of hits to return, which must not be negative.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` property.", "name": "size", "required": false, "serverDefault": 10, @@ -37712,7 +37722,7 @@ } }, { - "description": "Can be used to split a scrolled search into multiple slices that can be consumed independently.", + "description": "Split a scrolled search into multiple slices that can be consumed independently.", "name": "slice", "required": false, "type": { @@ -37725,8 +37735,8 @@ }, { "description": "A comma-separated list of : pairs.", - "docId": "sort-search-results", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sort-search-results.html", + "extDocId": "sort-search-results", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sort-search-results.html", "name": "sort", "required": false, "type": { @@ -37738,7 +37748,9 @@ } }, { - "description": "Indicates which source fields are returned for matching documents.\nThese fields are returned in the hits._source property of the search response.", + "description": "The source fields that are returned for matching documents.\nThese fields are returned in the `hits._source` property of the search response.\nIf the `stored_fields` property is specified, the `_source` property defaults to `false`.\nOtherwise, it defaults to `true`.", + "extDocId": "source-filtering", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-fields.html#source-filtering", "name": "_source", "required": false, "type": { @@ -37750,7 +37762,7 @@ } }, { - "description": "Array of wildcard (`*`) patterns.\nThe request returns values for field names matching these patterns in the `hits.fields` property of the response.", + "description": "An array of wildcard (`*`) field patterns.\nThe request returns values for field names matching these patterns in the `hits.fields` property of the response.", "name": "fields", "required": false, "type": { @@ -37777,7 +37789,7 @@ } }, { - "description": "Maximum number of documents to collect for each shard.\nIf a query reaches this limit, Elasticsearch terminates the query early.\nElasticsearch collects documents before sorting.\nUse with caution.\nElasticsearch applies this parameter to each shard handling the request.\nWhen possible, let Elasticsearch perform early termination automatically.\nAvoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers.\nIf set to `0` (default), the query does not terminate early.", + "description": "The maximum number of documents to collect for each shard.\nIf a query reaches this limit, Elasticsearch terminates the query early.\nElasticsearch collects documents before sorting.\n\nIMPORTANT: Use with caution.\nElasticsearch applies this property to each shard handling the request.\nWhen possible, let Elasticsearch perform early termination automatically.\nAvoid specifying this property for requests that target data streams with backing indices across multiple data tiers.\n\nIf set to `0` (default), the query does not terminate early.", "name": "terminate_after", "required": false, "serverDefault": 0, @@ -37790,7 +37802,7 @@ } }, { - "description": "Specifies the period of time to wait for a response from each shard.\nIf no response is received before the timeout expires, the request fails and returns an error.\nDefaults to no timeout.", + "description": "The period of time to wait for a response from each shard.\nIf no response is received before the timeout expires, the request fails and returns an error.\nDefaults to no timeout.", "name": "timeout", "required": false, "type": { @@ -37802,7 +37814,7 @@ } }, { - "description": "If true, calculate and return document scores, even if the scores are not used for sorting.", + "description": "If `true`, calculate and return document scores, even if the scores are not used for sorting.", "name": "track_scores", "required": false, "serverDefault": false, @@ -37815,7 +37827,7 @@ } }, { - "description": "If true, returns document version as part of a hit.", + "description": "If `true`, the request returns the document version as part of a hit.", "name": "version", "required": false, "serverDefault": false, @@ -37828,7 +37840,9 @@ } }, { - "description": "If `true`, returns sequence number and primary term of the last modification of each hit.", + "description": "If `true`, the request returns sequence number and primary term of the last modification of each hit.", + "extDocId": "optimistic-concurrency", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/optimistic-concurrency-control.html", "name": "seq_no_primary_term", "required": false, "type": { @@ -37840,7 +37854,9 @@ } }, { - "description": "List of stored fields to return as part of a hit.\nIf no fields are specified, no stored fields are included in the response.\nIf this field is specified, the `_source` parameter defaults to `false`.\nYou can pass `_source: true` to return both source fields and stored fields in the search response.", + "description": "A comma-separated list of stored fields to return as part of a hit.\nIf no fields are specified, no stored fields are included in the response.\nIf this field is specified, the `_source` property defaults to `false`.\nYou can pass `_source: true` to return both source fields and stored fields in the search response.", + "extDocId": "stored-fields", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-fields.html#stored-fields", "name": "stored_fields", "required": false, "type": { @@ -37852,7 +37868,7 @@ } }, { - "description": "Limits the search to a point in time (PIT).\nIf you provide a PIT, you cannot specify an `` in the request path.", + "description": "Limit the search to a point in time (PIT).\nIf you provide a PIT, you cannot specify an `` in the request path.", "name": "pit", "required": false, "type": { @@ -37864,7 +37880,9 @@ } }, { - "description": "Defines one or more runtime fields in the search request.\nThese fields take precedence over mapped fields with the same name.", + "description": "One or more runtime fields in the search request.\nThese fields take precedence over mapped fields with the same name.", + "extDocId": "runtime-search-request", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/runtime-search-request.html", "name": "runtime_mappings", "required": false, "type": { @@ -37876,7 +37894,7 @@ } }, { - "description": "Stats groups to associate with the search.\nEach group maintains a statistics aggregation for its associated searches.\nYou can retrieve these stats using the indices stats API.", + "description": "The stats groups to associate with the search.\nEach group maintains a statistics aggregation for its associated searches.\nYou can retrieve these stats using the indices stats API.", "name": "stats", "required": false, "type": { @@ -37892,7 +37910,7 @@ } ] }, - "description": "Run a search.\n\nGet search hits that match the query defined in the request.\nYou can provide search queries using the `q` query string parameter or the request body.\nIf both are specified, only the query parameter is used.", + "description": "Run a search.\n\nGet search hits that match the query defined in the request.\nYou can provide search queries using the `q` query string parameter or the request body.\nIf both are specified, only the query parameter is used.\n\nIf the Elasticsearch security features are enabled, you must have the read index privilege for the target data stream, index, or alias. For cross-cluster search, refer to the documentation about configuring CCS privileges.\nTo search a point in time (PIT) for an alias, you must have the `read` index privilege for the alias's data streams or indices.\n\n**Search slicing**\n\nWhen paging through a large number of documents, it can be helpful to split the search into multiple slices to consume them independently with the `slice` and `pit` properties.\nBy default the splitting is done first on the shards, then locally on each shard.\nThe local splitting partitions the shard into contiguous ranges based on Lucene document IDs.\n\nFor instance if the number of shards is equal to 2 and you request 4 slices, the slices 0 and 2 are assigned to the first shard and the slices 1 and 3 are assigned to the second shard.\n\nIMPORTANT: The same point-in-time ID should be used for all slices.\nIf different PIT IDs are used, slices can overlap and miss documents.\nThis situation can occur because the splitting criterion is based on Lucene document IDs, which are not stable across changes to the index.", "inherits": { "type": { "name": "RequestBase", @@ -37906,7 +37924,7 @@ }, "path": [ { - "description": "Comma-separated list of data streams, indices, and aliases to search.\nSupports wildcards (`*`).\nTo search all data streams and indices, omit this parameter or use `*` or `_all`.", + "description": "A comma-separated list of data streams, indices, and aliases to search.\nIt supports wildcards (`*`).\nTo search all data streams and indices, omit this parameter or use `*` or `_all`.", "name": "index", "required": false, "type": { @@ -37933,7 +37951,7 @@ } }, { - "description": "If true, returns partial results if there are shard request timeouts or shard failures. If false, returns an error with no partial results.", + "description": "If `true` and there are shard request timeouts or shard failures, the request returns partial results.\nIf `false`, it returns an error with no partial results.\n\nTo override the default behavior, you can set the `search.default_allow_partial_results` cluster setting to `false`.", "name": "allow_partial_search_results", "required": false, "serverDefault": true, @@ -37946,7 +37964,7 @@ } }, { - "description": "Analyzer to use for the query string.\nThis parameter can only be used when the q query string parameter is specified.", + "description": "The analyzer to use for the query string.\nThis parameter can be used only when the `q` query string parameter is specified.", "name": "analyzer", "required": false, "type": { @@ -37958,7 +37976,7 @@ } }, { - "description": "If true, wildcard and prefix queries are analyzed.\nThis parameter can only be used when the q query string parameter is specified.", + "description": "If `true`, wildcard and prefix queries are analyzed.\nThis parameter can be used only when the `q` query string parameter is specified.", "name": "analyze_wildcard", "required": false, "serverDefault": false, @@ -37971,7 +37989,7 @@ } }, { - "description": "The number of shard results that should be reduced at once on the coordinating node.\nThis value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", + "description": "The number of shard results that should be reduced at once on the coordinating node.\nIf the potential number of shards in the request can be large, this value should be used as a protection mechanism to reduce the memory overhead per search request.", "name": "batched_reduce_size", "required": false, "serverDefault": 512, @@ -37984,9 +38002,9 @@ } }, { - "description": "If true, network round-trips between the coordinating node and the remote clusters are minimized when executing cross-cluster search (CCS) requests.", - "docId": "ccs-network-delays", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/modules-cross-cluster-search.html#ccs-network-delays", + "description": "If `true`, network round-trips between the coordinating node and the remote clusters are minimized when running cross-cluster search (CCS) requests.", + "extDocId": "ccs-network-delays", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/modules-cross-cluster-search.html#ccs-network-delays", "name": "ccs_minimize_roundtrips", "required": false, "serverDefault": true, @@ -37999,7 +38017,7 @@ } }, { - "description": "The default operator for query string query: AND or OR.\nThis parameter can only be used when the `q` query string parameter is specified.", + "description": "The default operator for the query string query: `AND` or `OR`.\nThis parameter can be used only when the `q` query string parameter is specified.", "name": "default_operator", "required": false, "serverDefault": "OR", @@ -38012,7 +38030,7 @@ } }, { - "description": "Field to use as default where no field prefix is given in the query string.\nThis parameter can only be used when the q query string parameter is specified.", + "description": "The field to use as a default when no field prefix is given in the query string.\nThis parameter can be used only when the `q` query string parameter is specified.", "name": "df", "required": false, "type": { @@ -38024,7 +38042,9 @@ } }, { - "description": "A comma-separated list of fields to return as the docvalue representation for each hit.", + "description": "A comma-separated list of fields to return as the docvalue representation of a field for each hit.", + "extDocId": "docvalue-fields", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-fields.html#docvalue-fields", "name": "docvalue_fields", "required": false, "type": { @@ -38036,9 +38056,10 @@ } }, { - "description": "Type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nSupports comma-separated values, such as `open,hidden`.", + "description": "The type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nIt supports comma-separated values such as `open,hidden`.", "name": "expand_wildcards", "required": false, + "serverDefault": "open", "type": { "kind": "instance_of", "type": { @@ -38048,7 +38069,7 @@ } }, { - "description": "If `true`, returns detailed information about score computation as part of a hit.", + "description": "If `true`, the request returns detailed information about score computation as part of a hit.", "name": "explain", "required": false, "serverDefault": false, @@ -38061,6 +38082,10 @@ } }, { + "deprecation": { + "description": "", + "version": "7.16.0" + }, "description": "If `true`, concrete, expanded or aliased indices will be ignored when frozen.", "name": "ignore_throttled", "required": false, @@ -38087,7 +38112,7 @@ } }, { - "description": "Indicates whether hit.matched_queries should be rendered as a map that includes\nthe name of the matched query associated with its score (true)\nor as an array containing the name of the matched queries (false)\nThis functionality reruns each named query on every hit in a search response.\nTypically, this adds a small overhead to a request.\nHowever, using computationally expensive named queries on a large number of hits may add significant overhead.", + "description": "If `true`, the response includes the score contribution from any named queries.\n\nThis functionality reruns each named query on every hit in a search response.\nTypically, this adds a small overhead to a request.\nHowever, using computationally expensive named queries on a large number of hits may add significant overhead.", "name": "include_named_queries_score", "required": false, "serverDefault": false, @@ -38100,7 +38125,7 @@ } }, { - "description": "If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.\nThis parameter can only be used when the `q` query string parameter is specified.", + "description": "If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.\nThis parameter can be used only when the `q` query string parameter is specified.", "name": "lenient", "required": false, "serverDefault": false, @@ -38113,7 +38138,7 @@ } }, { - "description": "Defines the number of concurrent shard requests per node this search executes concurrently.\nThis value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests.", + "description": "The number of concurrent shard requests per node that the search runs concurrently.\nThis value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests.", "name": "max_concurrent_shard_requests", "required": false, "serverDefault": 5, @@ -38138,7 +38163,7 @@ } }, { - "description": "Nodes and shards used for the search.\nBy default, Elasticsearch selects from eligible nodes and shards using adaptive replica selection, accounting for allocation awareness. Valid values are:\n`_only_local` to run the search only on shards on the local node;\n`_local` to, if possible, run the search on shards on the local node, or if not, select shards using the default method;\n`_only_nodes:,` to run the search on only the specified nodes IDs, where, if suitable shards exist on more than one selected node, use shards on those nodes using the default method, or if none of the specified nodes are available, select shards from any available node using the default method;\n`_prefer_nodes:,` to if possible, run the search on the specified nodes IDs, or if not, select shards using the default method;\n`_shards:,` to run the search only on the specified shards;\n`` (any string that does not start with `_`) to route searches with the same `` to the same shards in the same order.", + "description": "The nodes and shards used for the search.\nBy default, Elasticsearch selects from eligible nodes and shards using adaptive replica selection, accounting for allocation awareness.\nValid values are:\n\n* `_only_local` to run the search only on shards on the local node;\n* `_local` to, if possible, run the search on shards on the local node, or if not, select shards using the default method;\n* `_only_nodes:,` to run the search on only the specified nodes IDs, where, if suitable shards exist on more than one selected node, use shards on those nodes using the default method, or if none of the specified nodes are available, select shards from any available node using the default method;\n* `_prefer_nodes:,` to if possible, run the search on the specified nodes IDs, or if not, select shards using the default method;\n* `_shards:,` to run the search only on the specified shards;\n* `` (any string that does not start with `_`) to route searches with the same `` to the same shards in the same order.", "name": "preference", "required": false, "type": { @@ -38150,7 +38175,7 @@ } }, { - "description": "Defines a threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold.\nThis filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method (if date filters are mandatory to match but the shard bounds and the query are disjoint).\nWhen unspecified, the pre-filter phase is executed if any of these conditions is met:\nthe request targets more than 128 shards;\nthe request targets one or more read-only index;\nthe primary sort of the query targets an indexed field.", + "description": "A threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold.\nThis filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method (if date filters are mandatory to match but the shard bounds and the query are disjoint).\nWhen unspecified, the pre-filter phase is executed if any of these conditions is met:\n\n* The request targets more than 128 shards.\n* The request targets one or more read-only index.\n* The primary sort of the query targets an indexed field.", "name": "pre_filter_shard_size", "required": false, "type": { @@ -38162,7 +38187,9 @@ } }, { - "description": "If `true`, the caching of search results is enabled for requests where `size` is `0`.\nDefaults to index level settings.", + "description": "If `true`, the caching of search results is enabled for requests where `size` is `0`.\nIt defaults to index level settings.", + "extDocId": "shard-request-cache", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/shard-request-cache.html", "name": "request_cache", "required": false, "type": { @@ -38174,7 +38201,7 @@ } }, { - "description": "Custom value used to route operations to a specific shard.", + "description": "A custom value that is used to route operations to a specific shard.", "name": "routing", "required": false, "type": { @@ -38186,9 +38213,9 @@ } }, { - "description": "Period to retain the search context for scrolling. See Scroll search results.\nBy default, this value cannot exceed `1d` (24 hours).\nYou can change this limit using the `search.max_keep_alive` cluster-level setting.", - "docId": "scroll-search-results", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/paginate-search-results.html#scroll-search-results", + "description": "The period to retain the search context for scrolling.\nBy default, this value cannot exceed `1d` (24 hours).\nYou can change this limit by using the `search.max_keep_alive` cluster-level setting.", + "extDocId": "scroll-search-results", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/paginate-search-results.html#scroll-search-results", "name": "scroll", "required": false, "type": { @@ -38200,7 +38227,9 @@ } }, { - "description": "How distributed term frequencies are calculated for relevance scoring.", + "description": "Indicates how distributed term frequencies are calculated for relevance scoring.", + "extDocId": "relevance-scores", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/query-filter-context.html#relevance-scores", "name": "search_type", "required": false, "type": { @@ -38228,6 +38257,8 @@ }, { "description": "A comma-separated list of stored fields to return as part of a hit.\nIf no fields are specified, no stored fields are included in the response.\nIf this field is specified, the `_source` parameter defaults to `false`.\nYou can pass `_source: true` to return both source fields and stored fields in the search response.", + "extDocId": "stored-fields", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-fields.html#stored-fields", "name": "stored_fields", "required": false, "type": { @@ -38239,7 +38270,7 @@ } }, { - "description": "Specifies which field to use for suggestions.", + "description": "The field to use for suggestions.", "name": "suggest_field", "required": false, "type": { @@ -38251,7 +38282,7 @@ } }, { - "description": "Specifies the suggest mode.\nThis parameter can only be used when the `suggest_field` and `suggest_text` query string parameters are specified.", + "description": "The suggest mode.\nThis parameter can be used only when the `suggest_field` and `suggest_text` query string parameters are specified.", "name": "suggest_mode", "required": false, "serverDefault": "missing", @@ -38264,7 +38295,7 @@ } }, { - "description": "Number of suggestions to return.\nThis parameter can only be used when the `suggest_field` and `suggest_text` query string parameters are specified.", + "description": "The number of suggestions to return.\nThis parameter can be used only when the `suggest_field` and `suggest_text` query string parameters are specified.", "name": "suggest_size", "required": false, "type": { @@ -38276,7 +38307,7 @@ } }, { - "description": "The source text for which the suggestions should be returned.\nThis parameter can only be used when the `suggest_field` and `suggest_text` query string parameters are specified.", + "description": "The source text for which the suggestions should be returned.\nThis parameter can be used only when the `suggest_field` and `suggest_text` query string parameters are specified.", "name": "suggest_text", "required": false, "type": { @@ -38288,7 +38319,7 @@ } }, { - "description": "Maximum number of documents to collect for each shard.\nIf a query reaches this limit, Elasticsearch terminates the query early.\nElasticsearch collects documents before sorting.\nUse with caution.\nElasticsearch applies this parameter to each shard handling the request.\nWhen possible, let Elasticsearch perform early termination automatically.\nAvoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers.\nIf set to `0` (default), the query does not terminate early.", + "description": "The maximum number of documents to collect for each shard.\nIf a query reaches this limit, Elasticsearch terminates the query early.\nElasticsearch collects documents before sorting.\n\nIMPORTANT: Use with caution.\nElasticsearch applies this parameter to each shard handling the request.\nWhen possible, let Elasticsearch perform early termination automatically.\nAvoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers.\nIf set to `0` (default), the query does not terminate early.", "name": "terminate_after", "required": false, "serverDefault": 0, @@ -38301,7 +38332,7 @@ } }, { - "description": "Specifies the period of time to wait for a response from each shard.\nIf no response is received before the timeout expires, the request fails and returns an error.", + "description": "The period of time to wait for a response from each shard.\nIf no response is received before the timeout expires, the request fails and returns an error.\nIt defaults to no timeout.", "name": "timeout", "required": false, "type": { @@ -38313,7 +38344,7 @@ } }, { - "description": "Number of hits matching the query to count accurately.\nIf `true`, the exact number of hits is returned at the cost of some performance.\nIf `false`, the response does not include the total number of hits matching the query.", + "description": "The number of hits matching the query to count accurately.\nIf `true`, the exact number of hits is returned at the cost of some performance.\nIf `false`, the response does not include the total number of hits matching the query.", "name": "track_total_hits", "required": false, "serverDefault": "10000", @@ -38326,7 +38357,7 @@ } }, { - "description": "If `true`, calculate and return document scores, even if the scores are not used for sorting.", + "description": "If `true`, the request calculates and returns document scores, even if the scores are not used for sorting.", "name": "track_scores", "required": false, "serverDefault": false, @@ -38342,7 +38373,7 @@ "description": "If `true`, aggregation and suggester names are be prefixed by their respective types in the response.", "name": "typed_keys", "required": false, - "serverDefault": true, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -38365,7 +38396,7 @@ } }, { - "description": "If `true`, returns document version as part of a hit.", + "description": "If `true`, the request returns the document version as part of a hit.", "name": "version", "required": false, "serverDefault": false, @@ -38378,7 +38409,7 @@ } }, { - "description": "Indicates which source fields are returned for matching documents.\nThese fields are returned in the `hits._source` property of the search response.\nValid values are:\n`true` to return the entire document source;\n`false` to not return the document source;\n`` to return the source fields that are specified as a comma-separated list (supports wildcard (`*`) patterns).", + "description": "The source fields that are returned for matching documents.\nThese fields are returned in the `hits._source` property of the search response.\nValid values are:\n\n* `true` to return the entire document source.\n* `false` to not return the document source.\n* `` to return the source fields that are specified as a comma-separated list that supports wildcard (`*`) patterns.", "name": "_source", "required": false, "serverDefault": "true", @@ -38415,7 +38446,9 @@ } }, { - "description": "If `true`, returns sequence number and primary term of the last modification of each hit.", + "description": "If `true`, the request returns the sequence number and primary term of the last modification of each hit.", + "extDocId": "optimistic-concurrency", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/optimistic-concurrency-control.html", "name": "seq_no_primary_term", "required": false, "type": { @@ -38427,7 +38460,7 @@ } }, { - "description": "Query in the Lucene query string syntax using query parameter search.\nQuery parameter searches do not support the full Elasticsearch Query DSL but are handy for testing.", + "description": "A query in the Lucene query string syntax.\nQuery parameter searches do not support the full Elasticsearch Query DSL but are handy for testing.\n\nIMPORTANT: This parameter overrides the query parameter in the request body.\nIf both parameters are specified, documents matching the query request body parameter are not returned.", "name": "q", "required": false, "type": { @@ -38439,7 +38472,7 @@ } }, { - "description": "Defines the number of hits to return.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", + "description": "The number of hits to return.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", "name": "size", "required": false, "serverDefault": 10, @@ -38452,7 +38485,7 @@ } }, { - "description": "Starting document offset.\nNeeds to be non-negative.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", + "description": "The starting document offset, which must be non-negative.\nBy default, you cannot page through more than 10,000 hits using the `from` and `size` parameters.\nTo page through more hits, use the `search_after` parameter.", "name": "from", "required": false, "serverDefault": 0, @@ -38465,9 +38498,9 @@ } }, { - "description": "A comma-separated list of : pairs.", - "docId": "sort-search-results", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sort-search-results.html", + "description": "A comma-separated list of `:` pairs.", + "extDocId": "sort-search-results", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sort-search-results.html", "name": "sort", "required": false, "type": { @@ -38494,7 +38527,7 @@ } } ], - "specLocation": "_global/search/SearchRequest.ts#L54-L541" + "specLocation": "_global/search/SearchRequest.ts#L54-L589" }, { "body": { @@ -52711,7 +52744,7 @@ }, "properties": [ { - "description": "Wildcard pattern. The request returns values for field names matching this pattern.", + "description": "A wildcard pattern. The request returns values for field names matching this pattern.", "name": "field", "required": true, "type": { @@ -52723,7 +52756,7 @@ } }, { - "description": "Format in which the values are returned.", + "description": "The format in which the values are returned.", "name": "format", "required": false, "type": { @@ -69204,6 +69237,7 @@ }, "properties": [ { + "description": "The number of milliseconds it took Elasticsearch to run the request.\nThis value is calculated by measuring the time elapsed between receipt of a request on the coordinating node and the time at which the coordinating node is ready to send the response.\nIt includes:\n\n* Communication time between the coordinating node and data nodes\n* Time the request spends in the search thread pool, queued for execution\n* Actual run time\n\nIt does not include:\n\n* Time needed to send the request to Elasticsearch\n* Time needed to serialize the JSON response\n* Time needed to send the response to a client", "name": "took", "required": true, "type": { @@ -69215,6 +69249,7 @@ } }, { + "description": "If `true`, the request timed out before completion; returned results may be partial or empty.", "name": "timed_out", "required": true, "type": { @@ -69226,6 +69261,7 @@ } }, { + "description": "A count of shards used for the request.", "name": "_shards", "required": true, "type": { @@ -69237,6 +69273,7 @@ } }, { + "description": "The returned documents and metadata.", "name": "hits", "required": true, "type": { @@ -69352,6 +69389,9 @@ } }, { + "description": "The identifier for the search and its search context.\nYou can use this scroll ID with the scroll API to retrieve the next batch of search results for the request.\nThis property is returned only if the `scroll` query parameter is specified in the request.", + "extDocId": "scroll-search-results", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/paginate-search-results.html#scroll-search-results", "name": "_scroll_id", "required": false, "type": { @@ -69408,7 +69448,7 @@ } } ], - "specLocation": "_global/search/SearchResponse.ts#L38-L54" + "specLocation": "_global/search/SearchResponse.ts#L38-L84" }, { "kind": "interface", @@ -95664,6 +95704,19 @@ "kind": "union_of" } }, + { + "kind": "enum", + "members": [ + { + "name": "upgrade" + } + ], + "name": { + "name": "ModeEnum", + "namespace": "indices.migrate_reindex" + }, + "specLocation": "indices/migrate_reindex/MigrateReindexRequest.ts#L51-L53" + }, { "kind": "enum", "members": [ @@ -96231,19 +96284,6 @@ }, "specLocation": "license/_types/License.ts#L23-L33" }, - { - "kind": "enum", - "members": [ - { - "name": "upgrade" - } - ], - "name": { - "name": "ModeEnum", - "namespace": "migrate.reindex" - }, - "specLocation": "migrate/reindex/MigrateReindexRequest.ts#L51-L53" - }, { "kind": "enum", "members": [ diff --git a/output/schema/schema.json b/output/schema/schema.json index dd062ded54..36c3ca8c0b 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -6260,6 +6260,46 @@ } ] }, + { + "availability": { + "serverless": { + "stability": "experimental", + "visibility": "private" + }, + "stack": { + "since": "8.18.0", + "stability": "experimental" + } + }, + "description": "This API cancels a migration reindex attempt for a data stream or index", + "docId": "migrate", + "docTag": "migration", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", + "name": "indices.cancel_migrate_reindex", + "request": { + "name": "Request", + "namespace": "indices.cancel_migrate_reindex" + }, + "requestBodyRequired": false, + "requestMediaType": [ + "application/json" + ], + "response": { + "name": "Response", + "namespace": "indices.cancel_migrate_reindex" + }, + "responseMediaType": [ + "application/json" + ], + "urls": [ + { + "methods": [ + "POST" + ], + "path": "/_migration/reindex/{index}/_cancel" + } + ] + }, { "availability": { "serverless": { @@ -6470,6 +6510,47 @@ } ] }, + { + "availability": { + "serverless": { + "stability": "experimental", + "visibility": "private" + }, + "stack": { + "since": "8.18.0", + "stability": "experimental" + } + }, + "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", + "docId": "migrate", + "docTag": "migration", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", + "name": "indices.create_from", + "request": { + "name": "Request", + "namespace": "indices.create_from" + }, + "requestBodyRequired": true, + "requestMediaType": [ + "application/json" + ], + "response": { + "name": "Response", + "namespace": "indices.create_from" + }, + "responseMediaType": [ + "application/json" + ], + "urls": [ + { + "methods": [ + "PUT", + "POST" + ], + "path": "/_create_from/{source}/{dest}" + } + ] + }, { "availability": { "serverless": { @@ -7508,6 +7589,46 @@ } ] }, + { + "availability": { + "serverless": { + "stability": "experimental", + "visibility": "private" + }, + "stack": { + "since": "8.18.0", + "stability": "experimental" + } + }, + "description": "This API returns the status of a migration reindex attempt for a data stream or index", + "docId": "migrate", + "docTag": "migration", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", + "name": "indices.get_migrate_reindex_status", + "request": { + "name": "Request", + "namespace": "indices.get_migrate_reindex_status" + }, + "requestBodyRequired": false, + "requestMediaType": [ + "application/json" + ], + "response": { + "name": "Response", + "namespace": "indices.get_migrate_reindex_status" + }, + "responseMediaType": [ + "application/json" + ], + "urls": [ + { + "methods": [ + "GET" + ], + "path": "/_migration/reindex/{index}/_status" + } + ] + }, { "availability": { "serverless": { @@ -7610,6 +7731,42 @@ } ] }, + { + "availability": { + "stack": { + "since": "8.18.0", + "stability": "experimental" + } + }, + "description": "\"This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task", + "docId": "migrate", + "docTag": "migration", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", + "name": "indices.migrate_reindex", + "request": { + "name": "Request", + "namespace": "indices.migrate_reindex" + }, + "requestBodyRequired": true, + "requestMediaType": [ + "application/json" + ], + "response": { + "name": "Response", + "namespace": "indices.migrate_reindex" + }, + "responseMediaType": [ + "application/json" + ], + "urls": [ + { + "methods": [ + "POST" + ], + "path": "/_migration/reindex" + } + ] + }, { "availability": { "serverless": { @@ -10076,163 +10233,6 @@ } ] }, - { - "availability": { - "serverless": { - "stability": "experimental", - "visibility": "private" - }, - "stack": { - "since": "8.18.0", - "stability": "experimental" - } - }, - "description": "This API cancels a migration reindex attempt for a data stream or index", - "docId": "migrate", - "docTag": "migration", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", - "name": "migrate.cancel_reindex", - "request": { - "name": "Request", - "namespace": "migrate.cancel_reindex" - }, - "requestBodyRequired": false, - "requestMediaType": [ - "application/json" - ], - "response": { - "name": "Response", - "namespace": "migrate.cancel_reindex" - }, - "responseMediaType": [ - "application/json" - ], - "urls": [ - { - "methods": [ - "POST" - ], - "path": "/_migration/reindex/{index}/_cancel" - } - ] - }, - { - "availability": { - "serverless": { - "stability": "experimental", - "visibility": "private" - }, - "stack": { - "since": "8.18.0", - "stability": "experimental" - } - }, - "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", - "docId": "migrate", - "docTag": "migration", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", - "name": "migrate.create_from", - "request": { - "name": "Request", - "namespace": "migrate.create_from" - }, - "requestBodyRequired": true, - "requestMediaType": [ - "application/json" - ], - "response": { - "name": "Response", - "namespace": "migrate.create_from" - }, - "responseMediaType": [ - "application/json" - ], - "urls": [ - { - "methods": [ - "PUT", - "POST" - ], - "path": "/_create_from/{source}/{dest}" - } - ] - }, - { - "availability": { - "serverless": { - "stability": "experimental", - "visibility": "private" - }, - "stack": { - "since": "8.18.0", - "stability": "experimental" - } - }, - "description": "This API returns the status of a migration reindex attempt for a data stream or index", - "docId": "migrate", - "docTag": "migration", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", - "name": "migrate.get_reindex_status", - "request": { - "name": "Request", - "namespace": "migrate.get_reindex_status" - }, - "requestBodyRequired": false, - "requestMediaType": [ - "application/json" - ], - "response": { - "name": "Response", - "namespace": "migrate.get_reindex_status" - }, - "responseMediaType": [ - "application/json" - ], - "urls": [ - { - "methods": [ - "GET" - ], - "path": "/_migration/reindex/{index}/_status" - } - ] - }, - { - "availability": { - "stack": { - "since": "8.18.0", - "stability": "experimental" - } - }, - "description": "\"This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task", - "docId": "migrate", - "docTag": "migration", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/migrate-data-stream.html", - "name": "migrate.reindex", - "request": { - "name": "Request", - "namespace": "migrate.reindex" - }, - "requestBodyRequired": true, - "requestMediaType": [ - "application/json" - ], - "response": { - "name": "Response", - "namespace": "migrate.reindex" - }, - "responseMediaType": [ - "application/json" - ], - "urls": [ - { - "methods": [ - "POST" - ], - "path": "/_migration/reindex" - } - ] - }, { "availability": { "stack": { @@ -131882,6 +131882,60 @@ ], "specLocation": "indices/analyze/types.ts#L71-L74" }, + { + "kind": "request", + "attachedBehaviors": [ + "CommonQueryParameters" + ], + "body": { + "kind": "no_body" + }, + "description": "This API cancels a migration reindex attempt for a data stream or index", + "inherits": { + "type": { + "name": "RequestBase", + "namespace": "_types" + } + }, + "name": { + "name": "Request", + "namespace": "indices.cancel_migrate_reindex" + }, + "path": [ + { + "description": "The index or data stream name", + "name": "index", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "Indices", + "namespace": "_types" + } + } + } + ], + "query": [], + "specLocation": "indices/cancel_migrate_reindex/MigrateCancelReindexRequest.ts#L23-L37" + }, + { + "kind": "response", + "body": { + "kind": "value", + "value": { + "kind": "instance_of", + "type": { + "name": "AcknowledgedResponseBase", + "namespace": "_types" + } + } + }, + "name": { + "name": "Response", + "namespace": "indices.cancel_migrate_reindex" + }, + "specLocation": "indices/cancel_migrate_reindex/MigrateCancelReindexResponse.ts#L22-L24" + }, { "kind": "request", "attachedBehaviors": [ @@ -132699,6 +132753,155 @@ }, "specLocation": "indices/create_data_stream/IndicesCreateDataStreamResponse.ts#L22-L24" }, + { + "kind": "interface", + "name": { + "name": "CreateFrom", + "namespace": "indices.create_from" + }, + "properties": [ + { + "description": "Mappings overrides to be applied to the destination index (optional)", + "name": "mappings_override", + "required": false, + "type": { + "kind": "instance_of", + "type": { + "name": "TypeMapping", + "namespace": "_types.mapping" + } + } + }, + { + "description": "Settings overrides to be applied to the destination index (optional)", + "name": "settings_override", + "required": false, + "type": { + "kind": "instance_of", + "type": { + "name": "IndexSettings", + "namespace": "indices._types" + } + } + }, + { + "description": "If index blocks should be removed when creating destination index (optional)", + "name": "remove_index_blocks", + "required": false, + "serverDefault": false, + "type": { + "kind": "instance_of", + "type": { + "name": "boolean", + "namespace": "_builtins" + } + } + } + ], + "specLocation": "indices/create_from/MigrateCreateFromRequest.ts#L45-L59" + }, + { + "kind": "request", + "attachedBehaviors": [ + "CommonQueryParameters" + ], + "body": { + "kind": "value", + "codegenName": "create_from", + "value": { + "kind": "instance_of", + "type": { + "name": "CreateFrom", + "namespace": "indices.create_from" + } + } + }, + "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", + "inherits": { + "type": { + "name": "RequestBase", + "namespace": "_types" + } + }, + "name": { + "name": "Request", + "namespace": "indices.create_from" + }, + "path": [ + { + "description": "The source index or data stream name", + "name": "source", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "IndexName", + "namespace": "_types" + } + } + }, + { + "description": "The destination index or data stream name", + "name": "dest", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "IndexName", + "namespace": "_types" + } + } + } + ], + "query": [], + "specLocation": "indices/create_from/MigrateCreateFromRequest.ts#L25-L43" + }, + { + "kind": "response", + "body": { + "kind": "properties", + "properties": [ + { + "name": "acknowledged", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "boolean", + "namespace": "_builtins" + } + } + }, + { + "name": "index", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "IndexName", + "namespace": "_types" + } + } + }, + { + "name": "shards_acknowledged", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "boolean", + "namespace": "_builtins" + } + } + } + ] + }, + "name": { + "name": "Response", + "namespace": "indices.create_from" + }, + "specLocation": "indices/create_from/MigrateCreateFromResponse.ts#L22-L28" + }, { "kind": "interface", "name": { @@ -136359,6 +136562,255 @@ }, "specLocation": "indices/get_mapping/IndicesGetMappingResponse.ts#L24-L27" }, + { + "kind": "request", + "attachedBehaviors": [ + "CommonQueryParameters" + ], + "body": { + "kind": "no_body" + }, + "description": "This API returns the status of a migration reindex attempt for a data stream or index", + "inherits": { + "type": { + "name": "RequestBase", + "namespace": "_types" + } + }, + "name": { + "name": "Request", + "namespace": "indices.get_migrate_reindex_status" + }, + "path": [ + { + "description": "The index or data stream name", + "name": "index", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "Indices", + "namespace": "_types" + } + } + } + ], + "query": [], + "specLocation": "indices/get_migrate_reindex_status/MigrateGetReindexStatusRequest.ts#L23-L37" + }, + { + "kind": "response", + "body": { + "kind": "properties", + "properties": [ + { + "name": "start_time", + "required": false, + "type": { + "kind": "instance_of", + "type": { + "name": "DateTime", + "namespace": "_types" + } + } + }, + { + "name": "start_time_millis", + "required": true, + "type": { + "kind": "instance_of", + "generics": [ + { + "kind": "instance_of", + "type": { + "name": "UnitMillis", + "namespace": "_types" + } + } + ], + "type": { + "name": "EpochTime", + "namespace": "_types" + } + } + }, + { + "name": "complete", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "boolean", + "namespace": "_builtins" + } + } + }, + { + "name": "total_indices_in_data_stream", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "integer", + "namespace": "_types" + } + } + }, + { + "name": "total_indices_requiring_upgrade", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "integer", + "namespace": "_types" + } + } + }, + { + "name": "successes", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "integer", + "namespace": "_types" + } + } + }, + { + "name": "in_progress", + "required": true, + "type": { + "kind": "array_of", + "value": { + "kind": "instance_of", + "type": { + "name": "StatusInProgress", + "namespace": "indices.get_migrate_reindex_status" + } + } + } + }, + { + "name": "pending", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "integer", + "namespace": "_types" + } + } + }, + { + "name": "errors", + "required": true, + "type": { + "kind": "array_of", + "value": { + "kind": "instance_of", + "type": { + "name": "StatusError", + "namespace": "indices.get_migrate_reindex_status" + } + } + } + }, + { + "name": "exception", + "required": false, + "type": { + "kind": "instance_of", + "type": { + "name": "string", + "namespace": "_builtins" + } + } + } + ] + }, + "name": { + "name": "Response", + "namespace": "indices.get_migrate_reindex_status" + }, + "specLocation": "indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts#L23-L36" + }, + { + "kind": "interface", + "name": { + "name": "StatusError", + "namespace": "indices.get_migrate_reindex_status" + }, + "properties": [ + { + "name": "index", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "string", + "namespace": "_builtins" + } + } + }, + { + "name": "message", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "string", + "namespace": "_builtins" + } + } + } + ], + "specLocation": "indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts#L44-L47" + }, + { + "kind": "interface", + "name": { + "name": "StatusInProgress", + "namespace": "indices.get_migrate_reindex_status" + }, + "properties": [ + { + "name": "index", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "string", + "namespace": "_builtins" + } + } + }, + { + "name": "total_doc_count", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "long", + "namespace": "_types" + } + } + }, + { + "name": "reindexed_doc_count", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "long", + "namespace": "_types" + } + } + } + ], + "specLocation": "indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts#L38-L42" + }, { "kind": "request", "attachedBehaviors": [ @@ -136633,6 +137085,123 @@ }, "specLocation": "indices/get_template/IndicesGetTemplateResponse.ts#L23-L26" }, + { + "kind": "interface", + "name": { + "name": "MigrateReindex", + "namespace": "indices.migrate_reindex" + }, + "properties": [ + { + "description": "Reindex mode. Currently only 'upgrade' is supported.", + "name": "mode", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "ModeEnum", + "namespace": "indices.migrate_reindex" + } + } + }, + { + "description": "The source index or data stream (only data streams are currently supported).", + "name": "source", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "SourceIndex", + "namespace": "indices.migrate_reindex" + } + } + } + ], + "specLocation": "indices/migrate_reindex/MigrateReindexRequest.ts#L36-L45" + }, + { + "kind": "enum", + "members": [ + { + "name": "upgrade" + } + ], + "name": { + "name": "ModeEnum", + "namespace": "indices.migrate_reindex" + }, + "specLocation": "indices/migrate_reindex/MigrateReindexRequest.ts#L51-L53" + }, + { + "kind": "request", + "attachedBehaviors": [ + "CommonQueryParameters" + ], + "body": { + "kind": "value", + "codegenName": "reindex", + "value": { + "kind": "instance_of", + "type": { + "name": "MigrateReindex", + "namespace": "indices.migrate_reindex" + } + } + }, + "description": "\"This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task", + "inherits": { + "type": { + "name": "RequestBase", + "namespace": "_types" + } + }, + "name": { + "name": "Request", + "namespace": "indices.migrate_reindex" + }, + "path": [], + "query": [], + "specLocation": "indices/migrate_reindex/MigrateReindexRequest.ts#L23-L34" + }, + { + "kind": "response", + "body": { + "kind": "value", + "value": { + "kind": "instance_of", + "type": { + "name": "AcknowledgedResponseBase", + "namespace": "_types" + } + } + }, + "name": { + "name": "Response", + "namespace": "indices.migrate_reindex" + }, + "specLocation": "indices/migrate_reindex/MigrateReindexResponse.ts#L22-L24" + }, + { + "kind": "interface", + "name": { + "name": "SourceIndex", + "namespace": "indices.migrate_reindex" + }, + "properties": [ + { + "name": "index", + "required": true, + "type": { + "kind": "instance_of", + "type": { + "name": "IndexName", + "namespace": "_types" + } + } + } + ], + "specLocation": "indices/migrate_reindex/MigrateReindexRequest.ts#L47-L49" + }, { "kind": "request", "attachedBehaviors": [ @@ -154132,574 +154701,6 @@ }, "specLocation": "logstash/put_pipeline/LogstashPutPipelineResponse.ts#L22-L24" }, - { - "kind": "request", - "attachedBehaviors": [ - "CommonQueryParameters" - ], - "body": { - "kind": "no_body" - }, - "description": "This API cancels a migration reindex attempt for a data stream or index", - "inherits": { - "type": { - "name": "RequestBase", - "namespace": "_types" - } - }, - "name": { - "name": "Request", - "namespace": "migrate.cancel_reindex" - }, - "path": [ - { - "description": "The index or data stream name", - "name": "index", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "Indices", - "namespace": "_types" - } - } - } - ], - "query": [], - "specLocation": "migrate/cancel_reindex/MigrateCancelReindexRequest.ts#L23-L37" - }, - { - "kind": "response", - "body": { - "kind": "value", - "value": { - "kind": "instance_of", - "type": { - "name": "AcknowledgedResponseBase", - "namespace": "_types" - } - } - }, - "name": { - "name": "Response", - "namespace": "migrate.cancel_reindex" - }, - "specLocation": "migrate/cancel_reindex/MigrateCancelReindexResponse.ts#L22-L24" - }, - { - "kind": "interface", - "name": { - "name": "CreateFrom", - "namespace": "migrate.create_from" - }, - "properties": [ - { - "description": "Mappings overrides to be applied to the destination index (optional)", - "name": "mappings_override", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "TypeMapping", - "namespace": "_types.mapping" - } - } - }, - { - "description": "Settings overrides to be applied to the destination index (optional)", - "name": "settings_override", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "IndexSettings", - "namespace": "indices._types" - } - } - }, - { - "description": "If index blocks should be removed when creating destination index (optional)", - "name": "remove_index_blocks", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } - } - ], - "specLocation": "migrate/create_from/MigrateCreateFromRequest.ts#L45-L58" - }, - { - "kind": "request", - "attachedBehaviors": [ - "CommonQueryParameters" - ], - "body": { - "kind": "value", - "codegenName": "create_from", - "value": { - "kind": "instance_of", - "type": { - "name": "CreateFrom", - "namespace": "migrate.create_from" - } - } - }, - "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values.", - "inherits": { - "type": { - "name": "RequestBase", - "namespace": "_types" - } - }, - "name": { - "name": "Request", - "namespace": "migrate.create_from" - }, - "path": [ - { - "description": "The source index or data stream name", - "name": "source", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "IndexName", - "namespace": "_types" - } - } - }, - { - "description": "The destination index or data stream name", - "name": "dest", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "IndexName", - "namespace": "_types" - } - } - } - ], - "query": [], - "specLocation": "migrate/create_from/MigrateCreateFromRequest.ts#L25-L43" - }, - { - "kind": "response", - "body": { - "kind": "properties", - "properties": [ - { - "name": "acknowledged", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } - }, - { - "name": "index", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "IndexName", - "namespace": "_types" - } - } - }, - { - "name": "shards_acknowledged", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } - } - ] - }, - "name": { - "name": "Response", - "namespace": "migrate.create_from" - }, - "specLocation": "migrate/create_from/MigrateCreateFromResponse.ts#L22-L28" - }, - { - "kind": "request", - "attachedBehaviors": [ - "CommonQueryParameters" - ], - "body": { - "kind": "no_body" - }, - "description": "This API returns the status of a migration reindex attempt for a data stream or index", - "inherits": { - "type": { - "name": "RequestBase", - "namespace": "_types" - } - }, - "name": { - "name": "Request", - "namespace": "migrate.get_reindex_status" - }, - "path": [ - { - "description": "The index or data stream name", - "name": "index", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "Indices", - "namespace": "_types" - } - } - } - ], - "query": [], - "specLocation": "migrate/get_reindex_status/MigrateGetReindexStatusRequest.ts#L23-L37" - }, - { - "kind": "response", - "body": { - "kind": "properties", - "properties": [ - { - "name": "start_time", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "DateTime", - "namespace": "_types" - } - } - }, - { - "name": "start_time_millis", - "required": true, - "type": { - "kind": "instance_of", - "generics": [ - { - "kind": "instance_of", - "type": { - "name": "UnitMillis", - "namespace": "_types" - } - } - ], - "type": { - "name": "EpochTime", - "namespace": "_types" - } - } - }, - { - "name": "complete", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } - }, - { - "name": "total_indices_in_data_stream", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "integer", - "namespace": "_types" - } - } - }, - { - "name": "total_indices_requiring_upgrade", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "integer", - "namespace": "_types" - } - } - }, - { - "name": "successes", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "integer", - "namespace": "_types" - } - } - }, - { - "name": "in_progress", - "required": true, - "type": { - "kind": "array_of", - "value": { - "kind": "instance_of", - "type": { - "name": "StatusInProgress", - "namespace": "migrate.get_reindex_status" - } - } - } - }, - { - "name": "pending", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "integer", - "namespace": "_types" - } - } - }, - { - "name": "errors", - "required": true, - "type": { - "kind": "array_of", - "value": { - "kind": "instance_of", - "type": { - "name": "StatusError", - "namespace": "migrate.get_reindex_status" - } - } - } - }, - { - "name": "exception", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "string", - "namespace": "_builtins" - } - } - } - ] - }, - "name": { - "name": "Response", - "namespace": "migrate.get_reindex_status" - }, - "specLocation": "migrate/get_reindex_status/MigrateGetReindexStatusResponse.ts#L23-L36" - }, - { - "kind": "interface", - "name": { - "name": "StatusError", - "namespace": "migrate.get_reindex_status" - }, - "properties": [ - { - "name": "index", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "string", - "namespace": "_builtins" - } - } - }, - { - "name": "message", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "string", - "namespace": "_builtins" - } - } - } - ], - "specLocation": "migrate/get_reindex_status/MigrateGetReindexStatusResponse.ts#L44-L47" - }, - { - "kind": "interface", - "name": { - "name": "StatusInProgress", - "namespace": "migrate.get_reindex_status" - }, - "properties": [ - { - "name": "index", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "string", - "namespace": "_builtins" - } - } - }, - { - "name": "total_doc_count", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "long", - "namespace": "_types" - } - } - }, - { - "name": "reindexed_doc_count", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "long", - "namespace": "_types" - } - } - } - ], - "specLocation": "migrate/get_reindex_status/MigrateGetReindexStatusResponse.ts#L38-L42" - }, - { - "kind": "interface", - "name": { - "name": "MigrateReindex", - "namespace": "migrate.reindex" - }, - "properties": [ - { - "description": "Reindex mode. Currently only 'upgrade' is supported.", - "name": "mode", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "ModeEnum", - "namespace": "migrate.reindex" - } - } - }, - { - "description": "The source index or data stream (only data streams are currently supported).", - "name": "source", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "SourceIndex", - "namespace": "migrate.reindex" - } - } - } - ], - "specLocation": "migrate/reindex/MigrateReindexRequest.ts#L36-L45" - }, - { - "kind": "enum", - "members": [ - { - "name": "upgrade" - } - ], - "name": { - "name": "ModeEnum", - "namespace": "migrate.reindex" - }, - "specLocation": "migrate/reindex/MigrateReindexRequest.ts#L51-L53" - }, - { - "kind": "request", - "attachedBehaviors": [ - "CommonQueryParameters" - ], - "body": { - "kind": "value", - "codegenName": "reindex", - "value": { - "kind": "instance_of", - "type": { - "name": "MigrateReindex", - "namespace": "migrate.reindex" - } - } - }, - "description": "\"This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task", - "inherits": { - "type": { - "name": "RequestBase", - "namespace": "_types" - } - }, - "name": { - "name": "Request", - "namespace": "migrate.reindex" - }, - "path": [], - "query": [], - "specLocation": "migrate/reindex/MigrateReindexRequest.ts#L23-L34" - }, - { - "kind": "response", - "body": { - "kind": "value", - "value": { - "kind": "instance_of", - "type": { - "name": "AcknowledgedResponseBase", - "namespace": "_types" - } - } - }, - "name": { - "name": "Response", - "namespace": "migrate.reindex" - }, - "specLocation": "migrate/reindex/MigrateReindexResponse.ts#L22-L24" - }, - { - "kind": "interface", - "name": { - "name": "SourceIndex", - "namespace": "migrate.reindex" - }, - "properties": [ - { - "name": "index", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "IndexName", - "namespace": "_types" - } - } - } - ], - "specLocation": "migrate/reindex/MigrateReindexRequest.ts#L47-L49" - }, { "kind": "interface", "name": { diff --git a/output/typescript/types.ts b/output/typescript/types.ts index 077fc5c295..35017b07be 100644 --- a/output/typescript/types.ts +++ b/output/typescript/types.ts @@ -11618,6 +11618,12 @@ export interface IndicesAnalyzeTokenDetail { tokens: IndicesAnalyzeExplainAnalyzeToken[] } +export interface IndicesCancelMigrateReindexRequest extends RequestBase { + index: Indices +} + +export type IndicesCancelMigrateReindexResponse = AcknowledgedResponseBase + export interface IndicesClearCacheRequest extends RequestBase { index?: Indices allow_no_indices?: boolean @@ -11700,6 +11706,24 @@ export interface IndicesCreateDataStreamRequest extends RequestBase { export type IndicesCreateDataStreamResponse = AcknowledgedResponseBase +export interface IndicesCreateFromCreateFrom { + mappings_override?: MappingTypeMapping + settings_override?: IndicesIndexSettings + remove_index_blocks?: boolean +} + +export interface IndicesCreateFromRequest extends RequestBase { + source: IndexName + dest: IndexName + body?: IndicesCreateFromCreateFrom +} + +export interface IndicesCreateFromResponse { + acknowledged: boolean + index: IndexName + shards_acknowledged: boolean +} + export interface IndicesDataStreamsStatsDataStreamsStatsItem { backing_indices: integer data_stream: Name @@ -12063,6 +12087,34 @@ export interface IndicesGetMappingRequest extends RequestBase { export type IndicesGetMappingResponse = Record +export interface IndicesGetMigrateReindexStatusRequest extends RequestBase { + index: Indices +} + +export interface IndicesGetMigrateReindexStatusResponse { + start_time?: DateTime + start_time_millis: EpochTime + complete: boolean + total_indices_in_data_stream: integer + total_indices_requiring_upgrade: integer + successes: integer + in_progress: IndicesGetMigrateReindexStatusStatusInProgress[] + pending: integer + errors: IndicesGetMigrateReindexStatusStatusError[] + exception?: string +} + +export interface IndicesGetMigrateReindexStatusStatusError { + index: string + message: string +} + +export interface IndicesGetMigrateReindexStatusStatusInProgress { + index: string + total_doc_count: long + reindexed_doc_count: long +} + export interface IndicesGetSettingsRequest extends RequestBase { index?: Indices name?: Names @@ -12086,6 +12138,23 @@ export interface IndicesGetTemplateRequest extends RequestBase { export type IndicesGetTemplateResponse = Record +export interface IndicesMigrateReindexMigrateReindex { + mode: IndicesMigrateReindexModeEnum + source: IndicesMigrateReindexSourceIndex +} + +export type IndicesMigrateReindexModeEnum = 'upgrade' + +export interface IndicesMigrateReindexRequest extends RequestBase { + body?: IndicesMigrateReindexMigrateReindex +} + +export type IndicesMigrateReindexResponse = AcknowledgedResponseBase + +export interface IndicesMigrateReindexSourceIndex { + index: IndexName +} + export interface IndicesMigrateToDataStreamRequest extends RequestBase { name: IndexName master_timeout?: Duration @@ -13888,75 +13957,6 @@ export interface LogstashPutPipelineRequest extends RequestBase { export type LogstashPutPipelineResponse = boolean -export interface MigrateCancelReindexRequest extends RequestBase { - index: Indices -} - -export type MigrateCancelReindexResponse = AcknowledgedResponseBase - -export interface MigrateCreateFromCreateFrom { - mappings_override?: MappingTypeMapping - settings_override?: IndicesIndexSettings - remove_index_blocks?: boolean -} - -export interface MigrateCreateFromRequest extends RequestBase { - source: IndexName - dest: IndexName - body?: MigrateCreateFromCreateFrom -} - -export interface MigrateCreateFromResponse { - acknowledged: boolean - index: IndexName - shards_acknowledged: boolean -} - -export interface MigrateGetReindexStatusRequest extends RequestBase { - index: Indices -} - -export interface MigrateGetReindexStatusResponse { - start_time?: DateTime - start_time_millis: EpochTime - complete: boolean - total_indices_in_data_stream: integer - total_indices_requiring_upgrade: integer - successes: integer - in_progress: MigrateGetReindexStatusStatusInProgress[] - pending: integer - errors: MigrateGetReindexStatusStatusError[] - exception?: string -} - -export interface MigrateGetReindexStatusStatusError { - index: string - message: string -} - -export interface MigrateGetReindexStatusStatusInProgress { - index: string - total_doc_count: long - reindexed_doc_count: long -} - -export interface MigrateReindexMigrateReindex { - mode: MigrateReindexModeEnum - source: MigrateReindexSourceIndex -} - -export type MigrateReindexModeEnum = 'upgrade' - -export interface MigrateReindexRequest extends RequestBase { - body?: MigrateReindexMigrateReindex -} - -export type MigrateReindexResponse = AcknowledgedResponseBase - -export interface MigrateReindexSourceIndex { - index: IndexName -} - export interface MigrationDeprecationsDeprecation { details?: string level: MigrationDeprecationsDeprecationLevel diff --git a/specification/_json_spec/migrate.cancel_reindex.json b/specification/_json_spec/indices.cancel_migrate_reindex.json similarity index 95% rename from specification/_json_spec/migrate.cancel_reindex.json rename to specification/_json_spec/indices.cancel_migrate_reindex.json index 660bd47272..9c333c2736 100644 --- a/specification/_json_spec/migrate.cancel_reindex.json +++ b/specification/_json_spec/indices.cancel_migrate_reindex.json @@ -1,5 +1,5 @@ { - "migrate.cancel_reindex": { + "indices.cancel_migrate_reindex": { "documentation": { "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html", "description": "This API returns the status of a migration reindex attempt for a data stream or index" diff --git a/specification/_json_spec/migrate.create_from.json b/specification/_json_spec/indices.create_from.json similarity index 97% rename from specification/_json_spec/migrate.create_from.json rename to specification/_json_spec/indices.create_from.json index e0d31a2e4c..76fb06d072 100644 --- a/specification/_json_spec/migrate.create_from.json +++ b/specification/_json_spec/indices.create_from.json @@ -1,5 +1,5 @@ { - "migrate.create_from": { + "indices.create_from": { "documentation": { "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html", "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values." diff --git a/specification/_json_spec/migrate.get_reindex_status.json b/specification/_json_spec/indices.get_migrate_reindex_status.json similarity index 94% rename from specification/_json_spec/migrate.get_reindex_status.json rename to specification/_json_spec/indices.get_migrate_reindex_status.json index d5361ff1bb..309d44f137 100644 --- a/specification/_json_spec/migrate.get_reindex_status.json +++ b/specification/_json_spec/indices.get_migrate_reindex_status.json @@ -1,5 +1,5 @@ { - "migrate.get_reindex_status": { + "indices.get_migrate_reindex_status": { "documentation": { "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html", "description": "This API returns the status of a migration reindex attempt for a data stream or index" diff --git a/specification/_json_spec/migrate.reindex.json b/specification/_json_spec/indices.migrate_reindex.json similarity index 96% rename from specification/_json_spec/migrate.reindex.json rename to specification/_json_spec/indices.migrate_reindex.json index ae2e6a8f8a..1f69103497 100644 --- a/specification/_json_spec/migrate.reindex.json +++ b/specification/_json_spec/indices.migrate_reindex.json @@ -1,5 +1,5 @@ { - "migrate.reindex": { + "indices.migrate_reindex": { "documentation": { "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html", "description": "This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task" diff --git a/specification/migrate/cancel_reindex/MigrateCancelReindexRequest.ts b/specification/indices/cancel_migrate_reindex/MigrateCancelReindexRequest.ts similarity index 96% rename from specification/migrate/cancel_reindex/MigrateCancelReindexRequest.ts rename to specification/indices/cancel_migrate_reindex/MigrateCancelReindexRequest.ts index a58b77ea9a..a10251e578 100644 --- a/specification/migrate/cancel_reindex/MigrateCancelReindexRequest.ts +++ b/specification/indices/cancel_migrate_reindex/MigrateCancelReindexRequest.ts @@ -23,7 +23,7 @@ import { Indices } from '@_types/common' /** * This API cancels a migration reindex attempt for a data stream or index * - * @rest_spec_name migrate.cancel_reindex + * @rest_spec_name indices.cancel_migrate_reindex * @availability stack since=8.18.0 stability=experimental * @availability serverless stability=experimental visibility=private * @doc_id migrate diff --git a/specification/migrate/cancel_reindex/MigrateCancelReindexResponse.ts b/specification/indices/cancel_migrate_reindex/MigrateCancelReindexResponse.ts similarity index 100% rename from specification/migrate/cancel_reindex/MigrateCancelReindexResponse.ts rename to specification/indices/cancel_migrate_reindex/MigrateCancelReindexResponse.ts diff --git a/specification/migrate/create_from/MigrateCreateFromRequest.ts b/specification/indices/create_from/MigrateCreateFromRequest.ts similarity index 98% rename from specification/migrate/create_from/MigrateCreateFromRequest.ts rename to specification/indices/create_from/MigrateCreateFromRequest.ts index 2c916ae2eb..1270e4fed7 100644 --- a/specification/migrate/create_from/MigrateCreateFromRequest.ts +++ b/specification/indices/create_from/MigrateCreateFromRequest.ts @@ -25,7 +25,7 @@ import { TypeMapping } from '@_types/mapping/TypeMapping' /** * This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values. * - * @rest_spec_name migrate.create_from + * @rest_spec_name indices.create_from * @availability stack since=8.18.0 stability=experimental * @availability serverless stability=experimental visibility=private * @doc_id migrate diff --git a/specification/migrate/create_from/MigrateCreateFromResponse.ts b/specification/indices/create_from/MigrateCreateFromResponse.ts similarity index 100% rename from specification/migrate/create_from/MigrateCreateFromResponse.ts rename to specification/indices/create_from/MigrateCreateFromResponse.ts diff --git a/specification/migrate/get_reindex_status/MigrateGetReindexStatusRequest.ts b/specification/indices/get_migrate_reindex_status/MigrateGetReindexStatusRequest.ts similarity index 95% rename from specification/migrate/get_reindex_status/MigrateGetReindexStatusRequest.ts rename to specification/indices/get_migrate_reindex_status/MigrateGetReindexStatusRequest.ts index b5396085f4..50ffca9646 100644 --- a/specification/migrate/get_reindex_status/MigrateGetReindexStatusRequest.ts +++ b/specification/indices/get_migrate_reindex_status/MigrateGetReindexStatusRequest.ts @@ -23,7 +23,7 @@ import { Indices } from '@_types/common' /** * This API returns the status of a migration reindex attempt for a data stream or index * - * @rest_spec_name migrate.get_reindex_status + * @rest_spec_name indices.get_migrate_reindex_status * @availability stack since=8.18.0 stability=experimental * @availability serverless stability=experimental visibility=private * @doc_id migrate diff --git a/specification/migrate/get_reindex_status/MigrateGetReindexStatusResponse.ts b/specification/indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts similarity index 100% rename from specification/migrate/get_reindex_status/MigrateGetReindexStatusResponse.ts rename to specification/indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts diff --git a/specification/migrate/reindex/MigrateReindexRequest.ts b/specification/indices/migrate_reindex/MigrateReindexRequest.ts similarity index 97% rename from specification/migrate/reindex/MigrateReindexRequest.ts rename to specification/indices/migrate_reindex/MigrateReindexRequest.ts index f156a26ffd..7a711ab7af 100644 --- a/specification/migrate/reindex/MigrateReindexRequest.ts +++ b/specification/indices/migrate_reindex/MigrateReindexRequest.ts @@ -23,7 +23,7 @@ import { IndexName } from '@_types/common' /** * "This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task * - * @rest_spec_name migrate.reindex + * @rest_spec_name indices.migrate_reindex * @availability stack since=8.18.0 stability=experimental * @doc_id migrate * @doc_tag migration diff --git a/specification/migrate/reindex/MigrateReindexResponse.ts b/specification/indices/migrate_reindex/MigrateReindexResponse.ts similarity index 100% rename from specification/migrate/reindex/MigrateReindexResponse.ts rename to specification/indices/migrate_reindex/MigrateReindexResponse.ts