Class CfnDatabaseProps
Properties for defining a CfnDatabase
.
Implements
Inherited Members
Namespace: Amazon.CDK.AWS.Lightsail
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public class CfnDatabaseProps : ICfnDatabaseProps
Syntax (vb)
Public Class CfnDatabaseProps Implements ICfnDatabaseProps
Remarks
See: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Lightsail;
var cfnDatabaseProps = new CfnDatabaseProps {
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 = new [] { new RelationalDatabaseParameterProperty {
AllowedValues = "allowedValues",
ApplyMethod = "applyMethod",
ApplyType = "applyType",
DataType = "dataType",
Description = "description",
IsModifiable = false,
ParameterName = "parameterName",
ParameterValue = "parameterValue"
} },
RotateMasterUserPassword = false,
Tags = new [] { new CfnTag {
Key = "key",
Value = "value"
} }
};
Synopsis
Constructors
CfnDatabaseProps() | Properties for defining a |
Properties
AvailabilityZone | The Availability Zone for the database. |
BackupRetention | A Boolean value indicating whether automated backup retention is enabled for the database. |
CaCertificateIdentifier | The certificate associated with the database. |
MasterDatabaseName | The meaning of this parameter differs according to the database engine you use. |
MasterUserPassword | The password for the primary user of the database. |
MasterUsername | The name for the primary user. |
PreferredBackupWindow | The daily time range during which automated backups are created for the database (for example, |
PreferredMaintenanceWindow | The weekly time range during which system maintenance can occur for the database, formatted as follows: |
PubliclyAccessible | A Boolean value indicating whether the database is accessible to anyone on the internet. |
RelationalDatabaseBlueprintId | The blueprint ID for the database (for example, |
RelationalDatabaseBundleId | The bundle ID for the database (for example, |
RelationalDatabaseName | The name of the instance. |
RelationalDatabaseParameters | An array of parameters for the database. |
RotateMasterUserPassword | A Boolean value indicating whether to change the primary user password to a new, strong password generated by Lightsail . |
Tags | An array of key-value pairs to apply to this resource. |
Constructors
CfnDatabaseProps()
Properties for defining a CfnDatabase
.
public CfnDatabaseProps()
Remarks
See: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lightsail-database.html
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Lightsail;
var cfnDatabaseProps = new CfnDatabaseProps {
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 = new [] { new RelationalDatabaseParameterProperty {
AllowedValues = "allowedValues",
ApplyMethod = "applyMethod",
ApplyType = "applyType",
DataType = "dataType",
Description = "description",
IsModifiable = false,
ParameterName = "parameterName",
ParameterValue = "parameterValue"
} },
RotateMasterUserPassword = false,
Tags = new [] { new CfnTag {
Key = "key",
Value = "value"
} }
};
Properties
AvailabilityZone
The Availability Zone for the database.
public string? AvailabilityZone { get; set; }
Property Value
Remarks
BackupRetention
A Boolean value indicating whether automated backup retention is enabled for the database.
public object? BackupRetention { get; set; }
Property Value
Remarks
Data Import Mode is enabled when BackupRetention
is set to false
, and is disabled when BackupRetention
is set to true
.
CaCertificateIdentifier
The certificate associated with the database.
public string? CaCertificateIdentifier { get; set; }
Property Value
Remarks
MasterDatabaseName
The meaning of this parameter differs according to the database engine you use.
public string MasterDatabaseName { get; set; }
Property Value
Remarks
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:
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:
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 .
MasterUserPassword
The password for the primary user of the database.
public string? MasterUserPassword { get; set; }
Property Value
Remarks
The password can include any printable ASCII character except the following: /, ", or
: . It cannot contain spaces.
The
MasterUserPassword
andRotateMasterUserPassword
parameters cannot be used together in the same template.
MySQL
Constraints: Must contain 8-41 characters.
PostgreSQL
Constraints: Must contain 8-128 characters.
MasterUsername
The name for the primary user.
public string MasterUsername { get; set; }
Property Value
Remarks
MySQL
Constraints:
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:
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 .
PreferredBackupWindow
The daily time range during which automated backups are created for the database (for example, 16:00-16:30
).
public string? PreferredBackupWindow { get; set; }
Property Value
Remarks
PreferredMaintenanceWindow
The weekly time range during which system maintenance can occur for the database, formatted as follows: ddd:hh24:mi-ddd:hh24:mi
.
public string? PreferredMaintenanceWindow { get; set; }
Property Value
Remarks
For example, Tue:17:00-Tue:17:30
.
PubliclyAccessible
A Boolean value indicating whether the database is accessible to anyone on the internet.
public object? PubliclyAccessible { get; set; }
Property Value
Remarks
RelationalDatabaseBlueprintId
The blueprint ID for the database (for example, mysql_8_0
).
public string RelationalDatabaseBlueprintId { get; set; }
Property Value
Remarks
RelationalDatabaseBundleId
The bundle ID for the database (for example, medium_1_0
).
public string RelationalDatabaseBundleId { get; set; }
Property Value
Remarks
RelationalDatabaseName
The name of the instance.
public string RelationalDatabaseName { get; set; }
Property Value
Remarks
RelationalDatabaseParameters
An array of parameters for the database.
public object? RelationalDatabaseParameters { get; set; }
Property Value
Remarks
RotateMasterUserPassword
A Boolean value indicating whether to change the primary user password to a new, strong password generated by Lightsail .
public object? RotateMasterUserPassword { get; set; }
Property Value
Remarks
The <code>RotateMasterUserPassword</code> and <code>MasterUserPassword</code> parameters cannot be used together in the same template.
Tags
An array of key-value pairs to apply to this resource.
public ICfnTag[]? Tags { get; set; }
Property Value
ICfnTag[]
Remarks
For more information, see Tag in the AWS CloudFormation User Guide .
The <code>Value</code> of <code>Tags</code> is optional for Lightsail resources.