software.amazon.awscdk.services.rds

Interface IDatabaseInstance

All Superinterfaces:

IConnectable, IConstruct, IDependable, IResource, ISecretAttachmentTarget

All Known Subinterfaces:

IDatabaseInstance.Jsii$Default

All Known Implementing Classes:

DatabaseInstance, DatabaseInstanceBase, DatabaseInstanceFromSnapshot, DatabaseInstanceReadReplica, IDatabaseInstance.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:51.268Z")
public interface IDatabaseInstance
extends IResource, IConnectable, ISecretAttachmentTarget

A database instance.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	IDatabaseInstance.Jsii$Default Internal default implementation for IDatabaseInstance.
static class	IDatabaseInstance.Jsii$Proxy A proxy class which represents a concrete javascript instance of this type.

Method Summary

Modifier and Type	Method and Description
DatabaseProxy	addProxy(java.lang.String id, DatabaseProxyOptions options) Add a new db proxy to this instance.
java.lang.String	getDbInstanceEndpointAddress() The instance endpoint address.
java.lang.String	getDbInstanceEndpointPort() The instance endpoint port.
default IInstanceEngine	getEngine() The engine of this database Instance.
java.lang.String	getInstanceArn() The instance arn.
Endpoint	getInstanceEndpoint() The instance endpoint.
java.lang.String	getInstanceIdentifier() The instance identifier.
Grant	grantConnect(IGrantable grantee) Grant the given identity connection access to the database.
Metric	metric(java.lang.String metricName) Return the given named metric for this DBInstance.
Metric	metric(java.lang.String metricName, MetricOptions props) Return the given named metric for this DBInstance.
Metric	metricCPUUtilization() The percentage of CPU utilization.
Metric	metricCPUUtilization(MetricOptions props) The percentage of CPU utilization.
Metric	metricDatabaseConnections() The number of database connections in use.
Metric	metricDatabaseConnections(MetricOptions props) The number of database connections in use.
Metric	metricFreeableMemory() The amount of available random access memory.
Metric	metricFreeableMemory(MetricOptions props) The amount of available random access memory.
Metric	metricFreeStorageSpace() The amount of available storage space.
Metric	metricFreeStorageSpace(MetricOptions props) The amount of available storage space.
Metric	metricReadIOPS() The average number of disk write I/O operations per second.
Metric	metricReadIOPS(MetricOptions props) The average number of disk write I/O operations per second.
Metric	metricWriteIOPS() The average number of disk read I/O operations per second.
Metric	metricWriteIOPS(MetricOptions props) The average number of disk read I/O operations per second.
Rule	onEvent(java.lang.String id) Defines a CloudWatch event rule which triggers for instance events.
Rule	onEvent(java.lang.String id, OnEventOptions options) Defines a CloudWatch event rule which triggers for instance events.

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

applyRemovalPolicy, getEnv, getStack

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

getNode

Methods inherited from interface software.amazon.awscdk.services.ec2.IConnectable

getConnections

Methods inherited from interface software.amazon.awscdk.services.secretsmanager.ISecretAttachmentTarget

asSecretAttachmentTarget

Method Detail

getDbInstanceEndpointAddress

java.lang.String getDbInstanceEndpointAddress()

The instance endpoint address.

getDbInstanceEndpointPort

java.lang.String getDbInstanceEndpointPort()

The instance endpoint port.

getInstanceArn

java.lang.String getInstanceArn()

The instance arn.

getInstanceEndpoint

Endpoint getInstanceEndpoint()

The instance endpoint.

getInstanceIdentifier

java.lang.String getInstanceIdentifier()

The instance identifier.

getEngine

default IInstanceEngine getEngine()

The engine of this database Instance.

May be not known for imported Instances if it wasn't provided explicitly, or for read replicas.

addProxy

DatabaseProxy addProxy(java.lang.String id,
                       DatabaseProxyOptions options)

Add a new db proxy to this instance.

Parameters:

id - This parameter is required.

options - This parameter is required.

grantConnect

Grant grantConnect(IGrantable grantee)

Grant the given identity connection access to the database.

Note: this method does not currently work, see https://github.com/aws/aws-cdk/issues/11851 for details.

Parameters:

grantee - This parameter is required.

See Also:

https://github.com/aws/aws-cdk/issues/11851

metric

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

Return the given named metric for this DBInstance.

Parameters:

metricName - This parameter is required.

props -

metric

Metric metric(java.lang.String metricName)

Return the given named metric for this DBInstance.

Parameters:

metricName - This parameter is required.

metricCPUUtilization

Metric metricCPUUtilization(MetricOptions props)

The percentage of CPU utilization.

Average over 5 minutes

Parameters:

props -

metricCPUUtilization

Metric metricCPUUtilization()

The percentage of CPU utilization.

Average over 5 minutes

metricDatabaseConnections

Metric metricDatabaseConnections(MetricOptions props)

The number of database connections in use.

Average over 5 minutes

Parameters:

props -

metricDatabaseConnections

Metric metricDatabaseConnections()

The number of database connections in use.

Average over 5 minutes

metricFreeableMemory

Metric metricFreeableMemory(MetricOptions props)

The amount of available random access memory.

Average over 5 minutes

Parameters:

props -

metricFreeableMemory

Metric metricFreeableMemory()

The amount of available random access memory.

Average over 5 minutes

metricFreeStorageSpace

Metric metricFreeStorageSpace(MetricOptions props)

The amount of available storage space.

Average over 5 minutes

Parameters:

props -

metricFreeStorageSpace

Metric metricFreeStorageSpace()

The amount of available storage space.

Average over 5 minutes

metricReadIOPS

Metric metricReadIOPS(MetricOptions props)

The average number of disk write I/O operations per second.

Average over 5 minutes

Parameters:

props -

metricReadIOPS

Metric metricReadIOPS()

The average number of disk write I/O operations per second.

Average over 5 minutes

metricWriteIOPS

Metric metricWriteIOPS(MetricOptions props)

The average number of disk read I/O operations per second.

Average over 5 minutes

Parameters:

props -

metricWriteIOPS

Metric metricWriteIOPS()

The average number of disk read I/O operations per second.

Average over 5 minutes

onEvent

Rule onEvent(java.lang.String id,
             OnEventOptions options)

Defines a CloudWatch event rule which triggers for instance events.

Use rule.addEventPattern(pattern) to specify a filter.

Parameters:

id - This parameter is required.

options -

onEvent

Rule onEvent(java.lang.String id)

Defines a CloudWatch event rule which triggers for instance events.

Use rule.addEventPattern(pattern) to specify a filter.

Parameters:

id - This parameter is required.