software.amazon.awscdk.services.opensearchservice

Class Domain

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.opensearchservice.Domain

All Implemented Interfaces:

IConstruct, IDependable, IResource, IConnectable, IDomain

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-09T19:16:41.737Z")
public class Domain
extends Resource
implements IDomain, IConnectable

Provides an Amazon OpenSearch Service domain.

Example:

 Domain domain = Domain.Builder.create(this, "Domain")
         .version(EngineVersion.OPENSEARCH_1_0)
         .ebs(EbsOptions.builder()
                 .volumeSize(100)
                 .volumeType(EbsDeviceVolumeType.GENERAL_PURPOSE_SSD)
                 .build())
         .nodeToNodeEncryption(true)
         .encryptionAtRest(EncryptionAtRestOptions.builder()
                 .enabled(true)
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

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

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.opensearchservice.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
protected	Domain(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Domain(software.amazon.jsii.JsiiObjectRef objRef)
	Domain(software.constructs.Construct scope, java.lang.String id, DomainProps props)

Method Summary

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

Methods inherited from class software.amazon.awscdk.core.Resource

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

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

Domain

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

Domain

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

Domain

public Domain(software.constructs.Construct scope,
              java.lang.String id,
              DomainProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromDomainAttributes

public static IDomain fromDomainAttributes(software.constructs.Construct scope,
                                           java.lang.String id,
                                           DomainAttributes attrs)

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

public static IDomain fromDomainEndpoint(software.constructs.Construct scope,
                                         java.lang.String id,
                                         java.lang.String domainEndpoint)

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.

addAccessPolicies

public void addAccessPolicies(PolicyStatement... accessPolicyStatements)

Add policy statements to the domain access policy.

Parameters:

accessPolicyStatements - This parameter is required.

grantIndexRead

public Grant grantIndexRead(java.lang.String index,
                            IGrantable identity)

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

public Grant grantIndexReadWrite(java.lang.String index,
                                 IGrantable identity)

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

public Grant grantIndexWrite(java.lang.String index,
                             IGrantable identity)

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

public Grant grantPathRead(java.lang.String path,
                           IGrantable identity)

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

public Grant grantPathReadWrite(java.lang.String path,
                                IGrantable identity)

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

public Grant grantPathWrite(java.lang.String path,
                            IGrantable identity)

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

public Grant grantRead(IGrantable identity)

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

public Grant grantReadWrite(IGrantable identity)

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

public Grant grantWrite(IGrantable identity)

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

public Metric metric(java.lang.String metricName,
                     MetricOptions props)

Return the given named metric for this domain.

Specified by:

metric in interface IDomain

Parameters:

metricName - This parameter is required.

props -

metric

public Metric metric(java.lang.String metricName)

Return the given named metric for this domain.

Specified by:

metric in interface IDomain

Parameters:

metricName - This parameter is required.

metricAutomatedSnapshotFailure

public Metric metricAutomatedSnapshotFailure(MetricOptions props)

Metric for automated snapshot failures.

Default: maximum over 5 minutes

Specified by:

metricAutomatedSnapshotFailure in interface IDomain

Parameters:

props -

metricAutomatedSnapshotFailure

public Metric metricAutomatedSnapshotFailure()

Metric for automated snapshot failures.

Default: maximum over 5 minutes

Specified by:

metricAutomatedSnapshotFailure in interface IDomain

metricClusterIndexWritesBlocked

public Metric metricClusterIndexWritesBlocked(MetricOptions props)

Metric for the cluster blocking index writes.

Default: maximum over 1 minute

Specified by:

metricClusterIndexWritesBlocked in interface IDomain

Parameters:

props -

metricClusterIndexWritesBlocked

public Metric metricClusterIndexWritesBlocked()

Metric for the cluster blocking index writes.

Default: maximum over 1 minute

Specified by:

metricClusterIndexWritesBlocked in interface IDomain

metricClusterStatusRed

public Metric metricClusterStatusRed(MetricOptions props)

Metric for the time the cluster status is red.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusRed in interface IDomain

Parameters:

props -

metricClusterStatusRed

public Metric metricClusterStatusRed()

Metric for the time the cluster status is red.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusRed in interface IDomain

metricClusterStatusYellow

public Metric metricClusterStatusYellow(MetricOptions props)

Metric for the time the cluster status is yellow.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusYellow in interface IDomain

Parameters:

props -

metricClusterStatusYellow

public Metric metricClusterStatusYellow()

Metric for the time the cluster status is yellow.

Default: maximum over 5 minutes

Specified by:

metricClusterStatusYellow in interface IDomain

metricCPUUtilization

public Metric metricCPUUtilization(MetricOptions props)

Metric for CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricCPUUtilization in interface IDomain

Parameters:

props -

metricCPUUtilization

public Metric metricCPUUtilization()

Metric for CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricCPUUtilization in interface IDomain

metricFreeStorageSpace

public Metric metricFreeStorageSpace(MetricOptions props)

Metric for the storage space of nodes in the cluster.

Default: minimum over 5 minutes

Specified by:

metricFreeStorageSpace in interface IDomain

Parameters:

props -

metricFreeStorageSpace

public Metric metricFreeStorageSpace()

Metric for the storage space of nodes in the cluster.

Default: minimum over 5 minutes

Specified by:

metricFreeStorageSpace in interface IDomain

metricIndexingLatency

public Metric metricIndexingLatency(MetricOptions props)

Metric for indexing latency.

Default: p99 over 5 minutes

Specified by:

metricIndexingLatency in interface IDomain

Parameters:

props -

metricIndexingLatency

public Metric metricIndexingLatency()

Metric for indexing latency.

Default: p99 over 5 minutes

Specified by:

metricIndexingLatency in interface IDomain

metricJVMMemoryPressure

public Metric metricJVMMemoryPressure(MetricOptions props)

Metric for JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricJVMMemoryPressure in interface IDomain

Parameters:

props -

metricJVMMemoryPressure

public Metric metricJVMMemoryPressure()

Metric for JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricJVMMemoryPressure in interface IDomain

metricKMSKeyError

public Metric metricKMSKeyError(MetricOptions props)

Metric for KMS key errors.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyError in interface IDomain

Parameters:

props -

metricKMSKeyError

public Metric metricKMSKeyError()

Metric for KMS key errors.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyError in interface IDomain

metricKMSKeyInaccessible

public Metric metricKMSKeyInaccessible(MetricOptions props)

Metric for KMS key being inaccessible.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyInaccessible in interface IDomain

Parameters:

props -

metricKMSKeyInaccessible

public Metric metricKMSKeyInaccessible()

Metric for KMS key being inaccessible.

Default: maximum over 5 minutes

Specified by:

metricKMSKeyInaccessible in interface IDomain

metricMasterCPUUtilization

public Metric metricMasterCPUUtilization(MetricOptions props)

Metric for master CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricMasterCPUUtilization in interface IDomain

Parameters:

props -

metricMasterCPUUtilization

public Metric metricMasterCPUUtilization()

Metric for master CPU utilization.

Default: maximum over 5 minutes

Specified by:

metricMasterCPUUtilization in interface IDomain

metricMasterJVMMemoryPressure

public Metric metricMasterJVMMemoryPressure(MetricOptions props)

Metric for master JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricMasterJVMMemoryPressure in interface IDomain

Parameters:

props -

metricMasterJVMMemoryPressure

public Metric metricMasterJVMMemoryPressure()

Metric for master JVM memory pressure.

Default: maximum over 5 minutes

Specified by:

metricMasterJVMMemoryPressure in interface IDomain

metricNodes

public Metric metricNodes(MetricOptions props)

Metric for the number of nodes.

Default: minimum over 1 hour

Specified by:

metricNodes in interface IDomain

Parameters:

props -

metricNodes

public Metric metricNodes()

Metric for the number of nodes.

Default: minimum over 1 hour

Specified by:

metricNodes in interface IDomain

metricSearchableDocuments

public Metric metricSearchableDocuments(MetricOptions props)

Metric for number of searchable documents.

Default: maximum over 5 minutes

Specified by:

metricSearchableDocuments in interface IDomain

Parameters:

props -

metricSearchableDocuments

public Metric metricSearchableDocuments()

Metric for number of searchable documents.

Default: maximum over 5 minutes

Specified by:

metricSearchableDocuments in interface IDomain

metricSearchLatency

public Metric metricSearchLatency(MetricOptions props)

Metric for search latency.

Default: p99 over 5 minutes

Specified by:

metricSearchLatency in interface IDomain

Parameters:

props -

metricSearchLatency

public Metric metricSearchLatency()

Metric for search latency.

Default: p99 over 5 minutes

Specified by:

metricSearchLatency in interface IDomain

getConnections

public Connections getConnections()

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

public java.lang.String getDomainArn()

Arn of the Amazon OpenSearch Service domain.

Specified by:

getDomainArn in interface IDomain

getDomainEndpoint

public java.lang.String getDomainEndpoint()

Endpoint of the Amazon OpenSearch Service domain.

Specified by:

getDomainEndpoint in interface IDomain

getDomainId

public java.lang.String getDomainId()

Identifier of the Amazon OpenSearch Service domain.

Specified by:

getDomainId in interface IDomain

getDomainName

public java.lang.String getDomainName()

Domain name of the Amazon OpenSearch Service domain.

Specified by:

getDomainName in interface IDomain

getAppLogGroup

public ILogGroup getAppLogGroup()

Log group that application logs are logged to.

getAuditLogGroup

public ILogGroup getAuditLogGroup()

Log group that audit logs are logged to.

getMasterUserPassword

public SecretValue getMasterUserPassword()

Master user password if fine grained access control is configured.

getSlowIndexLogGroup

public ILogGroup getSlowIndexLogGroup()

Log group that slow indices are logged to.

getSlowSearchLogGroup

public ILogGroup getSlowSearchLogGroup()

Log group that slow searches are logged to.