software.amazon.awscdk.services.rds

Class OptionGroup

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.rds.OptionGroup

All Implemented Interfaces:

IConstruct, IDependable, IResource, IOptionGroup

@Generated(value="jsii-pacmak/1.73.0 (build 6faeda3)",
           date="2023-01-25T18:29:12.357Z")
public class OptionGroup
extends Resource
implements IOptionGroup

An option group.

Example:

 // Set open cursors with parameter group
 ParameterGroup parameterGroup = ParameterGroup.Builder.create(this, "ParameterGroup")
         .engine(DatabaseInstanceEngine.oracleSe2(OracleSe2InstanceEngineProps.builder().version(OracleEngineVersion.VER_19_0_0_0_2020_04_R1).build()))
         .parameters(Map.of(
                 "open_cursors", "2500"))
         .build();
 OptionGroup optionGroup = OptionGroup.Builder.create(this, "OptionGroup")
         .engine(DatabaseInstanceEngine.oracleSe2(OracleSe2InstanceEngineProps.builder().version(OracleEngineVersion.VER_19_0_0_0_2020_04_R1).build()))
         .configurations(List.of(OptionConfiguration.builder()
                 .name("LOCATOR")
                 .build(), OptionConfiguration.builder()
                 .name("OEM")
                 .port(1158)
                 .vpc(vpc)
                 .build()))
         .build();
 // Allow connections to OEM
 optionGroup.optionConnections.OEM.connections.allowDefaultPortFromAnyIpv4();
 // Database instance with production values
 DatabaseInstance instance = DatabaseInstance.Builder.create(this, "Instance")
         .engine(DatabaseInstanceEngine.oracleSe2(OracleSe2InstanceEngineProps.builder().version(OracleEngineVersion.VER_19_0_0_0_2020_04_R1).build()))
         .licenseModel(LicenseModel.BRING_YOUR_OWN_LICENSE)
         .instanceType(InstanceType.of(InstanceClass.BURSTABLE3, InstanceSize.MEDIUM))
         .multiAz(true)
         .storageType(StorageType.IO1)
         .credentials(Credentials.fromUsername("syscdk"))
         .vpc(vpc)
         .databaseName("ORCL")
         .storageEncrypted(true)
         .backupRetention(Duration.days(7))
         .monitoringInterval(Duration.seconds(60))
         .enablePerformanceInsights(true)
         .cloudwatchLogsExports(List.of("trace", "audit", "alert", "listener"))
         .cloudwatchLogsRetention(RetentionDays.ONE_MONTH)
         .autoMinorVersionUpgrade(true) // required to be true if LOCATOR is used in the option group
         .optionGroup(optionGroup)
         .parameterGroup(parameterGroup)
         .removalPolicy(RemovalPolicy.DESTROY)
         .build();
 // Allow connections on default port from any IPV4
 instance.connections.allowDefaultPortFromAnyIpv4();
 // Rotate the master user password every 30 days
 instance.addRotationSingleUser();
 // Add alarm for high CPU
 // Add alarm for high CPU
 Alarm.Builder.create(this, "HighCPU")
         .metric(instance.metricCPUUtilization())
         .threshold(90)
         .evaluationPeriods(1)
         .build();
 // Trigger Lambda function on instance availability events
 Function fn = Function.Builder.create(this, "Function")
         .code(Code.fromInline("exports.handler = (event) => console.log(event);"))
         .handler("index.handler")
         .runtime(Runtime.NODEJS_14_X)
         .build();
 Rule availabilityRule = instance.onEvent("Availability", OnEventOptions.builder().target(new LambdaFunction(fn)).build());
 availabilityRule.addEventPattern(EventPattern.builder()
         .detail(Map.of(
                 "EventCategories", List.of("availability")))
         .build());
 

Nested Class Summary

Nested Classes

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

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.rds.IOptionGroup

IOptionGroup.Jsii$Default, IOptionGroup.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OptionGroup(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	OptionGroup(software.amazon.jsii.JsiiObjectRef objRef)
	OptionGroup(software.constructs.Construct scope, java.lang.String id, OptionGroupProps props)

Method Summary

Modifier and Type	Method and Description
java.lang.Boolean	addConfiguration(OptionConfiguration configuration) Adds a configuration to this OptionGroup.
static IOptionGroup	fromOptionGroupName(software.constructs.Construct scope, java.lang.String id, java.lang.String optionGroupName) Import an existing option group.
java.util.Map<java.lang.String,Connections>	getOptionConnections() The connections object for the options.
java.lang.String	getOptionGroupName() The name of the option group.

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

OptionGroup

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

OptionGroup

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

OptionGroup

public OptionGroup(software.constructs.Construct scope,
                   java.lang.String id,
                   OptionGroupProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromOptionGroupName

public static IOptionGroup fromOptionGroupName(software.constructs.Construct scope,
                                               java.lang.String id,
                                               java.lang.String optionGroupName)

Import an existing option group.

Parameters:

scope - This parameter is required.

id - This parameter is required.

optionGroupName - This parameter is required.

addConfiguration

public java.lang.Boolean addConfiguration(OptionConfiguration configuration)

Adds a configuration to this OptionGroup.

This method is a no-op for an imported OptionGroup.

Specified by:

addConfiguration in interface IOptionGroup

Parameters:

configuration - This parameter is required.

Returns:

true if the OptionConfiguration was successfully added.

getOptionConnections

public java.util.Map<java.lang.String,Connections> getOptionConnections()

The connections object for the options.

getOptionGroupName

public java.lang.String getOptionGroupName()

The name of the option group.

Specified by:

getOptionGroupName in interface IOptionGroup