AWS::Elasticsearch::Domain ElasticsearchClusterConfig - AWS CloudFormation (original) (raw)

The cluster configuration for the OpenSearch Service domain. You can specify options such as the instance type and the number of instances. For more information, see Creating and managing Amazon OpenSearch Service domains in the Amazon OpenSearch Service Developer Guide.

Important

The AWS::Elasticsearch::Domain resource is being replaced by the AWS::OpenSearchService::Domain resource. While the legacy Elasticsearch resource and options are still supported, we recommend modifying your existing Cloudformation templates to use the new OpenSearch Service resource, which supports both OpenSearch and Elasticsearch. For more information about the service rename, see New resource types in the Amazon OpenSearch Service Developer Guide.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "ColdStorageOptions" : ColdStorageOptions,
  "DedicatedMasterCount" : Integer,
  "DedicatedMasterEnabled" : Boolean,
  "DedicatedMasterType" : String,
  "InstanceCount" : Integer,
  "InstanceType" : String,
  "WarmCount" : Integer,
  "WarmEnabled" : Boolean,
  "WarmType" : String,
  "ZoneAwarenessConfig" : ZoneAwarenessConfig,
  "ZoneAwarenessEnabled" : Boolean
}

Properties

ColdStorageOptions

Specifies cold storage options for the domain.

Required: No

Type: ColdStorageOptions

Update requires: No interruption

DedicatedMasterCount

The number of instances to use for the master node. If you specify this property, you must specify true for the DedicatedMasterEnabled property.

Required: No

Type: Integer

Update requires: No interruption

DedicatedMasterEnabled

Indicates whether to use a dedicated master node for the OpenSearch Service domain. A dedicated master node is a cluster node that performs cluster management tasks, but doesn't hold data or respond to data upload requests. Dedicated master nodes offload cluster management tasks to increase the stability of your search clusters. See Dedicated master nodes in Amazon OpenSearch Service.

Required: No

Type: Boolean

Update requires: No interruption

DedicatedMasterType

The hardware configuration of the computer that hosts the dedicated master node, such asm3.medium.elasticsearch. If you specify this property, you must specify true for the DedicatedMasterEnabled property. For valid values, see Supported instance types in Amazon OpenSearch Service.

Required: No

Type: String

Update requires: No interruption

InstanceCount

The number of data nodes (instances) to use in the OpenSearch Service domain.

Required: No

Type: Integer

Update requires: No interruption

InstanceType

The instance type for your data nodes, such as m3.medium.elasticsearch. For valid values, see Supported instance types in Amazon OpenSearch Service .

Required: No

Type: String

Update requires: No interruption

WarmCount

The number of warm nodes in the cluster. Required if you enable warm storage.

Required: Conditional

Type: Integer

Update requires: No interruption

WarmEnabled

Whether to enable warm storage for the cluster.

Required: No

Type: Boolean

Update requires: No interruption

WarmType

The instance type for the cluster's warm nodes. Required if you enable warm storage.

Required: Conditional

Type: String

Update requires: No interruption

ZoneAwarenessConfig

Specifies zone awareness configuration options. Only use ifZoneAwarenessEnabled is true.

Required: Conditional

Type: ZoneAwarenessConfig

Update requires: No interruption

ZoneAwarenessEnabled

Indicates whether to enable zone awareness for the OpenSearch Service domain. When you enable zone awareness, OpenSearch Service allocates the nodes and replica index shards that belong to a cluster across two Availability Zones (AZs) in the same region to prevent data loss and minimize downtime in the event of node or data center failure. Don't enable zone awareness if your cluster has no replica index shards or is a single-node cluster. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

Required: No

Type: Boolean

Update requires: No interruption