Get stack versions
By default, retrieves only the available Elastic Stack versions. To retrieve all of the Elastic Stack versions, use the show_deleted parameter
.
Query parameters
-
show_deleted
boolean Whether to show deleted stack versions or not
Default value is
false
. -
show_unusable
boolean Whether to show versions that are unusable by the authenticated user
Default value is
false
.
Responses
-
200 application/json
The list of all available Elastic Stack versions are retrieved, including the template version and structure.
Hide response attribute Show response attribute object
-
stacks
array[object] Required The details for an Elastic Stack configuration.
Hide stacks attributes Show stacks attributes object
-
version
string Stack version
-
template
object Required The template information for an Elastic Stack version.
Hide template attributes Show template attributes object
-
template_version
string Template version
-
hashes
array[object] Relative paths of files with SHA-256 hashes that contains the template
The template file hash for an Elastic Stack version.
-
-
elasticsearch
object Required The Elasticsearch configuration for an Elastic Stack version.
Hide elasticsearch attributes Show elasticsearch attributes object
-
docker_image
string Required Docker image for the Elasticsearch
-
plugins
array[string] Required List of available plugins
-
default_plugins
array[string] Required List of default plugins
-
blacklist
array[string] Required List of configuration options that cannot be overridden by user settings
-
node_types
array[object] Node types that are supported by this stack version
The configuration for an Elastic Stack node type.
Hide node_types attributes Show node_types attributes object
-
node_type
string Required Type of the node (master, data, ...)
-
name
string Required Name of the node type
-
description
string Required Description of the node type
-
settings
object Settings that are applied to all nodes of this type
-
capacity_constraints
object WARNING This endpoint is deprecated and scheduled to be removed in the next major version. This field will soon be removed in favor of having a global capacity constraint for all node types.
Capacity constraints for the node type
-
compatible_node_types
array[string] Node types that are compatible with this one
-
mandatory
boolean Flag to specify a node type is mandatory in a cluster's plan
-
-
settings
object Settings that are applied to all nodes of this type
-
capacity_constraints
object WARNING This endpoint is deprecated and scheduled to be removed in the next major version. This field will soon be removed in favor of having a global capacity constraint for all node types.
Capacity constraints for the node type
-
compatible_node_types
array[string] Node types that are compatible with this one
-
-
kibana
object Required The Kibana configuration for an Elastic Stack version.
Hide kibana attributes Show kibana attributes object
-
version
string Version of Kibana
-
docker_image
string Required Docker image for the kibana
-
blacklist
array[string] Required List of configuration options that cannot be overridden by user settings
-
settings
object Settings that are applied to all nodes of this type
-
capacity_constraints
object WARNING This endpoint is deprecated and scheduled to be removed in the next major version. This field will soon be removed in favor of having a global capacity constraint for all node types.
Capacity constraints for the node type
-
compatible_node_types
array[string] Node types that are compatible with this one
-
-
apm
object The APM Server configuration for an Elastic Stack version.
Hide apm attributes Show apm attributes object
-
version
string Version of APM
-
docker_image
string Required Docker image for the APM
-
blacklist
array[string] Required List of configuration options that cannot be overridden by user settings
-
settings
object Settings that are applied to all nodes of this type
-
capacity_constraints
object WARNING This endpoint is deprecated and scheduled to be removed in the next major version. This field will soon be removed in favor of having a global capacity constraint for all node types.
Capacity constraints for the node type
-
compatible_node_types
array[string] Node types that are compatible with this one
-
-
appsearch
object AppSearch related configuration of an Elastic Stack version
Hide appsearch attributes Show appsearch attributes object
-
version
string Version of AppSearch
-
docker_image
string Required Docker image for the AppSearch
-
blacklist
array[string] Required List of configuration options that cannot be overridden by user settings
-
settings
object Settings that are applied to all nodes of this type
-
capacity_constraints
object WARNING This endpoint is deprecated and scheduled to be removed in the next major version. This field will soon be removed in favor of having a global capacity constraint for all node types.
Capacity constraints for the node type
-
compatible_node_types
array[string] Node types that are compatible with this one
-
node_types
array[object] Node types that are supported by this stack version
The configuration for an Elastic Stack node type.
Hide node_types attributes Show node_types attributes object
-
node_type
string Required Type of the node (master, data, ...)
-
name
string Required Name of the node type
-
description
string Required Description of the node type
-
settings
object Settings that are applied to all nodes of this type
-
capacity_constraints
object WARNING This endpoint is deprecated and scheduled to be removed in the next major version. This field will soon be removed in favor of having a global capacity constraint for all node types.
Capacity constraints for the node type
-
compatible_node_types
array[string] Node types that are compatible with this one
-
mandatory
boolean Flag to specify a node type is mandatory in a cluster's plan
-
-
-
metadata
object The metadata for the Elastic Stack.
Hide metadata attributes Show metadata attributes object
-
notes
string Notes for administrator
-
pre_release
boolean Indicates that the stack pack version is not GA and is not supposed to be used in production
-
min_platform_version
string The minimum version of the platform that the stack pack version is compatible with
-
The minimum version required for performing a rolling upgrade to this stack version.
-
The minimum version required for performing a full cluster restart upgrade to this stack version.
-
schema_version
integer(int32) The schema version of the stack pack version
-
-
deleted
boolean Identifies that the Elastic Stack version is marked for deletion
-
upgradable_to
array[string] Required Stack Versions that this version can upgrade to
-
min_upgradable_from
string The minimum version recommended to upgrade this version.
-
whitelisted
boolean Whether or not this version is whitelisted. This is only relevant in EC (SaaS) and is not sent in ECE.
-
accessible
boolean Whether or not this version is accessible by the calling user. This is only relevant in EC (SaaS) and is not sent in ECE.
-
rolling_upgrade_compatible_versions
array[string] List of versions that can be upgraded to the current version of the stackpack
-
-
curl \
--request GET 'https://api.elastic-cloud.com/api/v1/stack/versions'