Package software.amazon.awscdk.services.lightsail

Interface CfnDatabaseProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnDatabaseProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.113.0 (build fc68b25)",
           date="2025-10-14T12:28:15.080Z")
@Stability(Stable)
public interface CfnDatabaseProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnDatabase.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.lightsail.*;
 CfnDatabaseProps cfnDatabaseProps = CfnDatabaseProps.builder()
         .masterDatabaseName("masterDatabaseName")
         .masterUsername("masterUsername")
         .relationalDatabaseBlueprintId("relationalDatabaseBlueprintId")
         .relationalDatabaseBundleId("relationalDatabaseBundleId")
         .relationalDatabaseName("relationalDatabaseName")
         // the properties below are optional
         .availabilityZone("availabilityZone")
         .backupRetention(false)
         .caCertificateIdentifier("caCertificateIdentifier")
         .masterUserPassword("masterUserPassword")
         .preferredBackupWindow("preferredBackupWindow")
         .preferredMaintenanceWindow("preferredMaintenanceWindow")
         .publiclyAccessible(false)
         .relationalDatabaseParameters(List.of(RelationalDatabaseParameterProperty.builder()
                 .allowedValues("allowedValues")
                 .applyMethod("applyMethod")
                 .applyType("applyType")
                 .dataType("dataType")
                 .description("description")
                 .isModifiable(false)
                 .parameterName("parameterName")
                 .parameterValue("parameterValue")
                 .build()))
         .rotateMasterUserPassword(false)
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnDatabaseProps.Builder	A builder for CfnDatabaseProps
static final class	CfnDatabaseProps.Jsii$Proxy	An implementation for CfnDatabaseProps

Method Summary

Modifier and Type	Method	Description
static CfnDatabaseProps.Builder	builder()
default String	getAvailabilityZone()	The Availability Zone for the database.
default Object	getBackupRetention()	A Boolean value indicating whether automated backup retention is enabled for the database.
default String	getCaCertificateIdentifier()	The certificate associated with the database.
String	getMasterDatabaseName()	The meaning of this parameter differs according to the database engine you use.
String	getMasterUsername()	The name for the primary user.
default String	getMasterUserPassword()	The password for the primary user of the database.
default String	getPreferredBackupWindow()	The daily time range during which automated backups are created for the database (for example, 16:00-16:30 ).
default String	getPreferredMaintenanceWindow()	The weekly time range during which system maintenance can occur for the database, formatted as follows: ddd:hh24:mi-ddd:hh24:mi .
default Object	getPubliclyAccessible()	A Boolean value indicating whether the database is accessible to anyone on the internet.
String	getRelationalDatabaseBlueprintId()	The blueprint ID for the database (for example, mysql_8_0 ).
String	getRelationalDatabaseBundleId()	The bundle ID for the database (for example, medium_1_0 ).
String	getRelationalDatabaseName()	The name of the instance.
default Object	getRelationalDatabaseParameters()	An array of parameters for the database.
default Object	getRotateMasterUserPassword()	A Boolean value indicating whether to change the primary user password to a new, strong password generated by Lightsail .
default List<CfnTag>	getTags()	An array of key-value pairs to apply to this resource.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getMasterDatabaseName

@Stability(Stable)
@NotNull
String getMasterDatabaseName()

The meaning of this parameter differs according to the database engine you use.

MySQL

The name of the database to create when the Lightsail database resource is created. If this parameter isn't specified, no database is created in the database resource.

Constraints:

• Must contain 1-64 letters or numbers.
• Must begin with a letter. Subsequent characters can be letters, underscores, or numbers (0-9).
• Can't be a word reserved by the specified database engine.

For more information about reserved words in MySQL, see the Keywords and Reserved Words articles for MySQL 5.6 , MySQL 5.7 , and MySQL 8.0 .

PostgreSQL

The name of the database to create when the Lightsail database resource is created. If this parameter isn't specified, a database named postgres is created in the database resource.

Constraints:

• Must contain 1-63 letters or numbers.
• Must begin with a letter. Subsequent characters can be letters, underscores, or numbers (0-9).
• Can't be a word reserved by the specified database engine.

For more information about reserved words in PostgreSQL, see the SQL Key Words articles for PostgreSQL 9.6 , PostgreSQL 10 , PostgreSQL 11 , and PostgreSQL 12 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-masterdatabasename

getMasterUsername

@Stability(Stable)
@NotNull
String getMasterUsername()

The name for the primary user.

MySQL

Constraints:

• Required for MySQL.
• Must be 1-16 letters or numbers. Can contain underscores.
• First character must be a letter.
• Can't be a reserved word for the chosen database engine.

For more information about reserved words in MySQL 5.6 or 5.7, see the Keywords and Reserved Words articles for MySQL 5.6 , MySQL 5.7 , or MySQL 8.0 .

PostgreSQL

Constraints:

• Required for PostgreSQL.
• Must be 1-63 letters or numbers. Can contain underscores.
• First character must be a letter.
• Can't be a reserved word for the chosen database engine.

For more information about reserved words in MySQL 5.6 or 5.7, see the Keywords and Reserved Words articles for PostgreSQL 9.6 , PostgreSQL 10 , PostgreSQL 11 , and PostgreSQL 12 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-masterusername

getRelationalDatabaseBlueprintId

@Stability(Stable)
@NotNull
String getRelationalDatabaseBlueprintId()

The blueprint ID for the database (for example, mysql_8_0 ).

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-relationaldatabaseblueprintid

getRelationalDatabaseBundleId

@Stability(Stable)
@NotNull
String getRelationalDatabaseBundleId()

The bundle ID for the database (for example, medium_1_0 ).

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-relationaldatabasebundleid

getRelationalDatabaseName

@Stability(Stable)
@NotNull
String getRelationalDatabaseName()

The name of the instance.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-relationaldatabasename

getAvailabilityZone

@Stability(Stable)
@Nullable
default String getAvailabilityZone()

The Availability Zone for the database.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-availabilityzone

getBackupRetention

@Stability(Stable)
@Nullable
default Object getBackupRetention()

A Boolean value indicating whether automated backup retention is enabled for the database.

Data Import Mode is enabled when BackupRetention is set to false , and is disabled when BackupRetention is set to true .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-backupretention

getCaCertificateIdentifier

@Stability(Stable)
@Nullable
default String getCaCertificateIdentifier()

The certificate associated with the database.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-cacertificateidentifier

getMasterUserPassword

@Stability(Stable)
@Nullable
default String getMasterUserPassword()

The password for the primary user of the database.

The password can include any printable ASCII character except the following: /, ", or

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-masteruserpassword

getPreferredBackupWindow

@Stability(Stable)
@Nullable
default String getPreferredBackupWindow()

The daily time range during which automated backups are created for the database (for example, 16:00-16:30 ).

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-preferredbackupwindow

getPreferredMaintenanceWindow

@Stability(Stable)
@Nullable
default String getPreferredMaintenanceWindow()

The weekly time range during which system maintenance can occur for the database, formatted as follows: ddd:hh24:mi-ddd:hh24:mi .

For example, Tue:17:00-Tue:17:30 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-preferredmaintenancewindow

getPubliclyAccessible

@Stability(Stable)
@Nullable
default Object getPubliclyAccessible()

A Boolean value indicating whether the database is accessible to anyone on the internet.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-publiclyaccessible

getRelationalDatabaseParameters

@Stability(Stable)
@Nullable
default Object getRelationalDatabaseParameters()

An array of parameters for the database.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-relationaldatabaseparameters

getRotateMasterUserPassword

@Stability(Stable)
@Nullable
default Object getRotateMasterUserPassword()

A Boolean value indicating whether to change the primary user password to a new, strong password generated by Lightsail .

The RotateMasterUserPassword and MasterUserPassword parameters cannot be used together in the same template.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-rotatemasteruserpassword

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

An array of key-value pairs to apply to this resource.

For more information, see Tag in the AWS CloudFormation User Guide .

The Value of Tags is optional for Lightsail resources.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html#cfn-lightsail-database-tags

builder

@Stability(Stable)
static CfnDatabaseProps.Builder builder()

Returns:

a CfnDatabaseProps.Builder of CfnDatabaseProps