Package software.amazon.awscdk.services.docdb

Class DatabaseInstance

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.docdb.DatabaseInstance

All Implemented Interfaces:

IResource, IDatabaseInstance, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-29T11:15:36.469Z")
@Stability(Stable)
public class DatabaseInstance
extends Resource
implements IDatabaseInstance

A database instance.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.docdb.*;
 import software.amazon.awscdk.services.ec2.*;
 import software.amazon.awscdk.services.rds.*;
 CaCertificate caCertificate;
 DatabaseCluster databaseCluster;
 InstanceType instanceType;
 DatabaseInstance databaseInstance = DatabaseInstance.Builder.create(this, "MyDatabaseInstance")
         .cluster(databaseCluster)
         .instanceType(instanceType)
         // the properties below are optional
         .autoMinorVersionUpgrade(false)
         .availabilityZone("availabilityZone")
         .caCertificate(caCertificate)
         .dbInstanceName("dbInstanceName")
         .enablePerformanceInsights(false)
         .preferredMaintenanceWindow("preferredMaintenanceWindow")
         .removalPolicy(RemovalPolicy.DESTROY)
         .build();
 

Nested Class Summary

Nested Classes

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

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

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.docdb.IDatabaseInstance

IDatabaseInstance.Jsii$Default, IDatabaseInstance.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	Uniquely identifies this class.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
static IDatabaseInstance	fromDatabaseInstanceAttributes(software.constructs.Construct scope, String id, DatabaseInstanceAttributes attrs)	Import an existing database instance.
IDatabaseCluster	getCluster()	The instance's database cluster.
String	getDbInstanceEndpointAddress()	The instance endpoint address.
String	getDbInstanceEndpointPort()	The instance endpoint port.
String	getInstanceArn()	The instance arn.
Endpoint	getInstanceEndpoint()	The instance endpoint.
String	getInstanceIdentifier()	The instance identifier.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, 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.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Stable)
public static final String PROPERTY_INJECTION_ID

Uniquely identifies this class.

Constructor Details

DatabaseInstance

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

DatabaseInstance

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

DatabaseInstance

@Stability(Stable)
public DatabaseInstance(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 DatabaseInstanceProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

fromDatabaseInstanceAttributes

@Stability(Stable)
@NotNull
public static IDatabaseInstance fromDatabaseInstanceAttributes(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 DatabaseInstanceAttributes attrs)

Import an existing database instance.

Parameters:

scope - This parameter is required.

id - This parameter is required.

attrs - This parameter is required.

getCluster

@Stability(Stable)
@NotNull
public IDatabaseCluster getCluster()

The instance's database cluster.

getDbInstanceEndpointAddress

@Stability(Stable)
@NotNull
public String getDbInstanceEndpointAddress()

The instance endpoint address.

Specified by:

getDbInstanceEndpointAddress in interface IDatabaseInstance

getDbInstanceEndpointPort

@Stability(Stable)
@NotNull
public String getDbInstanceEndpointPort()

The instance endpoint port.

Specified by:

getDbInstanceEndpointPort in interface IDatabaseInstance

getInstanceArn

@Stability(Stable)
@NotNull
public String getInstanceArn()

The instance arn.

Specified by:

getInstanceArn in interface IDatabaseInstance

getInstanceEndpoint

@Stability(Stable)
@NotNull
public Endpoint getInstanceEndpoint()

The instance endpoint.

Specified by:

getInstanceEndpoint in interface IDatabaseInstance

getInstanceIdentifier

@Stability(Stable)
@NotNull
public String getInstanceIdentifier()

The instance identifier.

Specified by:

getInstanceIdentifier in interface IDatabaseInstance