software.amazon.awscdk.services.elasticsearch

Class Domain

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.elasticsearch.Domain

All Implemented Interfaces:

IResource, IConnectable, IDomain, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:21.039Z")
 @Stability(value=Experimental)
public class Domain
extends Resource
implements IDomain, IConnectable

(experimental) Provides an Elasticsearch domain.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Domain.Builder (experimental) A fluent builder for Domain.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.elasticsearch.IDomain

IDomain.Jsii$Default, IDomain.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.ec2.IConnectable

IConnectable.Jsii$Default, IConnectable.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
	Domain(software.constructs.Construct scope, String id, DomainProps props)
protected	Domain(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Domain(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static IDomain	fromDomainAttributes(software.constructs.Construct scope, String id, DomainAttributes attrs) (experimental) Creates a Domain construct that represents an external domain.
static IDomain	fromDomainEndpoint(software.constructs.Construct scope, String id, String domainEndpoint) (experimental) Creates a Domain construct that represents an external domain via domain endpoint.
ILogGroup	getAppLogGroup() (experimental) Log group that application logs are logged to.
ILogGroup	getAuditLogGroup() (experimental) Log group that audit logs are logged to.
Connections	getConnections() (experimental) Manages network connections to the domain.
String	getDomainArn() (experimental) Arn of the Elasticsearch domain.
String	getDomainEndpoint() (experimental) Endpoint of the Elasticsearch domain.
String	getDomainName() (experimental) Domain name of the Elasticsearch domain.
SecretValue	getMasterUserPassword() (experimental) Master user password if fine grained access control is configured.
ILogGroup	getSlowIndexLogGroup() (experimental) Log group that slow indices are logged to.
ILogGroup	getSlowSearchLogGroup() (experimental) Log group that slow searches are logged to.
Grant	grantIndexRead(String index, IGrantable identity) (experimental) Grant read permissions for an index in this domain to an IAM principal (Role/Group/User).
Grant	grantIndexReadWrite(String index, IGrantable identity) (experimental) Grant read/write permissions for an index in this domain to an IAM principal (Role/Group/User).
Grant	grantIndexWrite(String index, IGrantable identity) (experimental) Grant write permissions for an index in this domain to an IAM principal (Role/Group/User).
Grant	grantPathRead(String path, IGrantable identity) (experimental) Grant read permissions for a specific path in this domain to an IAM principal (Role/Group/User).
Grant	grantPathReadWrite(String path, IGrantable identity) (experimental) Grant read/write permissions for a specific path in this domain to an IAM principal (Role/Group/User).
Grant	grantPathWrite(String path, IGrantable identity) (experimental) Grant write permissions for a specific path in this domain to an IAM principal (Role/Group/User).
Grant	grantRead(IGrantable identity) (experimental) Grant read permissions for this domain and its contents to an IAM principal (Role/Group/User).
Grant	grantReadWrite(IGrantable identity) (experimental) Grant read/write permissions for this domain and its contents to an IAM principal (Role/Group/User).
Grant	grantWrite(IGrantable identity) (experimental) Grant write permissions for this domain and its contents to an IAM principal (Role/Group/User).
Metric	metric(String metricName) (experimental) Return the given named metric for this Domain.
Metric	metric(String metricName, MetricOptions props) (experimental) Return the given named metric for this Domain.
Metric	metricAutomatedSnapshotFailure() (experimental) Metric for automated snapshot failures.
Metric	metricAutomatedSnapshotFailure(MetricOptions props) (experimental) Metric for automated snapshot failures.
Metric	metricClusterIndexWritesBlocked() (experimental) Metric for the cluster blocking index writes.
Metric	metricClusterIndexWritesBlocked(MetricOptions props) (experimental) Metric for the cluster blocking index writes.
Metric	metricClusterStatusRed() (experimental) Metric for the time the cluster status is red.
Metric	metricClusterStatusRed(MetricOptions props) (experimental) Metric for the time the cluster status is red.
Metric	metricClusterStatusYellow() (experimental) Metric for the time the cluster status is yellow.
Metric	metricClusterStatusYellow(MetricOptions props) (experimental) Metric for the time the cluster status is yellow.
Metric	metricCPUUtilization() (experimental) Metric for CPU utilization.
Metric	metricCPUUtilization(MetricOptions props) (experimental) Metric for CPU utilization.
Metric	metricFreeStorageSpace() (experimental) Metric for the storage space of nodes in the cluster.
Metric	metricFreeStorageSpace(MetricOptions props) (experimental) Metric for the storage space of nodes in the cluster.
Metric	metricIndexingLatency() (experimental) Metric for indexing latency.
Metric	metricIndexingLatency(MetricOptions props) (experimental) Metric for indexing latency.
Metric	metricJVMMemoryPressure() (experimental) Metric for JVM memory pressure.
Metric	metricJVMMemoryPressure(MetricOptions props) (experimental) Metric for JVM memory pressure.
Metric	metricKMSKeyError() (experimental) Metric for KMS key errors.
Metric	metricKMSKeyError(MetricOptions props) (experimental) Metric for KMS key errors.
Metric	metricKMSKeyInaccessible() (experimental) Metric for KMS key being inaccessible.
Metric	metricKMSKeyInaccessible(MetricOptions props) (experimental) Metric for KMS key being inaccessible.
Metric	metricMasterCPUUtilization() (experimental) Metric for master CPU utilization.
Metric	metricMasterCPUUtilization(MetricOptions props) (experimental) Metric for master CPU utilization.
Metric	metricMasterJVMMemoryPressure() (experimental) Metric for master JVM memory pressure.
Metric	metricMasterJVMMemoryPressure(MetricOptions props) (experimental) Metric for master JVM memory pressure.
Metric	metricNodes() (experimental) Metric for the number of nodes.
Metric	metricNodes(MetricOptions props) (experimental) Metric for the number of nodes.
Metric	metricSearchableDocuments() (experimental) Metric for number of searchable documents.
Metric	metricSearchableDocuments(MetricOptions props) (experimental) Metric for number of searchable documents.
Metric	metricSearchLatency() (experimental) Metric for search latency.
Metric	metricSearchLatency(MetricOptions props) (experimental) Metric for search latency.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Domain

protected Domain(software.amazon.jsii.JsiiObjectRef objRef)

Domain

protected Domain(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Domain

@Stability(value=Experimental)
public Domain(@NotNull
                                             software.constructs.Construct scope,
                                             @NotNull
                                             String id,
                                             @NotNull
                                             DomainProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromDomainAttributes

@Stability(value=Experimental)
 @NotNull
public static IDomain fromDomainAttributes(@NotNull
                                                                                    software.constructs.Construct scope,
                                                                                    @NotNull
                                                                                    String id,
                                                                                    @NotNull
                                                                                    DomainAttributes attrs)

(experimental) Creates a Domain construct that represents an external domain.

Parameters:

scope - The parent creating construct (usually `this`). This parameter is required.

id - The construct's name. This parameter is required.

attrs - A `DomainAttributes` object. This parameter is required.

fromDomainEndpoint

@Stability(value=Experimental)
 @NotNull
public static IDomain fromDomainEndpoint(@NotNull
                                                                                  software.constructs.Construct scope,
                                                                                  @NotNull
                                                                                  String id,
                                                                                  @NotNull
                                                                                  String domainEndpoint)

(experimental) Creates a Domain construct that represents an external domain via domain endpoint.

Parameters:

scope - The parent creating construct (usually `this`). This parameter is required.

id - The construct's name. This parameter is required.

domainEndpoint - The domain's endpoint. This parameter is required.

grantIndexRead

@Stability(value=Experimental)
 @NotNull
public Grant grantIndexRead(@NotNull
                                                                     String index,
                                                                     @NotNull
                                                                     IGrantable identity)

(experimental) Grant read permissions for an index in this domain to an IAM principal (Role/Group/User).

Specified by:

grantIndexRead in interface IDomain

Parameters:

index - The index to grant permissions for. This parameter is required.

identity - The principal. This parameter is required.

grantIndexReadWrite

@Stability(value=Experimental)
 @NotNull
public Grant grantIndexReadWrite(@NotNull
                                                                          String index,
                                                                          @NotNull
                                                                          IGrantable identity)

(experimental) Grant read/write permissions for an index in this domain to an IAM principal (Role/Group/User).

Specified by:

grantIndexReadWrite in interface IDomain

Parameters:

index - The index to grant permissions for. This parameter is required.

identity - The principal. This parameter is required.

grantIndexWrite

@Stability(value=Experimental)
 @NotNull
public Grant grantIndexWrite(@NotNull
                                                                      String index,
                                                                      @NotNull
                                                                      IGrantable identity)

(experimental) Grant write permissions for an index in this domain to an IAM principal (Role/Group/User).

Specified by:

grantIndexWrite in interface IDomain

Parameters:

index - The index to grant permissions for. This parameter is required.

identity - The principal. This parameter is required.

grantPathRead

@Stability(value=Experimental)
 @NotNull
public Grant grantPathRead(@NotNull
                                                                    String path,
                                                                    @NotNull
                                                                    IGrantable identity)

(experimental) Grant read permissions for a specific path in this domain to an IAM principal (Role/Group/User).

Specified by:

grantPathRead in interface IDomain

Parameters:

path - The path to grant permissions for. This parameter is required.

identity - The principal. This parameter is required.

grantPathReadWrite

@Stability(value=Experimental)
 @NotNull
public Grant grantPathReadWrite(@NotNull
                                                                         String path,
                                                                         @NotNull
                                                                         IGrantable identity)

(experimental) Grant read/write permissions for a specific path in this domain to an IAM principal (Role/Group/User).

Specified by:

grantPathReadWrite in interface IDomain

Parameters:

path - The path to grant permissions for. This parameter is required.

identity - The principal. This parameter is required.

grantPathWrite

@Stability(value=Experimental)
 @NotNull
public Grant grantPathWrite(@NotNull
                                                                     String path,
                                                                     @NotNull
                                                                     IGrantable identity)

(experimental) Grant write permissions for a specific path in this domain to an IAM principal (Role/Group/User).

Specified by:

grantPathWrite in interface IDomain

Parameters:

path - The path to grant permissions for. This parameter is required.

identity - The principal. This parameter is required.

grantRead

@Stability(value=Experimental)
 @NotNull
public Grant grantRead(@NotNull
                                                                IGrantable identity)

(experimental) Grant read permissions for this domain and its contents to an IAM principal (Role/Group/User).

Specified by:

grantRead in interface IDomain

Parameters:

identity - The principal. This parameter is required.

grantReadWrite

@Stability(value=Experimental)
 @NotNull
public Grant grantReadWrite(@NotNull
                                                                     IGrantable identity)

(experimental) Grant read/write permissions for this domain and its contents to an IAM principal (Role/Group/User).

Specified by:

grantReadWrite in interface IDomain

Parameters:

identity - The principal. This parameter is required.

grantWrite

@Stability(value=Experimental)
 @NotNull
public Grant grantWrite(@NotNull
                                                                 IGrantable identity)

(experimental) Grant write permissions for this domain and its contents to an IAM principal (Role/Group/User).

Specified by:

grantWrite in interface IDomain

Parameters:

identity - The principal. This parameter is required.

metric

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName,
                                                              @Nullable
                                                              MetricOptions props)

(experimental) Return the given named metric for this Domain.

Specified by:

metric in interface IDomain

Parameters:

metricName - This parameter is required.

props -

metric

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName)

(experimental) Return the given named metric for this Domain.

Specified by:

metric in interface IDomain

Parameters:

metricName - This parameter is required.

metricAutomatedSnapshotFailure

@Stability(value=Experimental)
 @NotNull
public Metric metricAutomatedSnapshotFailure(@Nullable
                                                                                      MetricOptions props)

(experimental) Metric for automated snapshot failures.

Default: maximum over 5 minutes

Specified by:

metricAutomatedSnapshotFailure in interface IDomain

Parameters:

props -

metricAutomatedSnapshotFailure

@Stability(value=Experimental)
 @NotNull
public Metric metricAutomatedSnapshotFailure()

(experimental) Metric for automated snapshot failures.

Default: maximum over 5 minutes

Specified by:

metricAutomatedSnapshotFailure in interface IDomain

metricClusterIndexWritesBlocked

@Stability(value=Experimental)
 @NotNull
public Metric metricClusterIndexWritesBlocked(@Nullable
                                                                                       MetricOptions props)

(experimental) Metric for the cluster blocking index writes.

Default: maximum over 1 minute

Specified by:

metricClusterIndexWritesBlocked in interface IDomain

Parameters:

props -

metricClusterIndexWritesBlocked

@Stability(value=Experimental)
 @NotNull
public Metric metricClusterIndexWritesBlocked()

(experimental) Metric for the cluster blocking index writes.

Default: maximum over 1 minute

Specified by:

metricClusterIndexWritesBlocked in interface IDomain

metricClusterStatusRed

@Stability(value=Experimental)
 @NotNull
public Metric metricClusterStatusRed(@Nullable
                                                                              MetricOptions props)

(experimental) Metric for the time the cluster status is red.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusRed in interface IDomain

Parameters:

props -

metricClusterStatusRed

@Stability(value=Experimental)
 @NotNull
public Metric metricClusterStatusRed()

(experimental) Metric for the time the cluster status is red.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusRed in interface IDomain

metricClusterStatusYellow

@Stability(value=Experimental)
 @NotNull
public Metric metricClusterStatusYellow(@Nullable
                                                                                 MetricOptions props)

(experimental) Metric for the time the cluster status is yellow.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusYellow in interface IDomain

Parameters:

props -

metricClusterStatusYellow

@Stability(value=Experimental)
 @NotNull
public Metric metricClusterStatusYellow()

(experimental) Metric for the time the cluster status is yellow.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusYellow in interface IDomain

metricCPUUtilization

@Stability(value=Experimental)
 @NotNull
public Metric metricCPUUtilization(@Nullable
                                                                            MetricOptions props)

(experimental) Metric for CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricCPUUtilization in interface IDomain

Parameters:

props -

metricCPUUtilization

@Stability(value=Experimental)
 @NotNull
public Metric metricCPUUtilization()

(experimental) Metric for CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricCPUUtilization in interface IDomain

metricFreeStorageSpace

@Stability(value=Experimental)
 @NotNull
public Metric metricFreeStorageSpace(@Nullable
                                                                              MetricOptions props)

(experimental) Metric for the storage space of nodes in the cluster.

Default: minimum over 5 minutes

Specified by:

metricFreeStorageSpace in interface IDomain

Parameters:

props -

metricFreeStorageSpace

@Stability(value=Experimental)
 @NotNull
public Metric metricFreeStorageSpace()

(experimental) Metric for the storage space of nodes in the cluster.

Default: minimum over 5 minutes

Specified by:

metricFreeStorageSpace in interface IDomain

metricIndexingLatency

@Stability(value=Experimental)
 @NotNull
public Metric metricIndexingLatency(@Nullable
                                                                             MetricOptions props)

(experimental) Metric for indexing latency.

Default: p99 over 5 minutes

Specified by:

metricIndexingLatency in interface IDomain

Parameters:

props -

metricIndexingLatency

@Stability(value=Experimental)
 @NotNull
public Metric metricIndexingLatency()

(experimental) Metric for indexing latency.

Default: p99 over 5 minutes

Specified by:

metricIndexingLatency in interface IDomain

metricJVMMemoryPressure

@Stability(value=Experimental)
 @NotNull
public Metric metricJVMMemoryPressure(@Nullable
                                                                               MetricOptions props)

(experimental) Metric for JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricJVMMemoryPressure in interface IDomain

Parameters:

props -

metricJVMMemoryPressure

@Stability(value=Experimental)
 @NotNull
public Metric metricJVMMemoryPressure()

(experimental) Metric for JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricJVMMemoryPressure in interface IDomain

metricKMSKeyError

@Stability(value=Experimental)
 @NotNull
public Metric metricKMSKeyError(@Nullable
                                                                         MetricOptions props)

(experimental) Metric for KMS key errors.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyError in interface IDomain

Parameters:

props -

metricKMSKeyError

@Stability(value=Experimental)
 @NotNull
public Metric metricKMSKeyError()

(experimental) Metric for KMS key errors.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyError in interface IDomain

metricKMSKeyInaccessible

@Stability(value=Experimental)
 @NotNull
public Metric metricKMSKeyInaccessible(@Nullable
                                                                                MetricOptions props)

(experimental) Metric for KMS key being inaccessible.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyInaccessible in interface IDomain

Parameters:

props -

metricKMSKeyInaccessible

@Stability(value=Experimental)
 @NotNull
public Metric metricKMSKeyInaccessible()

(experimental) Metric for KMS key being inaccessible.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyInaccessible in interface IDomain

metricMasterCPUUtilization

@Stability(value=Experimental)
 @NotNull
public Metric metricMasterCPUUtilization(@Nullable
                                                                                  MetricOptions props)

(experimental) Metric for master CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricMasterCPUUtilization in interface IDomain

Parameters:

props -

metricMasterCPUUtilization

@Stability(value=Experimental)
 @NotNull
public Metric metricMasterCPUUtilization()

(experimental) Metric for master CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricMasterCPUUtilization in interface IDomain

metricMasterJVMMemoryPressure

@Stability(value=Experimental)
 @NotNull
public Metric metricMasterJVMMemoryPressure(@Nullable
                                                                                     MetricOptions props)

(experimental) Metric for master JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricMasterJVMMemoryPressure in interface IDomain

Parameters:

props -

metricMasterJVMMemoryPressure

@Stability(value=Experimental)
 @NotNull
public Metric metricMasterJVMMemoryPressure()

(experimental) Metric for master JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricMasterJVMMemoryPressure in interface IDomain

metricNodes

@Stability(value=Experimental)
 @NotNull
public Metric metricNodes(@Nullable
                                                                   MetricOptions props)

(experimental) Metric for the number of nodes.

Default: minimum over 1 hour

Specified by:

metricNodes in interface IDomain

Parameters:

props -

metricNodes

@Stability(value=Experimental)
 @NotNull
public Metric metricNodes()

(experimental) Metric for the number of nodes.

Default: minimum over 1 hour

Specified by:

metricNodes in interface IDomain

metricSearchableDocuments

@Stability(value=Experimental)
 @NotNull
public Metric metricSearchableDocuments(@Nullable
                                                                                 MetricOptions props)

(experimental) Metric for number of searchable documents.

Default: maximum over 5 minutes

Specified by:

metricSearchableDocuments in interface IDomain

Parameters:

props -

metricSearchableDocuments

@Stability(value=Experimental)
 @NotNull
public Metric metricSearchableDocuments()

(experimental) Metric for number of searchable documents.

Default: maximum over 5 minutes

Specified by:

metricSearchableDocuments in interface IDomain

metricSearchLatency

@Stability(value=Experimental)
 @NotNull
public Metric metricSearchLatency(@Nullable
                                                                           MetricOptions props)

(experimental) Metric for search latency.

Default: p99 over 5 minutes

Specified by:

metricSearchLatency in interface IDomain

Parameters:

props -

metricSearchLatency

@Stability(value=Experimental)
 @NotNull
public Metric metricSearchLatency()

(experimental) Metric for search latency.

Default: p99 over 5 minutes

Specified by:

metricSearchLatency in interface IDomain

getConnections

@Stability(value=Experimental)
 @NotNull
public Connections getConnections()

(experimental) Manages network connections to the domain.

This will throw an error in case the domain is not placed inside a VPC.

Specified by:

getConnections in interface IConnectable

getDomainArn

@Stability(value=Experimental)
 @NotNull
public String getDomainArn()

(experimental) Arn of the Elasticsearch domain.

Specified by:

getDomainArn in interface IDomain

getDomainEndpoint

@Stability(value=Experimental)
 @NotNull
public String getDomainEndpoint()

(experimental) Endpoint of the Elasticsearch domain.

Specified by:

getDomainEndpoint in interface IDomain

getDomainName

@Stability(value=Experimental)
 @NotNull
public String getDomainName()

(experimental) Domain name of the Elasticsearch domain.

Specified by:

getDomainName in interface IDomain

getAppLogGroup

@Stability(value=Experimental)
 @Nullable
public ILogGroup getAppLogGroup()

(experimental) Log group that application logs are logged to.

getAuditLogGroup

@Stability(value=Experimental)
 @Nullable
public ILogGroup getAuditLogGroup()

(experimental) Log group that audit logs are logged to.

getMasterUserPassword

@Stability(value=Experimental)
 @Nullable
public SecretValue getMasterUserPassword()

(experimental) Master user password if fine grained access control is configured.

getSlowIndexLogGroup

@Stability(value=Experimental)
 @Nullable
public ILogGroup getSlowIndexLogGroup()

(experimental) Log group that slow indices are logged to.

getSlowSearchLogGroup

@Stability(value=Experimental)
 @Nullable
public ILogGroup getSlowSearchLogGroup()

(experimental) Log group that slow searches are logged to.