Fork me on GitHub

Module rds

@pulumi/aws > rds

Index

rds/cluster.ts rds/clusterInstance.ts rds/clusterParameterGroup.ts rds/clusterSnapshot.ts rds/eventSubscription.ts rds/getCluster.ts rds/getClusterSnapshot.ts rds/getEventCategories.ts rds/getInstance.ts rds/getSnapshot.ts rds/instance.ts rds/optionGroup.ts rds/parameterGroup.ts rds/securityGroup.ts rds/snapshot.ts rds/subnetGroup.ts

class Cluster

Manages a [RDS Aurora Cluster][2]. To manage cluster instances that inherit configuration from the cluster (when not running the cluster in serverless engine mode), see the aws_rds_cluster_instance resource. To manage non-Aurora databases (e.g. MySQL, PostgreSQL, SQL Server, etc.), see the aws_db_instance resource.

For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

Changes to a RDS Cluster can occur when you manually change a parameter, such as port, and are reflected in the next maintenance window. Because of this, Terraform may report a difference in its planning phase because a modification has not yet taken place. You can use the apply_immediately flag to instruct the service to apply the change immediately (see documentation below).

~> Note: using apply_immediately can result in a brief downtime as the server reboots. See the AWS Docs on [RDS Maintenance][4] for more information.

~> Note: All arguments including the username and password will be stored in the raw state as plain-text. Read more about sensitive data in state.

constructor

new Cluster(name: string, args?: ClusterArgs, opts?: pulumi.CustomResourceOptions)

Create a Cluster resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ClusterState): Cluster

Get an existing Cluster resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property applyImmediately

public applyImmediately: pulumi.Output<boolean>;

Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is false. See Amazon RDS Documentation for more information.

property arn

public arn: pulumi.Output<string>;

Amazon Resource Name (ARN) of cluster

property availabilityZones

public availabilityZones: pulumi.Output<string[]>;

A list of EC2 Availability Zones that instances in the DB cluster can be created in

property backtrackWindow

public backtrackWindow: pulumi.Output<number | undefined>;

The target backtrack window, in seconds. Only available for aurora engine currently. To disable backtracking, set this value to 0. Defaults to 0. Must be between 0 and 259200 (72 hours)

property backupRetentionPeriod

public backupRetentionPeriod: pulumi.Output<number | undefined>;

The days to retain backups for. Default 1

property clusterIdentifier

public clusterIdentifier: pulumi.Output<string>;

The cluster identifier. If omitted, Terraform will assign a random, unique identifier.

property clusterIdentifierPrefix

public clusterIdentifierPrefix: pulumi.Output<string>;

Creates a unique cluster identifier beginning with the specified prefix. Conflicts with cluster_identifer.

property clusterMembers

public clusterMembers: pulumi.Output<string[]>;

List of RDS Instances that are a part of this cluster

property clusterResourceId

public clusterResourceId: pulumi.Output<string>;

The RDS Cluster Resource ID

property databaseName

public databaseName: pulumi.Output<string>;

Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: [RDS Naming Constraints][5]

property dbClusterParameterGroupName

public dbClusterParameterGroupName: pulumi.Output<string>;

A cluster parameter group to associate with the cluster.

property dbSubnetGroupName

public dbSubnetGroupName: pulumi.Output<string>;

A DB subnet group to associate with this DB instance. NOTE: This must match the db_subnet_group_name specified on every aws_rds_cluster_instance in the cluster.

property enabledCloudwatchLogsExports

public enabledCloudwatchLogsExports: pulumi.Output<string[] | undefined>;

List of log types to export to cloudwatch. If omitted, no logs will be exported. The following log types are supported: audit, error, general, slowquery.

property endpoint

public endpoint: pulumi.Output<string>;

The DNS address of the RDS instance

property engine

public engine: pulumi.Output<string | undefined>;

The name of the database engine to be used for this DB cluster. Defaults to aurora. Valid Values: aurora, aurora-mysql, aurora-postgresql

property engineMode

public engineMode: pulumi.Output<string | undefined>;

The database engine mode. Valid values: parallelquery, provisioned, serverless. Defaults to: provisioned. See the RDS User Guide for limitations when using serverless.

property engineVersion

public engineVersion: pulumi.Output<string>;

The database engine version.

property finalSnapshotIdentifier

public finalSnapshotIdentifier: pulumi.Output<string | undefined>;

The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.

property hostedZoneId

public hostedZoneId: pulumi.Output<string>;

The Route53 Hosted Zone ID of the endpoint

property iamDatabaseAuthenticationEnabled

public iamDatabaseAuthenticationEnabled: pulumi.Output<boolean | undefined>;

Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see [AWS Documentation][6] for availability and limitations.

property iamRoles

public iamRoles: pulumi.Output<string[] | undefined>;

A List of ARNs for the IAM roles to associate to the RDS Cluster.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property kmsKeyId

public kmsKeyId: pulumi.Output<string>;

The ARN for the KMS encryption key. When specifying kms_key_id, storage_encrypted needs to be set to true.

property masterPassword

public masterPassword: pulumi.Output<string | undefined>;

Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file. Please refer to the [RDS Naming Constraints][5]

property masterUsername

public masterUsername: pulumi.Output<string>;

Username for the master DB user. Please refer to the [RDS Naming Constraints][5]

property port

public port: pulumi.Output<number>;

The port on which the DB accepts connections

property preferredBackupWindow

public preferredBackupWindow: pulumi.Output<string>;

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.Time in UTC Default: A 30-minute window selected at random from an 8-hour block of time per region. e.g. 04:00-09:00

property preferredMaintenanceWindow

public preferredMaintenanceWindow: pulumi.Output<string>;

The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30

property readerEndpoint

public readerEndpoint: pulumi.Output<string>;

A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas

property replicationSourceIdentifier

public replicationSourceIdentifier: pulumi.Output<string | undefined>;

ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.

property s3Import

public s3Import: pulumi.Output<{ ... } | undefined>;

property scalingConfiguration

public scalingConfiguration: pulumi.Output<{ ... } | undefined>;

Nested attribute with scaling properties. Only valid when engine_mode is set to serverless. More details below.

property skipFinalSnapshot

public skipFinalSnapshot: pulumi.Output<boolean | undefined>;

Determines whether a final DB snapshot is created before the DB cluster is deleted. If true is specified, no DB snapshot is created. If false is specified, a DB snapshot is created before the DB cluster is deleted, using the value from final_snapshot_identifier. Default is false.

property snapshotIdentifier

public snapshotIdentifier: pulumi.Output<string | undefined>;

Specifies whether or not to create this cluster from a snapshot. You can use either the name or ARN when specifying a DB cluster snapshot, or the ARN when specifying a DB snapshot.

property sourceRegion

public sourceRegion: pulumi.Output<string | undefined>;

The source region for an encrypted replica DB cluster.

property storageEncrypted

public storageEncrypted: pulumi.Output<boolean | undefined>;

Specifies whether the DB cluster is encrypted. The default is false for provisioned engine_mode and true for serverless engine_mode.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the DB cluster.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property vpcSecurityGroupIds

public vpcSecurityGroupIds: pulumi.Output<string[]>;

List of VPC security groups to associate with the Cluster

class ClusterInstance

Provides an RDS Cluster Resource Instance. A Cluster Instance Resource defines attributes that are specific to a single instance in a [RDS Cluster][3], specifically running Amazon Aurora.

Unlike other RDS resources that support replication, with Amazon Aurora you do not designate a primary and subsequent replicas. Instead, you simply add RDS Instances and Aurora manages the replication. You can use the [count][5] meta-parameter to make multiple instances and join them all to the same RDS Cluster, or you may specify different Cluster Instance resources with various instance_class sizes.

For more information on Amazon Aurora, see [Aurora on Amazon RDS][2] in the Amazon RDS User Guide.

constructor

new ClusterInstance(name: string, args: ClusterInstanceArgs, opts?: pulumi.CustomResourceOptions)

Create a ClusterInstance resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ClusterInstanceState): ClusterInstance

Get an existing ClusterInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property applyImmediately

public applyImmediately: pulumi.Output<boolean>;

Specifies whether any database modifications are applied immediately, or during the next maintenance window. Default isfalse.

property arn

public arn: pulumi.Output<string>;

Amazon Resource Name (ARN) of cluster instance

property autoMinorVersionUpgrade

public autoMinorVersionUpgrade: pulumi.Output<boolean | undefined>;

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window. Default true.

property availabilityZone

public availabilityZone: pulumi.Output<string>;

The EC2 Availability Zone that the DB instance is created in. See docs about the details.

property clusterIdentifier

public clusterIdentifier: pulumi.Output<string>;

The identifier of the aws_rds_cluster in which to launch this instance.

property dbParameterGroupName

public dbParameterGroupName: pulumi.Output<string>;

The name of the DB parameter group to associate with this instance.

property dbSubnetGroupName

public dbSubnetGroupName: pulumi.Output<string>;

A DB subnet group to associate with this DB instance. NOTE: This must match the db_subnet_group_name of the attached aws_rds_cluster.

property dbiResourceId

public dbiResourceId: pulumi.Output<string>;

The region-unique, immutable identifier for the DB instance.

property endpoint

public endpoint: pulumi.Output<string>;

The DNS address for this instance. May not be writable

property engine

public engine: pulumi.Output<string | undefined>;

The name of the database engine to be used for the RDS instance. Defaults to aurora. Valid Values: aurora, aurora-mysql, aurora-postgresql. For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

property engineVersion

public engineVersion: pulumi.Output<string>;

The database engine version.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property identifier

public identifier: pulumi.Output<string>;

The indentifier for the RDS instance, if omitted, Terraform will assign a random, unique identifier.

property identifierPrefix

public identifierPrefix: pulumi.Output<string>;

Creates a unique identifier beginning with the specified prefix. Conflicts with identifer.

property instanceClass

public instanceClass: pulumi.Output<string>;

The instance class to use. For details on CPU and memory, see [Scaling Aurora DB Instances][4]. Aurora currently supports the below instance classes. Please see [AWS Documentation][7] for complete details.

  • db.t2.small
  • db.t2.medium
  • db.r3.large
  • db.r3.xlarge
  • db.r3.2xlarge
  • db.r3.4xlarge
  • db.r3.8xlarge
  • db.r4.large
  • db.r4.xlarge
  • db.r4.2xlarge
  • db.r4.4xlarge
  • db.r4.8xlarge
  • db.r4.16xlarge

property kmsKeyId

public kmsKeyId: pulumi.Output<string>;

The ARN for the KMS encryption key if one is set to the cluster.

property monitoringInterval

public monitoringInterval: pulumi.Output<number | undefined>;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0. Valid Values: 0, 1, 5, 10, 15, 30, 60.

property monitoringRoleArn

public monitoringRoleArn: pulumi.Output<string>;

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. You can find more information on the AWS Documentation what IAM permissions are needed to allow Enhanced Monitoring for RDS Instances.

property performanceInsightsEnabled

public performanceInsightsEnabled: pulumi.Output<boolean>;

Specifies whether Performance Insights is enabled or not.

property performanceInsightsKmsKeyId

public performanceInsightsKmsKeyId: pulumi.Output<string>;

The ARN for the KMS key to encrypt Performance Insights data. When specifying performance_insights_kms_key_id, performance_insights_enabled needs to be set to true.

property port

public port: pulumi.Output<number>;

The database port

property preferredBackupWindow

public preferredBackupWindow: pulumi.Output<string>;

The daily time range during which automated backups are created if automated backups are enabled. Eg: “04:00-09:00”

property preferredMaintenanceWindow

public preferredMaintenanceWindow: pulumi.Output<string>;

The window to perform maintenance in. Syntax: “ddd:hh24:mi-ddd:hh24:mi”. Eg: “Mon:00:00-Mon:03:00”.

property promotionTier

public promotionTier: pulumi.Output<number | undefined>;

Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

property publiclyAccessible

public publiclyAccessible: pulumi.Output<boolean | undefined>;

Bool to control if instance is publicly accessible. Default false. See the documentation on [Creating DB Instances][6] for more details on controlling this property.

property storageEncrypted

public storageEncrypted: pulumi.Output<boolean>;

Specifies whether the DB cluster is encrypted.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the instance.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property writer

public writer: pulumi.Output<boolean>;

Boolean indicating if this instance is writable. False indicates this instance is a read replica.

class ClusterParameterGroup

Provides an RDS DB cluster parameter group resource. Documentation of the available parameters for various Aurora engines can be found at:

constructor

new ClusterParameterGroup(name: string, args: ClusterParameterGroupArgs, opts?: pulumi.CustomResourceOptions)

Create a ClusterParameterGroup resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ClusterParameterGroupState): ClusterParameterGroup

Get an existing ClusterParameterGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The ARN of the db cluster parameter group.

property description

public description: pulumi.Output<string>;

The description of the DB cluster parameter group. Defaults to “Managed by Terraform”.

property family

public family: pulumi.Output<string>;

The family of the DB cluster parameter group.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the DB parameter.

property namePrefix

public namePrefix: pulumi.Output<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property parameters

public parameters: pulumi.Output<{ ... }[] | undefined>;

A list of DB parameters to apply. Note that parameters may differ from a family to an other. Full list of all parameters can be discovered via aws rds describe-db-cluster-parameters after initial creation of the group.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class ClusterSnapshot

Manages a RDS database cluster snapshot for Aurora clusters. For managing RDS database instance snapshots, see the aws_db_snapshot resource.

constructor

new ClusterSnapshot(name: string, args: ClusterSnapshotArgs, opts?: pulumi.CustomResourceOptions)

Create a ClusterSnapshot resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ClusterSnapshotState): ClusterSnapshot

Get an existing ClusterSnapshot resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property allocatedStorage

public allocatedStorage: pulumi.Output<number>;

Specifies the allocated storage size in gigabytes (GB).

property availabilityZones

public availabilityZones: pulumi.Output<string[]>;

List of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.

property dbClusterIdentifier

public dbClusterIdentifier: pulumi.Output<string>;

The DB Cluster Identifier from which to take the snapshot.

property dbClusterSnapshotArn

public dbClusterSnapshotArn: pulumi.Output<string>;

The Amazon Resource Name (ARN) for the DB Cluster Snapshot.

property dbClusterSnapshotIdentifier

public dbClusterSnapshotIdentifier: pulumi.Output<string>;

The Identifier for the snapshot.

property engine

public engine: pulumi.Output<string>;

Specifies the name of the database engine.

property engineVersion

public engineVersion: pulumi.Output<string>;

Version of the database engine for this DB cluster snapshot.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property kmsKeyId

public kmsKeyId: pulumi.Output<string>;

If storage_encrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.

property licenseModel

public licenseModel: pulumi.Output<string>;

License model information for the restored DB cluster.

property port

public port: pulumi.Output<number>;

Port that the DB cluster was listening on at the time of the snapshot.

property snapshotType

public snapshotType: pulumi.Output<string>;

property sourceDbClusterSnapshotArn

public sourceDbClusterSnapshotArn: pulumi.Output<string>;

property status

public status: pulumi.Output<string>;

The status of this DB Cluster Snapshot.

property storageEncrypted

public storageEncrypted: pulumi.Output<boolean>;

Specifies whether the DB cluster snapshot is encrypted.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property vpcId

public vpcId: pulumi.Output<string>;

The VPC ID associated with the DB cluster snapshot.

class EventSubscription

Provides a DB event subscription resource.

constructor

new EventSubscription(name: string, args: EventSubscriptionArgs, opts?: pulumi.CustomResourceOptions)

Create a EventSubscription resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: EventSubscriptionState): EventSubscription

Get an existing EventSubscription resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

property customerAwsId

public customerAwsId: pulumi.Output<string>;

property enabled

public enabled: pulumi.Output<boolean | undefined>;

A boolean flag to enable/disable the subscription. Defaults to true.

property eventCategories

public eventCategories: pulumi.Output<string[] | undefined>;

A list of event categories for a SourceType that you want to subscribe to. See http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html or run aws rds describe-event-categories.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the DB event subscription. By default generated by Terraform.

property namePrefix

public namePrefix: pulumi.Output<string | undefined>;

The name of the DB event subscription. Conflicts with name.

property snsTopic

public snsTopic: pulumi.Output<string>;

The SNS topic to send events to.

property sourceIds

public sourceIds: pulumi.Output<string[] | undefined>;

A list of identifiers of the event sources for which events will be returned. If not specified, then all sources are included in the response. If specified, a source_type must also be specified.

property sourceType

public sourceType: pulumi.Output<string | undefined>;

The type of source that will be generating the events. Valid options are db-instance, db-security-group, db-parameter-group, db-snapshot, db-cluster or db-cluster-snapshot. If not set, all sources will be subscribed to.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Instance

Provides an RDS instance resource. A DB instance is an isolated database environment in the cloud. A DB instance can contain multiple user-created databases.

Changes to a DB instance can occur when you manually change a parameter, such as allocated_storage, and are reflected in the next maintenance window. Because of this, Terraform may report a difference in its planning phase because a modification has not yet taken place. You can use the apply_immediately flag to instruct the service to apply the change immediately (see documentation below).

When upgrading the major version of an engine, allow_major_version_upgrade must be set to true.

~> Note: using apply_immediately can result in a brief downtime as the server reboots. See the AWS Docs on [RDS Maintenance][2] for more information.

~> Note: All arguments including the username and password will be stored in the raw state as plain-text. Read more about sensitive data in state.

constructor

new Instance(name: string, args: InstanceArgs, opts?: pulumi.CustomResourceOptions)

Create a Instance resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: InstanceState): Instance

Get an existing Instance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property address

public address: pulumi.Output<string>;

The hostname of the RDS instance. See also endpoint and port.

property allocatedStorage

public allocatedStorage: pulumi.Output<number>;

(Required unless a snapshot_identifier or replicate_source_db is provided) The allocated storage in gibibytes.

property allowMajorVersionUpgrade

public allowMajorVersionUpgrade: pulumi.Output<boolean | undefined>;

Indicates that major version upgrades are allowed. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.

property applyImmediately

public applyImmediately: pulumi.Output<boolean>;

Specifies whether any database modifications are applied immediately, or during the next maintenance window. Default is false. See Amazon RDS Documentation for more information. for more information.

property arn

public arn: pulumi.Output<string>;

The ARN of the RDS instance.

property autoMinorVersionUpgrade

public autoMinorVersionUpgrade: pulumi.Output<boolean | undefined>;

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window. Defaults to true.

property availabilityZone

public availabilityZone: pulumi.Output<string>;

The AZ for the RDS instance.

property backupRetentionPeriod

public backupRetentionPeriod: pulumi.Output<number>;

The days to retain backups for. Must be 1 or greater to be a source for a [Read Replica][1].

property backupWindow

public backupWindow: pulumi.Output<string>;

The daily time range (in UTC) during which automated backups are created if they are enabled. Example: “09:46-10:16”. Must not overlap with maintenance_window.

property caCertIdentifier

public caCertIdentifier: pulumi.Output<string>;

Specifies the identifier of the CA certificate for the DB instance.

property characterSetName

public characterSetName: pulumi.Output<string>;

The character set name to use for DB encoding in Oracle instances. This can’t be changed. See Oracle Character Sets Supported in Amazon RDS for more information.

property copyTagsToSnapshot

public copyTagsToSnapshot: pulumi.Output<boolean | undefined>;

On delete, copy all Instance tags to the final snapshot (if final_snapshot_identifier is specified). Default is false.

property dbSubnetGroupName

public dbSubnetGroupName: pulumi.Output<string>;

Name of DB subnet group. DB instance will be created in the VPC associated with the DB subnet group. If unspecified, will be created in the default VPC, or in EC2 Classic, if available. When working with read replicas, it needs to be specified only if the source database specifies an instance in another AWS Region. See DBSubnetGroupName in API action CreateDBInstanceReadReplica for additional read replica contraints.

property domain

public domain: pulumi.Output<string | undefined>;

The ID of the Directory Service Active Directory domain to create the instance in.

property domainIamRoleName

public domainIamRoleName: pulumi.Output<string | undefined>;

The name of the IAM role to be used when making API calls to the Directory Service.

property enabledCloudwatchLogsExports

public enabledCloudwatchLogsExports: pulumi.Output<string[] | undefined>;

List of log types to enable for exporting to CloudWatch logs. If omitted, no logs will be exported. Valid values (depending on engine): alert, audit, error, general, listener, slowquery, trace.

property endpoint

public endpoint: pulumi.Output<string>;

The connection endpoint in address:port format.

property engine

public engine: pulumi.Output<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) The database engine to use. For supported values, see the Engine parameter in API action CreateDBInstance. Note that for Amazon Aurora instances the engine must match the DB cluster’s engine’. For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

property engineVersion

public engineVersion: pulumi.Output<string>;

The engine version to use. If auto_minor_version_upgrade is enabled, you can provide a prefix of the version such as 5.7 (for 5.7.10) and this attribute will ignore differences in the patch version automatically (e.g. 5.7.17). For supported values, see the EngineVersion parameter in API action CreateDBInstance. Note that for Amazon Aurora instances the engine version must match the DB cluster’s engine version’.

property finalSnapshotIdentifier

public finalSnapshotIdentifier: pulumi.Output<string | undefined>;

The name of your final DB snapshot when this DB instance is deleted. If omitted, no final snapshot will be made.

property hostedZoneId

public hostedZoneId: pulumi.Output<string>;

The canonical hosted zone ID of the DB instance (to be used in a Route 53 Alias record).

property iamDatabaseAuthenticationEnabled

public iamDatabaseAuthenticationEnabled: pulumi.Output<boolean | undefined>;

Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property identifier

public identifier: pulumi.Output<string>;

The name of the RDS instance, if omitted, Terraform will assign a random, unique identifier.

property identifierPrefix

public identifierPrefix: pulumi.Output<string>;

Creates a unique identifier beginning with the specified prefix. Conflicts with identifer.

property instanceClass

public instanceClass: pulumi.Output<string>;

The instance type of the RDS instance.

property iops

public iops: pulumi.Output<number | undefined>;

The amount of provisioned IOPS. Setting this implies a storage_type of “io1”.

property kmsKeyId

public kmsKeyId: pulumi.Output<string>;

The ARN for the KMS encryption key. If creating an encrypted replica, set this to the destination KMS ARN.

property licenseModel

public licenseModel: pulumi.Output<string>;

(Optional, but required for some DB engines, i.e. Oracle SE1) License model information for this DB instance.

property maintenanceWindow

public maintenanceWindow: pulumi.Output<string>;

The window to perform maintenance in. Syntax: “ddd:hh24:mi-ddd:hh24:mi”. Eg: “Mon:00:00-Mon:03:00”. See RDS Maintenance Window docs for more information.

property monitoringInterval

public monitoringInterval: pulumi.Output<number | undefined>;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0. Valid Values: 0, 1, 5, 10, 15, 30, 60.

property monitoringRoleArn

public monitoringRoleArn: pulumi.Output<string>;

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. You can find more information on the AWS Documentation what IAM permissions are needed to allow Enhanced Monitoring for RDS Instances.

property multiAz

public multiAz: pulumi.Output<boolean>;

Specifies if the RDS instance is multi-AZ

property name

public name: pulumi.Output<string>;

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Note that this does not apply for Oracle or SQL Server engines. See the AWS documentation for more details on what applies for those engines.

property optionGroupName

public optionGroupName: pulumi.Output<string>;

Name of the DB option group to associate.

property parameterGroupName

public parameterGroupName: pulumi.Output<string>;

Name of the DB parameter group to associate.

property password

public password: pulumi.Output<string | undefined>;

(Required unless a snapshot_identifier or replicate_source_db is provided) Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file.

property port

public port: pulumi.Output<number>;

The port on which the DB accepts connections.

property publiclyAccessible

public publiclyAccessible: pulumi.Output<boolean | undefined>;

Bool to control if instance is publicly accessible. Default is false.

property replicas

public replicas: pulumi.Output<string[]>;

property replicateSourceDb

public replicateSourceDb: pulumi.Output<string | undefined>;

Specifies that this resource is a Replicate database, and to use this value as the source database. This correlates to the identifier of another Amazon RDS Database to replicate. Note that if you are creating a cross-region replica of an encrypted database you will also need to specify a kms_key_id. See [DB Instance Replication][1] and Working with PostgreSQL and MySQL Read Replicas for more information on using Replication.

property resourceId

public resourceId: pulumi.Output<string>;

The RDS Resource ID of this instance.

property s3Import

public s3Import: pulumi.Output<{ ... } | undefined>;

Restore from a Percona Xtrabackup in S3. See Importing Data into an Amazon RDS MySQL DB Instance

property securityGroupNames

public securityGroupNames: pulumi.Output<string[] | undefined>;

List of DB Security Groups to associate. Only used for DB Instances on the EC2-Classic Platform.

property skipFinalSnapshot

public skipFinalSnapshot: pulumi.Output<boolean | undefined>;

Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted, using the value from final_snapshot_identifier. Default is false.

property snapshotIdentifier

public snapshotIdentifier: pulumi.Output<string | undefined>;

Specifies whether or not to create this database from a snapshot. This correlates to the snapshot ID you’d find in the RDS console, e.g: rds:production-2015-06-26-06-05.

property status

public status: pulumi.Output<string>;

The RDS instance status.

property storageEncrypted

public storageEncrypted: pulumi.Output<boolean | undefined>;

Specifies whether the DB instance is encrypted. Note that if you are creating a cross-region read replica this field is ignored and you should instead declare kms_key_id with a valid ARN. The default is false if not specified.

property storageType

public storageType: pulumi.Output<string>;

One of “standard” (magnetic), “gp2” (general purpose SSD), or “io1” (provisioned IOPS SSD). The default is “io1” if iops is specified, “standard” if not. Note that this behaviour is different from the AWS web console, where the default is “gp2”.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property timezone

public timezone: pulumi.Output<string>;

Time zone of the DB instance. timezone is currently only supported by Microsoft SQL Server. The timezone can only be set on creation. See MSSQL User Guide for more information.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property username

public username: pulumi.Output<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) Username for the master DB user.

property vpcSecurityGroupIds

public vpcSecurityGroupIds: pulumi.Output<string[]>;

List of VPC security groups to associate.

class OptionGroup

Provides an RDS DB option group resource. Documentation of the available options for various RDS engines can be found at:

constructor

new OptionGroup(name: string, args: OptionGroupArgs, opts?: pulumi.CustomResourceOptions)

Create a OptionGroup resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: OptionGroupState): OptionGroup

Get an existing OptionGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The ARN of the db option group.

property engineName

public engineName: pulumi.Output<string>;

Specifies the name of the engine that this option group should be associated with.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property majorEngineVersion

public majorEngineVersion: pulumi.Output<string>;

Specifies the major version of the engine that this option group should be associated with.

property name

public name: pulumi.Output<string>;

The Name of the setting.

property namePrefix

public namePrefix: pulumi.Output<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name. Must be lowercase, to match as it is stored in AWS.

property optionGroupDescription

public optionGroupDescription: pulumi.Output<string>;

The description of the option group. Defaults to “Managed by Terraform”.

property options

public options: pulumi.Output<{ ... }[] | undefined>;

A list of Options to apply.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class ParameterGroup

Provides an RDS DB parameter group resource .Documentation of the available parameters for various RDS engines can be found at:

constructor

new ParameterGroup(name: string, args: ParameterGroupArgs, opts?: pulumi.CustomResourceOptions)

Create a ParameterGroup resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ParameterGroupState): ParameterGroup

Get an existing ParameterGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The ARN of the db parameter group.

property description

public description: pulumi.Output<string>;

The description of the DB parameter group. Defaults to “Managed by Terraform”.

property family

public family: pulumi.Output<string>;

The family of the DB parameter group.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the DB parameter.

property namePrefix

public namePrefix: pulumi.Output<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property parameters

public parameters: pulumi.Output<{ ... }[] | undefined>;

A list of DB parameters to apply. Note that parameters may differ from a family to an other. Full list of all parameters can be discovered via aws rds describe-db-parameters after initial creation of the group.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class SecurityGroup

Provides an RDS security group resource. This is only for DB instances in the EC2-Classic Platform. For instances inside a VPC, use the aws_db_instance.vpc_security_group_ids attribute instead.

constructor

new SecurityGroup(name: string, args: SecurityGroupArgs, opts?: pulumi.CustomResourceOptions)

Create a SecurityGroup resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: SecurityGroupState): SecurityGroup

Get an existing SecurityGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The arn of the DB security group.

property description

public description: pulumi.Output<string>;

The description of the DB security group. Defaults to “Managed by Terraform”.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property ingress

public ingress: pulumi.Output<{ ... }[]>;

A list of ingress rules.

property name

public name: pulumi.Output<string>;

The name of the DB security group.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Snapshot

Manages a RDS database instance snapshot. For managing RDS database cluster snapshots, see the aws_db_cluster_snapshot resource.

constructor

new Snapshot(name: string, args: SnapshotArgs, opts?: pulumi.CustomResourceOptions)

Create a Snapshot resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: SnapshotState): Snapshot

Get an existing Snapshot resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property allocatedStorage

public allocatedStorage: pulumi.Output<number>;

Specifies the allocated storage size in gigabytes (GB).

property availabilityZone

public availabilityZone: pulumi.Output<string>;

Specifies the name of the Availability Zone the DB instance was located in at the time of the DB snapshot.

property dbInstanceIdentifier

public dbInstanceIdentifier: pulumi.Output<string>;

The DB Instance Identifier from which to take the snapshot.

property dbSnapshotArn

public dbSnapshotArn: pulumi.Output<string>;

The Amazon Resource Name (ARN) for the DB snapshot.

property dbSnapshotIdentifier

public dbSnapshotIdentifier: pulumi.Output<string>;

The Identifier for the snapshot.

property encrypted

public encrypted: pulumi.Output<boolean>;

Specifies whether the DB snapshot is encrypted.

property engine

public engine: pulumi.Output<string>;

Specifies the name of the database engine.

property engineVersion

public engineVersion: pulumi.Output<string>;

Specifies the version of the database engine.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property iops

public iops: pulumi.Output<number>;

Specifies the Provisioned IOPS (I/O operations per second) value of the DB instance at the time of the snapshot.

property kmsKeyId

public kmsKeyId: pulumi.Output<string>;

The ARN for the KMS encryption key.

property licenseModel

public licenseModel: pulumi.Output<string>;

License model information for the restored DB instance.

property optionGroupName

public optionGroupName: pulumi.Output<string>;

Provides the option group name for the DB snapshot.

property port

public port: pulumi.Output<number>;

property snapshotType

public snapshotType: pulumi.Output<string>;

property sourceDbSnapshotIdentifier

public sourceDbSnapshotIdentifier: pulumi.Output<string>;

The DB snapshot Arn that the DB snapshot was copied from. It only has value in case of cross customer or cross region copy.

property sourceRegion

public sourceRegion: pulumi.Output<string>;

The region that the DB snapshot was created in or copied from.

property status

public status: pulumi.Output<string>;

Specifies the status of this DB snapshot.

property storageType

public storageType: pulumi.Output<string>;

Specifies the storage type associated with DB snapshot.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property vpcId

public vpcId: pulumi.Output<string>;

Specifies the storage type associated with DB snapshot.

class SubnetGroup

Provides an RDS DB subnet group resource.

constructor

new SubnetGroup(name: string, args: SubnetGroupArgs, opts?: pulumi.CustomResourceOptions)

Create a SubnetGroup resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: SubnetGroupState): SubnetGroup

Get an existing SubnetGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The ARN of the db subnet group.

property description

public description: pulumi.Output<string | undefined>;

The description of the DB subnet group. Defaults to “Managed by Terraform”.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the DB subnet group. If omitted, Terraform will assign a random, unique name.

property namePrefix

public namePrefix: pulumi.Output<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property subnetIds

public subnetIds: pulumi.Output<string[]>;

A list of VPC subnet IDs.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

function getCluster

getCluster(args: GetClusterArgs, opts?: pulumi.InvokeOptions): Promise<GetClusterResult>

Provides information about a RDS cluster.

function getClusterSnapshot

getClusterSnapshot(args?: GetClusterSnapshotArgs, opts?: pulumi.InvokeOptions): Promise<GetClusterSnapshotResult>

Use this data source to get information about a DB Cluster Snapshot for use when provisioning DB clusters.

~> NOTE: This data source does not apply to snapshots created on DB Instances. See the aws_db_snapshot data source for DB Instance snapshots.

function getEventCategories

getEventCategories(args?: GetEventCategoriesArgs, opts?: pulumi.InvokeOptions): Promise<GetEventCategoriesResult>

function getInstance

getInstance(args: GetInstanceArgs, opts?: pulumi.InvokeOptions): Promise<GetInstanceResult>

Use this data source to get information about an RDS instance

function getSnapshot

getSnapshot(args?: GetSnapshotArgs, opts?: pulumi.InvokeOptions): Promise<GetSnapshotResult>

Use this data source to get information about a DB Snapshot for use when provisioning DB instances

~> NOTE: This data source does not apply to snapshots created on Aurora DB clusters. See the aws_db_cluster_snapshot data source for DB Cluster snapshots.

interface ClusterArgs

The set of arguments for constructing a Cluster resource.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is false. See Amazon RDS Documentation for more information.

property availabilityZones

availabilityZones?: pulumi.Input<pulumi.Input<string>[]>;

A list of EC2 Availability Zones that instances in the DB cluster can be created in

property backtrackWindow

backtrackWindow?: pulumi.Input<number>;

The target backtrack window, in seconds. Only available for aurora engine currently. To disable backtracking, set this value to 0. Defaults to 0. Must be between 0 and 259200 (72 hours)

property backupRetentionPeriod

backupRetentionPeriod?: pulumi.Input<number>;

The days to retain backups for. Default 1

property clusterIdentifier

clusterIdentifier?: pulumi.Input<string>;

The cluster identifier. If omitted, Terraform will assign a random, unique identifier.

property clusterIdentifierPrefix

clusterIdentifierPrefix?: pulumi.Input<string>;

Creates a unique cluster identifier beginning with the specified prefix. Conflicts with cluster_identifer.

property clusterMembers

clusterMembers?: pulumi.Input<pulumi.Input<string>[]>;

List of RDS Instances that are a part of this cluster

property databaseName

databaseName?: pulumi.Input<string>;

Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: [RDS Naming Constraints][5]

property dbClusterParameterGroupName

dbClusterParameterGroupName?: pulumi.Input<string>;

A cluster parameter group to associate with the cluster.

property dbSubnetGroupName

dbSubnetGroupName?: pulumi.Input<string>;

A DB subnet group to associate with this DB instance. NOTE: This must match the db_subnet_group_name specified on every aws_rds_cluster_instance in the cluster.

property enabledCloudwatchLogsExports

enabledCloudwatchLogsExports?: pulumi.Input<pulumi.Input<string>[]>;

List of log types to export to cloudwatch. If omitted, no logs will be exported. The following log types are supported: audit, error, general, slowquery.

property engine

engine?: pulumi.Input<string>;

The name of the database engine to be used for this DB cluster. Defaults to aurora. Valid Values: aurora, aurora-mysql, aurora-postgresql

property engineMode

engineMode?: pulumi.Input<string>;

The database engine mode. Valid values: parallelquery, provisioned, serverless. Defaults to: provisioned. See the RDS User Guide for limitations when using serverless.

property engineVersion

engineVersion?: pulumi.Input<string>;

The database engine version.

property finalSnapshotIdentifier

finalSnapshotIdentifier?: pulumi.Input<string>;

The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.

property iamDatabaseAuthenticationEnabled

iamDatabaseAuthenticationEnabled?: pulumi.Input<boolean>;

Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see [AWS Documentation][6] for availability and limitations.

property iamRoles

iamRoles?: pulumi.Input<pulumi.Input<string>[]>;

A List of ARNs for the IAM roles to associate to the RDS Cluster.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key. When specifying kms_key_id, storage_encrypted needs to be set to true.

property masterPassword

masterPassword?: pulumi.Input<string>;

Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file. Please refer to the [RDS Naming Constraints][5]

property masterUsername

masterUsername?: pulumi.Input<string>;

Username for the master DB user. Please refer to the [RDS Naming Constraints][5]

property port

port?: pulumi.Input<number>;

The port on which the DB accepts connections

property preferredBackupWindow

preferredBackupWindow?: pulumi.Input<string>;

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.Time in UTC Default: A 30-minute window selected at random from an 8-hour block of time per region. e.g. 04:00-09:00

property preferredMaintenanceWindow

preferredMaintenanceWindow?: pulumi.Input<string>;

The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30

property replicationSourceIdentifier

replicationSourceIdentifier?: pulumi.Input<string>;

ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.

property s3Import

s3Import?: pulumi.Input<{ ... }>;

property scalingConfiguration

scalingConfiguration?: pulumi.Input<{ ... }>;

Nested attribute with scaling properties. Only valid when engine_mode is set to serverless. More details below.

property skipFinalSnapshot

skipFinalSnapshot?: pulumi.Input<boolean>;

Determines whether a final DB snapshot is created before the DB cluster is deleted. If true is specified, no DB snapshot is created. If false is specified, a DB snapshot is created before the DB cluster is deleted, using the value from final_snapshot_identifier. Default is false.

property snapshotIdentifier

snapshotIdentifier?: pulumi.Input<string>;

Specifies whether or not to create this cluster from a snapshot. You can use either the name or ARN when specifying a DB cluster snapshot, or the ARN when specifying a DB snapshot.

property sourceRegion

sourceRegion?: pulumi.Input<string>;

The source region for an encrypted replica DB cluster.

property storageEncrypted

storageEncrypted?: pulumi.Input<boolean>;

Specifies whether the DB cluster is encrypted. The default is false for provisioned engine_mode and true for serverless engine_mode.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the DB cluster.

property vpcSecurityGroupIds

vpcSecurityGroupIds?: pulumi.Input<pulumi.Input<string>[]>;

List of VPC security groups to associate with the Cluster

interface ClusterInstanceArgs

The set of arguments for constructing a ClusterInstance resource.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any database modifications are applied immediately, or during the next maintenance window. Default isfalse.

property autoMinorVersionUpgrade

autoMinorVersionUpgrade?: pulumi.Input<boolean>;

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window. Default true.

property availabilityZone

availabilityZone?: pulumi.Input<string>;

The EC2 Availability Zone that the DB instance is created in. See docs about the details.

property clusterIdentifier

clusterIdentifier: pulumi.Input<string>;

The identifier of the aws_rds_cluster in which to launch this instance.

property dbParameterGroupName

dbParameterGroupName?: pulumi.Input<string>;

The name of the DB parameter group to associate with this instance.

property dbSubnetGroupName

dbSubnetGroupName?: pulumi.Input<string>;

A DB subnet group to associate with this DB instance. NOTE: This must match the db_subnet_group_name of the attached aws_rds_cluster.

property engine

engine?: pulumi.Input<string>;

The name of the database engine to be used for the RDS instance. Defaults to aurora. Valid Values: aurora, aurora-mysql, aurora-postgresql. For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

property engineVersion

engineVersion?: pulumi.Input<string>;

The database engine version.

property identifier

identifier?: pulumi.Input<string>;

The indentifier for the RDS instance, if omitted, Terraform will assign a random, unique identifier.

property identifierPrefix

identifierPrefix?: pulumi.Input<string>;

Creates a unique identifier beginning with the specified prefix. Conflicts with identifer.

property instanceClass

instanceClass: pulumi.Input<string>;

The instance class to use. For details on CPU and memory, see [Scaling Aurora DB Instances][4]. Aurora currently supports the below instance classes. Please see [AWS Documentation][7] for complete details.

  • db.t2.small
  • db.t2.medium
  • db.r3.large
  • db.r3.xlarge
  • db.r3.2xlarge
  • db.r3.4xlarge
  • db.r3.8xlarge
  • db.r4.large
  • db.r4.xlarge
  • db.r4.2xlarge
  • db.r4.4xlarge
  • db.r4.8xlarge
  • db.r4.16xlarge

property monitoringInterval

monitoringInterval?: pulumi.Input<number>;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0. Valid Values: 0, 1, 5, 10, 15, 30, 60.

property monitoringRoleArn

monitoringRoleArn?: pulumi.Input<string>;

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. You can find more information on the AWS Documentation what IAM permissions are needed to allow Enhanced Monitoring for RDS Instances.

property performanceInsightsEnabled

performanceInsightsEnabled?: pulumi.Input<boolean>;

Specifies whether Performance Insights is enabled or not.

property performanceInsightsKmsKeyId

performanceInsightsKmsKeyId?: pulumi.Input<string>;

The ARN for the KMS key to encrypt Performance Insights data. When specifying performance_insights_kms_key_id, performance_insights_enabled needs to be set to true.

property preferredBackupWindow

preferredBackupWindow?: pulumi.Input<string>;

The daily time range during which automated backups are created if automated backups are enabled. Eg: “04:00-09:00”

property preferredMaintenanceWindow

preferredMaintenanceWindow?: pulumi.Input<string>;

The window to perform maintenance in. Syntax: “ddd:hh24:mi-ddd:hh24:mi”. Eg: “Mon:00:00-Mon:03:00”.

property promotionTier

promotionTier?: pulumi.Input<number>;

Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

property publiclyAccessible

publiclyAccessible?: pulumi.Input<boolean>;

Bool to control if instance is publicly accessible. Default false. See the documentation on [Creating DB Instances][6] for more details on controlling this property.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the instance.

interface ClusterInstanceState

Input properties used for looking up and filtering ClusterInstance resources.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any database modifications are applied immediately, or during the next maintenance window. Default isfalse.

property arn

arn?: pulumi.Input<string>;

Amazon Resource Name (ARN) of cluster instance

property autoMinorVersionUpgrade

autoMinorVersionUpgrade?: pulumi.Input<boolean>;

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window. Default true.

property availabilityZone

availabilityZone?: pulumi.Input<string>;

The EC2 Availability Zone that the DB instance is created in. See docs about the details.

property clusterIdentifier

clusterIdentifier?: pulumi.Input<string>;

The identifier of the aws_rds_cluster in which to launch this instance.

property dbParameterGroupName

dbParameterGroupName?: pulumi.Input<string>;

The name of the DB parameter group to associate with this instance.

property dbSubnetGroupName

dbSubnetGroupName?: pulumi.Input<string>;

A DB subnet group to associate with this DB instance. NOTE: This must match the db_subnet_group_name of the attached aws_rds_cluster.

property dbiResourceId

dbiResourceId?: pulumi.Input<string>;

The region-unique, immutable identifier for the DB instance.

property endpoint

endpoint?: pulumi.Input<string>;

The DNS address for this instance. May not be writable

property engine

engine?: pulumi.Input<string>;

The name of the database engine to be used for the RDS instance. Defaults to aurora. Valid Values: aurora, aurora-mysql, aurora-postgresql. For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

property engineVersion

engineVersion?: pulumi.Input<string>;

The database engine version.

property identifier

identifier?: pulumi.Input<string>;

The indentifier for the RDS instance, if omitted, Terraform will assign a random, unique identifier.

property identifierPrefix

identifierPrefix?: pulumi.Input<string>;

Creates a unique identifier beginning with the specified prefix. Conflicts with identifer.

property instanceClass

instanceClass?: pulumi.Input<string>;

The instance class to use. For details on CPU and memory, see [Scaling Aurora DB Instances][4]. Aurora currently supports the below instance classes. Please see [AWS Documentation][7] for complete details.

  • db.t2.small
  • db.t2.medium
  • db.r3.large
  • db.r3.xlarge
  • db.r3.2xlarge
  • db.r3.4xlarge
  • db.r3.8xlarge
  • db.r4.large
  • db.r4.xlarge
  • db.r4.2xlarge
  • db.r4.4xlarge
  • db.r4.8xlarge
  • db.r4.16xlarge

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key if one is set to the cluster.

property monitoringInterval

monitoringInterval?: pulumi.Input<number>;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0. Valid Values: 0, 1, 5, 10, 15, 30, 60.

property monitoringRoleArn

monitoringRoleArn?: pulumi.Input<string>;

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. You can find more information on the AWS Documentation what IAM permissions are needed to allow Enhanced Monitoring for RDS Instances.

property performanceInsightsEnabled

performanceInsightsEnabled?: pulumi.Input<boolean>;

Specifies whether Performance Insights is enabled or not.

property performanceInsightsKmsKeyId

performanceInsightsKmsKeyId?: pulumi.Input<string>;

The ARN for the KMS key to encrypt Performance Insights data. When specifying performance_insights_kms_key_id, performance_insights_enabled needs to be set to true.

property port

port?: pulumi.Input<number>;

The database port

property preferredBackupWindow

preferredBackupWindow?: pulumi.Input<string>;

The daily time range during which automated backups are created if automated backups are enabled. Eg: “04:00-09:00”

property preferredMaintenanceWindow

preferredMaintenanceWindow?: pulumi.Input<string>;

The window to perform maintenance in. Syntax: “ddd:hh24:mi-ddd:hh24:mi”. Eg: “Mon:00:00-Mon:03:00”.

property promotionTier

promotionTier?: pulumi.Input<number>;

Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

property publiclyAccessible

publiclyAccessible?: pulumi.Input<boolean>;

Bool to control if instance is publicly accessible. Default false. See the documentation on [Creating DB Instances][6] for more details on controlling this property.

property storageEncrypted

storageEncrypted?: pulumi.Input<boolean>;

Specifies whether the DB cluster is encrypted.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the instance.

property writer

writer?: pulumi.Input<boolean>;

Boolean indicating if this instance is writable. False indicates this instance is a read replica.

interface ClusterParameterGroupArgs

The set of arguments for constructing a ClusterParameterGroup resource.

property description

description?: pulumi.Input<string>;

The description of the DB cluster parameter group. Defaults to “Managed by Terraform”.

property family

family: pulumi.Input<string>;

The family of the DB cluster parameter group.

property name

name?: pulumi.Input<string>;

The name of the DB parameter.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property parameters

parameters?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of DB parameters to apply. Note that parameters may differ from a family to an other. Full list of all parameters can be discovered via aws rds describe-db-cluster-parameters after initial creation of the group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface ClusterParameterGroupState

Input properties used for looking up and filtering ClusterParameterGroup resources.

property arn

arn?: pulumi.Input<string>;

The ARN of the db cluster parameter group.

property description

description?: pulumi.Input<string>;

The description of the DB cluster parameter group. Defaults to “Managed by Terraform”.

property family

family?: pulumi.Input<string>;

The family of the DB cluster parameter group.

property name

name?: pulumi.Input<string>;

The name of the DB parameter.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property parameters

parameters?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of DB parameters to apply. Note that parameters may differ from a family to an other. Full list of all parameters can be discovered via aws rds describe-db-cluster-parameters after initial creation of the group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface ClusterSnapshotArgs

The set of arguments for constructing a ClusterSnapshot resource.

property dbClusterIdentifier

dbClusterIdentifier: pulumi.Input<string>;

The DB Cluster Identifier from which to take the snapshot.

property dbClusterSnapshotIdentifier

dbClusterSnapshotIdentifier: pulumi.Input<string>;

The Identifier for the snapshot.

interface ClusterSnapshotState

Input properties used for looking up and filtering ClusterSnapshot resources.

property allocatedStorage

allocatedStorage?: pulumi.Input<number>;

Specifies the allocated storage size in gigabytes (GB).

property availabilityZones

availabilityZones?: pulumi.Input<pulumi.Input<string>[]>;

List of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.

property dbClusterIdentifier

dbClusterIdentifier?: pulumi.Input<string>;

The DB Cluster Identifier from which to take the snapshot.

property dbClusterSnapshotArn

dbClusterSnapshotArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) for the DB Cluster Snapshot.

property dbClusterSnapshotIdentifier

dbClusterSnapshotIdentifier?: pulumi.Input<string>;

The Identifier for the snapshot.

property engine

engine?: pulumi.Input<string>;

Specifies the name of the database engine.

property engineVersion

engineVersion?: pulumi.Input<string>;

Version of the database engine for this DB cluster snapshot.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

If storage_encrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.

property licenseModel

licenseModel?: pulumi.Input<string>;

License model information for the restored DB cluster.

property port

port?: pulumi.Input<number>;

Port that the DB cluster was listening on at the time of the snapshot.

property snapshotType

snapshotType?: pulumi.Input<string>;

property sourceDbClusterSnapshotArn

sourceDbClusterSnapshotArn?: pulumi.Input<string>;

property status

status?: pulumi.Input<string>;

The status of this DB Cluster Snapshot.

property storageEncrypted

storageEncrypted?: pulumi.Input<boolean>;

Specifies whether the DB cluster snapshot is encrypted.

property vpcId

vpcId?: pulumi.Input<string>;

The VPC ID associated with the DB cluster snapshot.

interface ClusterState

Input properties used for looking up and filtering Cluster resources.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is false. See Amazon RDS Documentation for more information.

property arn

arn?: pulumi.Input<string>;

Amazon Resource Name (ARN) of cluster

property availabilityZones

availabilityZones?: pulumi.Input<pulumi.Input<string>[]>;

A list of EC2 Availability Zones that instances in the DB cluster can be created in

property backtrackWindow

backtrackWindow?: pulumi.Input<number>;

The target backtrack window, in seconds. Only available for aurora engine currently. To disable backtracking, set this value to 0. Defaults to 0. Must be between 0 and 259200 (72 hours)

property backupRetentionPeriod

backupRetentionPeriod?: pulumi.Input<number>;

The days to retain backups for. Default 1

property clusterIdentifier

clusterIdentifier?: pulumi.Input<string>;

The cluster identifier. If omitted, Terraform will assign a random, unique identifier.

property clusterIdentifierPrefix

clusterIdentifierPrefix?: pulumi.Input<string>;

Creates a unique cluster identifier beginning with the specified prefix. Conflicts with cluster_identifer.

property clusterMembers

clusterMembers?: pulumi.Input<pulumi.Input<string>[]>;

List of RDS Instances that are a part of this cluster

property clusterResourceId

clusterResourceId?: pulumi.Input<string>;

The RDS Cluster Resource ID

property databaseName

databaseName?: pulumi.Input<string>;

Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: [RDS Naming Constraints][5]

property dbClusterParameterGroupName

dbClusterParameterGroupName?: pulumi.Input<string>;

A cluster parameter group to associate with the cluster.

property dbSubnetGroupName

dbSubnetGroupName?: pulumi.Input<string>;

A DB subnet group to associate with this DB instance. NOTE: This must match the db_subnet_group_name specified on every aws_rds_cluster_instance in the cluster.

property enabledCloudwatchLogsExports

enabledCloudwatchLogsExports?: pulumi.Input<pulumi.Input<string>[]>;

List of log types to export to cloudwatch. If omitted, no logs will be exported. The following log types are supported: audit, error, general, slowquery.

property endpoint

endpoint?: pulumi.Input<string>;

The DNS address of the RDS instance

property engine

engine?: pulumi.Input<string>;

The name of the database engine to be used for this DB cluster. Defaults to aurora. Valid Values: aurora, aurora-mysql, aurora-postgresql

property engineMode

engineMode?: pulumi.Input<string>;

The database engine mode. Valid values: parallelquery, provisioned, serverless. Defaults to: provisioned. See the RDS User Guide for limitations when using serverless.

property engineVersion

engineVersion?: pulumi.Input<string>;

The database engine version.

property finalSnapshotIdentifier

finalSnapshotIdentifier?: pulumi.Input<string>;

The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.

property hostedZoneId

hostedZoneId?: pulumi.Input<string>;

The Route53 Hosted Zone ID of the endpoint

property iamDatabaseAuthenticationEnabled

iamDatabaseAuthenticationEnabled?: pulumi.Input<boolean>;

Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see [AWS Documentation][6] for availability and limitations.

property iamRoles

iamRoles?: pulumi.Input<pulumi.Input<string>[]>;

A List of ARNs for the IAM roles to associate to the RDS Cluster.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key. When specifying kms_key_id, storage_encrypted needs to be set to true.

property masterPassword

masterPassword?: pulumi.Input<string>;

Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file. Please refer to the [RDS Naming Constraints][5]

property masterUsername

masterUsername?: pulumi.Input<string>;

Username for the master DB user. Please refer to the [RDS Naming Constraints][5]

property port

port?: pulumi.Input<number>;

The port on which the DB accepts connections

property preferredBackupWindow

preferredBackupWindow?: pulumi.Input<string>;

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.Time in UTC Default: A 30-minute window selected at random from an 8-hour block of time per region. e.g. 04:00-09:00

property preferredMaintenanceWindow

preferredMaintenanceWindow?: pulumi.Input<string>;

The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30

property readerEndpoint

readerEndpoint?: pulumi.Input<string>;

A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas

property replicationSourceIdentifier

replicationSourceIdentifier?: pulumi.Input<string>;

ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.

property s3Import

s3Import?: pulumi.Input<{ ... }>;

property scalingConfiguration

scalingConfiguration?: pulumi.Input<{ ... }>;

Nested attribute with scaling properties. Only valid when engine_mode is set to serverless. More details below.

property skipFinalSnapshot

skipFinalSnapshot?: pulumi.Input<boolean>;

Determines whether a final DB snapshot is created before the DB cluster is deleted. If true is specified, no DB snapshot is created. If false is specified, a DB snapshot is created before the DB cluster is deleted, using the value from final_snapshot_identifier. Default is false.

property snapshotIdentifier

snapshotIdentifier?: pulumi.Input<string>;

Specifies whether or not to create this cluster from a snapshot. You can use either the name or ARN when specifying a DB cluster snapshot, or the ARN when specifying a DB snapshot.

property sourceRegion

sourceRegion?: pulumi.Input<string>;

The source region for an encrypted replica DB cluster.

property storageEncrypted

storageEncrypted?: pulumi.Input<boolean>;

Specifies whether the DB cluster is encrypted. The default is false for provisioned engine_mode and true for serverless engine_mode.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the DB cluster.

property vpcSecurityGroupIds

vpcSecurityGroupIds?: pulumi.Input<pulumi.Input<string>[]>;

List of VPC security groups to associate with the Cluster

interface EventSubscriptionArgs

The set of arguments for constructing a EventSubscription resource.

property enabled

enabled?: pulumi.Input<boolean>;

A boolean flag to enable/disable the subscription. Defaults to true.

property eventCategories

eventCategories?: pulumi.Input<pulumi.Input<string>[]>;

A list of event categories for a SourceType that you want to subscribe to. See http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html or run aws rds describe-event-categories.

property name

name?: pulumi.Input<string>;

The name of the DB event subscription. By default generated by Terraform.

property namePrefix

namePrefix?: pulumi.Input<string>;

The name of the DB event subscription. Conflicts with name.

property snsTopic

snsTopic: pulumi.Input<string>;

The SNS topic to send events to.

property sourceIds

sourceIds?: pulumi.Input<pulumi.Input<string>[]>;

A list of identifiers of the event sources for which events will be returned. If not specified, then all sources are included in the response. If specified, a source_type must also be specified.

property sourceType

sourceType?: pulumi.Input<string>;

The type of source that will be generating the events. Valid options are db-instance, db-security-group, db-parameter-group, db-snapshot, db-cluster or db-cluster-snapshot. If not set, all sources will be subscribed to.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface EventSubscriptionState

Input properties used for looking up and filtering EventSubscription resources.

property arn

arn?: pulumi.Input<string>;

property customerAwsId

customerAwsId?: pulumi.Input<string>;

property enabled

enabled?: pulumi.Input<boolean>;

A boolean flag to enable/disable the subscription. Defaults to true.

property eventCategories

eventCategories?: pulumi.Input<pulumi.Input<string>[]>;

A list of event categories for a SourceType that you want to subscribe to. See http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html or run aws rds describe-event-categories.

property name

name?: pulumi.Input<string>;

The name of the DB event subscription. By default generated by Terraform.

property namePrefix

namePrefix?: pulumi.Input<string>;

The name of the DB event subscription. Conflicts with name.

property snsTopic

snsTopic?: pulumi.Input<string>;

The SNS topic to send events to.

property sourceIds

sourceIds?: pulumi.Input<pulumi.Input<string>[]>;

A list of identifiers of the event sources for which events will be returned. If not specified, then all sources are included in the response. If specified, a source_type must also be specified.

property sourceType

sourceType?: pulumi.Input<string>;

The type of source that will be generating the events. Valid options are db-instance, db-security-group, db-parameter-group, db-snapshot, db-cluster or db-cluster-snapshot. If not set, all sources will be subscribed to.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface GetClusterArgs

A collection of arguments for invoking getCluster.

property clusterIdentifier

clusterIdentifier: string;

The cluster identifier of the RDS cluster.

property tags

tags?: { ... };

interface GetClusterResult

A collection of values returned by getCluster.

property arn

arn: string;

property availabilityZones

availabilityZones: string[];

property backupRetentionPeriod

backupRetentionPeriod: number;

property clusterMembers

clusterMembers: string[];

property clusterResourceId

clusterResourceId: string;

property databaseName

databaseName: string;

property dbClusterParameterGroupName

dbClusterParameterGroupName: string;

property dbSubnetGroupName

dbSubnetGroupName: string;

property enabledCloudwatchLogsExports

enabledCloudwatchLogsExports: string[];

property endpoint

endpoint: string;

property engine

engine: string;

property engineVersion

engineVersion: string;

property finalSnapshotIdentifier

finalSnapshotIdentifier: string;

property iamDatabaseAuthenticationEnabled

iamDatabaseAuthenticationEnabled: boolean;

property iamRoles

iamRoles: string[];

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property kmsKeyId

kmsKeyId: string;

property masterUsername

masterUsername: string;

property port

port: number;

property preferredBackupWindow

preferredBackupWindow: string;

property preferredMaintenanceWindow

preferredMaintenanceWindow: string;

property readerEndpoint

readerEndpoint: string;

property replicationSourceIdentifier

replicationSourceIdentifier: string;

property storageEncrypted

storageEncrypted: boolean;

property tags

tags: { ... };

property vpcSecurityGroupIds

vpcSecurityGroupIds: string[];

interface GetClusterSnapshotArgs

A collection of arguments for invoking getClusterSnapshot.

property dbClusterIdentifier

dbClusterIdentifier?: string;

Returns the list of snapshots created by the specific db_cluster

property dbClusterSnapshotIdentifier

dbClusterSnapshotIdentifier?: string;

Returns information on a specific snapshot_id.

property includePublic

includePublic?: boolean;

Set this value to true to include manual DB Cluster Snapshots that are public and can be copied or restored by any AWS account, otherwise set this value to false. The default is false.

property includeShared

includeShared?: boolean;

Set this value to true to include shared manual DB Cluster Snapshots from other AWS accounts that this AWS account has been given permission to copy or restore, otherwise set this value to false. The default is false.

property mostRecent

mostRecent?: boolean;

If more than one result is returned, use the most recent Snapshot.

property snapshotType

snapshotType?: string;

The type of snapshots to be returned. If you don’t specify a SnapshotType value, then both automated and manual DB cluster snapshots are returned. Shared and public DB Cluster Snapshots are not included in the returned results by default. Possible values are, automated, manual, shared and public.

interface GetClusterSnapshotResult

A collection of values returned by getClusterSnapshot.

property allocatedStorage

allocatedStorage: number;

Specifies the allocated storage size in gigabytes (GB).

property availabilityZones

availabilityZones: string[];

List of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.

property dbClusterSnapshotArn

dbClusterSnapshotArn: string;

The Amazon Resource Name (ARN) for the DB Cluster Snapshot.

property engine

engine: string;

Specifies the name of the database engine.

property engineVersion

engineVersion: string;

Version of the database engine for this DB cluster snapshot.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property kmsKeyId

kmsKeyId: string;

If storage_encrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.

property licenseModel

licenseModel: string;

License model information for the restored DB cluster.

property port

port: number;

Port that the DB cluster was listening on at the time of the snapshot.

property snapshotCreateTime

snapshotCreateTime: string;

Time when the snapshot was taken, in Universal Coordinated Time (UTC).

property sourceDbClusterSnapshotArn

sourceDbClusterSnapshotArn: string;

property status

status: string;

The status of this DB Cluster Snapshot.

property storageEncrypted

storageEncrypted: boolean;

Specifies whether the DB cluster snapshot is encrypted.

property vpcId

vpcId: string;

The VPC ID associated with the DB cluster snapshot.

interface GetEventCategoriesArgs

A collection of arguments for invoking getEventCategories.

property sourceType

sourceType?: string;

The type of source that will be generating the events. Valid options are db-instance, db-security-group, db-parameter-group, db-snapshot, db-cluster or db-cluster-snapshot.

interface GetEventCategoriesResult

A collection of values returned by getEventCategories.

property eventCategories

eventCategories: string[];

A list of the event categories.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

interface GetInstanceArgs

A collection of arguments for invoking getInstance.

property dbInstanceIdentifier

dbInstanceIdentifier: string;

The name of the RDS instance

interface GetInstanceResult

A collection of values returned by getInstance.

property address

address: string;

The hostname of the RDS instance. See also endpoint and port.

property allocatedStorage

allocatedStorage: number;

Specifies the allocated storage size specified in gigabytes.

property autoMinorVersionUpgrade

autoMinorVersionUpgrade: boolean;

Indicates that minor version patches are applied automatically.

property availabilityZone

availabilityZone: string;

Specifies the name of the Availability Zone the DB instance is located in.

property backupRetentionPeriod

backupRetentionPeriod: number;

Specifies the number of days for which automatic DB snapshots are retained.

property caCertIdentifier

caCertIdentifier: string;

Specifies the identifier of the CA certificate for the DB instance.

property dbClusterIdentifier

dbClusterIdentifier: string;

If the DB instance is a member of a DB cluster, contains the name of the DB cluster that the DB instance is a member of.

property dbInstanceArn

dbInstanceArn: string;

The Amazon Resource Name (ARN) for the DB instance.

property dbInstanceClass

dbInstanceClass: string;

Contains the name of the compute and memory capacity class of the DB instance.

property dbInstancePort

dbInstancePort: number;

Specifies the port that the DB instance listens on.

property dbName

dbName: string;

Contains the name of the initial database of this instance that was provided at create time, if one was specified when the DB instance was created. This same name is returned for the life of the DB instance.

property dbParameterGroups

dbParameterGroups: string[];

Provides the list of DB parameter groups applied to this DB instance.

property dbSecurityGroups

dbSecurityGroups: string[];

Provides List of DB security groups associated to this DB instance.

property dbSubnetGroup

dbSubnetGroup: string;

Specifies the name of the subnet group associated with the DB instance.

property enabledCloudwatchLogsExports

enabledCloudwatchLogsExports: string[];

List of log types to export to cloudwatch.

property endpoint

endpoint: string;

The connection endpoint in address:port format.

property engine

engine: string;

Provides the name of the database engine to be used for this DB instance.

property engineVersion

engineVersion: string;

Indicates the database engine version.

property hostedZoneId

hostedZoneId: string;

The canonical hosted zone ID of the DB instance (to be used in a Route 53 Alias record).

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property iops

iops: number;

Specifies the Provisioned IOPS (I/O operations per second) value.

property kmsKeyId

kmsKeyId: string;

If StorageEncrypted is true, the KMS key identifier for the encrypted DB instance.

property licenseModel

licenseModel: string;

License model information for this DB instance.

property masterUsername

masterUsername: string;

Contains the master username for the DB instance.

property monitoringInterval

monitoringInterval: number;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance.

property monitoringRoleArn

monitoringRoleArn: string;

The ARN for the IAM role that permits RDS to send Enhanced Monitoring metrics to CloudWatch Logs.

property multiAz

multiAz: boolean;

Specifies if the DB instance is a Multi-AZ deployment.

property optionGroupMemberships

optionGroupMemberships: string[];

Provides the list of option group memberships for this DB instance.

property port

port: number;

The database port.

property preferredBackupWindow

preferredBackupWindow: string;

Specifies the daily time range during which automated backups are created.

property preferredMaintenanceWindow

preferredMaintenanceWindow: string;

Specifies the weekly time range during which system maintenance can occur in UTC.

property publiclyAccessible

publiclyAccessible: boolean;

Specifies the accessibility options for the DB instance.

property replicateSourceDb

replicateSourceDb: string;

The identifier of the source DB that this is a replica of.

property storageEncrypted

storageEncrypted: boolean;

Specifies whether the DB instance is encrypted.

property storageType

storageType: string;

Specifies the storage type associated with DB instance.

property timezone

timezone: string;

The time zone of the DB instance.

property vpcSecurityGroups

vpcSecurityGroups: string[];

Provides a list of VPC security group elements that the DB instance belongs to.

interface GetSnapshotArgs

A collection of arguments for invoking getSnapshot.

property dbInstanceIdentifier

dbInstanceIdentifier?: string;

Returns the list of snapshots created by the specific db_instance

property dbSnapshotIdentifier

dbSnapshotIdentifier?: string;

Returns information on a specific snapshot_id.

property includePublic

includePublic?: boolean;

Set this value to true to include manual DB snapshots that are public and can be copied or restored by any AWS account, otherwise set this value to false. The default is false.

property includeShared

includeShared?: boolean;

Set this value to true to include shared manual DB snapshots from other AWS accounts that this AWS account has been given permission to copy or restore, otherwise set this value to false. The default is false.

property mostRecent

mostRecent?: boolean;

If more than one result is returned, use the most recent Snapshot.

property snapshotType

snapshotType?: string;

The type of snapshots to be returned. If you don’t specify a SnapshotType value, then both automated and manual snapshots are returned. Shared and public DB snapshots are not included in the returned results by default. Possible values are, automated, manual, shared and public.

interface GetSnapshotResult

A collection of values returned by getSnapshot.

property allocatedStorage

allocatedStorage: number;

Specifies the allocated storage size in gigabytes (GB).

property availabilityZone

availabilityZone: string;

Specifies the name of the Availability Zone the DB instance was located in at the time of the DB snapshot.

property dbSnapshotArn

dbSnapshotArn: string;

The Amazon Resource Name (ARN) for the DB snapshot.

property encrypted

encrypted: boolean;

Specifies whether the DB snapshot is encrypted.

property engine

engine: string;

Specifies the name of the database engine.

property engineVersion

engineVersion: string;

Specifies the version of the database engine.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property iops

iops: number;

Specifies the Provisioned IOPS (I/O operations per second) value of the DB instance at the time of the snapshot.

property kmsKeyId

kmsKeyId: string;

The ARN for the KMS encryption key.

property licenseModel

licenseModel: string;

License model information for the restored DB instance.

property optionGroupName

optionGroupName: string;

Provides the option group name for the DB snapshot.

property port

port: number;

property snapshotCreateTime

snapshotCreateTime: string;

Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).

property sourceDbSnapshotIdentifier

sourceDbSnapshotIdentifier: string;

The DB snapshot Arn that the DB snapshot was copied from. It only has value in case of cross customer or cross region copy.

property sourceRegion

sourceRegion: string;

The region that the DB snapshot was created in or copied from.

property status

status: string;

Specifies the status of this DB snapshot.

property storageType

storageType: string;

Specifies the storage type associated with DB snapshot.

property vpcId

vpcId: string;

Specifies the ID of the VPC associated with the DB snapshot.

interface InstanceArgs

The set of arguments for constructing a Instance resource.

property allocatedStorage

allocatedStorage?: pulumi.Input<number>;

(Required unless a snapshot_identifier or replicate_source_db is provided) The allocated storage in gibibytes.

property allowMajorVersionUpgrade

allowMajorVersionUpgrade?: pulumi.Input<boolean>;

Indicates that major version upgrades are allowed. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any database modifications are applied immediately, or during the next maintenance window. Default is false. See Amazon RDS Documentation for more information. for more information.

property autoMinorVersionUpgrade

autoMinorVersionUpgrade?: pulumi.Input<boolean>;

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window. Defaults to true.

property availabilityZone

availabilityZone?: pulumi.Input<string>;

The AZ for the RDS instance.

property backupRetentionPeriod

backupRetentionPeriod?: pulumi.Input<number>;

The days to retain backups for. Must be 1 or greater to be a source for a [Read Replica][1].

property backupWindow

backupWindow?: pulumi.Input<string>;

The daily time range (in UTC) during which automated backups are created if they are enabled. Example: “09:46-10:16”. Must not overlap with maintenance_window.

property characterSetName

characterSetName?: pulumi.Input<string>;

The character set name to use for DB encoding in Oracle instances. This can’t be changed. See Oracle Character Sets Supported in Amazon RDS for more information.

property copyTagsToSnapshot

copyTagsToSnapshot?: pulumi.Input<boolean>;

On delete, copy all Instance tags to the final snapshot (if final_snapshot_identifier is specified). Default is false.

property dbSubnetGroupName

dbSubnetGroupName?: pulumi.Input<string>;

Name of DB subnet group. DB instance will be created in the VPC associated with the DB subnet group. If unspecified, will be created in the default VPC, or in EC2 Classic, if available. When working with read replicas, it needs to be specified only if the source database specifies an instance in another AWS Region. See DBSubnetGroupName in API action CreateDBInstanceReadReplica for additional read replica contraints.

property domain

domain?: pulumi.Input<string>;

The ID of the Directory Service Active Directory domain to create the instance in.

property domainIamRoleName

domainIamRoleName?: pulumi.Input<string>;

The name of the IAM role to be used when making API calls to the Directory Service.

property enabledCloudwatchLogsExports

enabledCloudwatchLogsExports?: pulumi.Input<pulumi.Input<string>[]>;

List of log types to enable for exporting to CloudWatch logs. If omitted, no logs will be exported. Valid values (depending on engine): alert, audit, error, general, listener, slowquery, trace.

property engine

engine?: pulumi.Input<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) The database engine to use. For supported values, see the Engine parameter in API action CreateDBInstance. Note that for Amazon Aurora instances the engine must match the DB cluster’s engine’. For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

property engineVersion

engineVersion?: pulumi.Input<string>;

The engine version to use. If auto_minor_version_upgrade is enabled, you can provide a prefix of the version such as 5.7 (for 5.7.10) and this attribute will ignore differences in the patch version automatically (e.g. 5.7.17). For supported values, see the EngineVersion parameter in API action CreateDBInstance. Note that for Amazon Aurora instances the engine version must match the DB cluster’s engine version’.

property finalSnapshotIdentifier

finalSnapshotIdentifier?: pulumi.Input<string>;

The name of your final DB snapshot when this DB instance is deleted. If omitted, no final snapshot will be made.

property iamDatabaseAuthenticationEnabled

iamDatabaseAuthenticationEnabled?: pulumi.Input<boolean>;

Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled.

property identifier

identifier?: pulumi.Input<string>;

The name of the RDS instance, if omitted, Terraform will assign a random, unique identifier.

property identifierPrefix

identifierPrefix?: pulumi.Input<string>;

Creates a unique identifier beginning with the specified prefix. Conflicts with identifer.

property instanceClass

instanceClass: pulumi.Input<string>;

The instance type of the RDS instance.

property iops

iops?: pulumi.Input<number>;

The amount of provisioned IOPS. Setting this implies a storage_type of “io1”.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key. If creating an encrypted replica, set this to the destination KMS ARN.

property licenseModel

licenseModel?: pulumi.Input<string>;

(Optional, but required for some DB engines, i.e. Oracle SE1) License model information for this DB instance.

property maintenanceWindow

maintenanceWindow?: pulumi.Input<string>;

The window to perform maintenance in. Syntax: “ddd:hh24:mi-ddd:hh24:mi”. Eg: “Mon:00:00-Mon:03:00”. See RDS Maintenance Window docs for more information.

property monitoringInterval

monitoringInterval?: pulumi.Input<number>;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0. Valid Values: 0, 1, 5, 10, 15, 30, 60.

property monitoringRoleArn

monitoringRoleArn?: pulumi.Input<string>;

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. You can find more information on the AWS Documentation what IAM permissions are needed to allow Enhanced Monitoring for RDS Instances.

property multiAz

multiAz?: pulumi.Input<boolean>;

Specifies if the RDS instance is multi-AZ

property name

name?: pulumi.Input<string>;

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Note that this does not apply for Oracle or SQL Server engines. See the AWS documentation for more details on what applies for those engines.

property optionGroupName

optionGroupName?: pulumi.Input<string>;

Name of the DB option group to associate.

property parameterGroupName

parameterGroupName?: pulumi.Input<string>;

Name of the DB parameter group to associate.

property password

password?: pulumi.Input<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file.

property port

port?: pulumi.Input<number>;

The port on which the DB accepts connections.

property publiclyAccessible

publiclyAccessible?: pulumi.Input<boolean>;

Bool to control if instance is publicly accessible. Default is false.

property replicateSourceDb

replicateSourceDb?: pulumi.Input<string>;

Specifies that this resource is a Replicate database, and to use this value as the source database. This correlates to the identifier of another Amazon RDS Database to replicate. Note that if you are creating a cross-region replica of an encrypted database you will also need to specify a kms_key_id. See [DB Instance Replication][1] and Working with PostgreSQL and MySQL Read Replicas for more information on using Replication.

property s3Import

s3Import?: pulumi.Input<{ ... }>;

Restore from a Percona Xtrabackup in S3. See Importing Data into an Amazon RDS MySQL DB Instance

property securityGroupNames

securityGroupNames?: pulumi.Input<pulumi.Input<string>[]>;

List of DB Security Groups to associate. Only used for DB Instances on the EC2-Classic Platform.

property skipFinalSnapshot

skipFinalSnapshot?: pulumi.Input<boolean>;

Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted, using the value from final_snapshot_identifier. Default is false.

property snapshotIdentifier

snapshotIdentifier?: pulumi.Input<string>;

Specifies whether or not to create this database from a snapshot. This correlates to the snapshot ID you’d find in the RDS console, e.g: rds:production-2015-06-26-06-05.

property storageEncrypted

storageEncrypted?: pulumi.Input<boolean>;

Specifies whether the DB instance is encrypted. Note that if you are creating a cross-region read replica this field is ignored and you should instead declare kms_key_id with a valid ARN. The default is false if not specified.

property storageType

storageType?: pulumi.Input<string>;

One of “standard” (magnetic), “gp2” (general purpose SSD), or “io1” (provisioned IOPS SSD). The default is “io1” if iops is specified, “standard” if not. Note that this behaviour is different from the AWS web console, where the default is “gp2”.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

property timezone

timezone?: pulumi.Input<string>;

Time zone of the DB instance. timezone is currently only supported by Microsoft SQL Server. The timezone can only be set on creation. See MSSQL User Guide for more information.

property username

username?: pulumi.Input<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) Username for the master DB user.

property vpcSecurityGroupIds

vpcSecurityGroupIds?: pulumi.Input<pulumi.Input<string>[]>;

List of VPC security groups to associate.

interface InstanceState

Input properties used for looking up and filtering Instance resources.

property address

address?: pulumi.Input<string>;

The hostname of the RDS instance. See also endpoint and port.

property allocatedStorage

allocatedStorage?: pulumi.Input<number>;

(Required unless a snapshot_identifier or replicate_source_db is provided) The allocated storage in gibibytes.

property allowMajorVersionUpgrade

allowMajorVersionUpgrade?: pulumi.Input<boolean>;

Indicates that major version upgrades are allowed. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any database modifications are applied immediately, or during the next maintenance window. Default is false. See Amazon RDS Documentation for more information. for more information.

property arn

arn?: pulumi.Input<string>;

The ARN of the RDS instance.

property autoMinorVersionUpgrade

autoMinorVersionUpgrade?: pulumi.Input<boolean>;

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window. Defaults to true.

property availabilityZone

availabilityZone?: pulumi.Input<string>;

The AZ for the RDS instance.

property backupRetentionPeriod

backupRetentionPeriod?: pulumi.Input<number>;

The days to retain backups for. Must be 1 or greater to be a source for a [Read Replica][1].

property backupWindow

backupWindow?: pulumi.Input<string>;

The daily time range (in UTC) during which automated backups are created if they are enabled. Example: “09:46-10:16”. Must not overlap with maintenance_window.

property caCertIdentifier

caCertIdentifier?: pulumi.Input<string>;

Specifies the identifier of the CA certificate for the DB instance.

property characterSetName

characterSetName?: pulumi.Input<string>;

The character set name to use for DB encoding in Oracle instances. This can’t be changed. See Oracle Character Sets Supported in Amazon RDS for more information.

property copyTagsToSnapshot

copyTagsToSnapshot?: pulumi.Input<boolean>;

On delete, copy all Instance tags to the final snapshot (if final_snapshot_identifier is specified). Default is false.

property dbSubnetGroupName

dbSubnetGroupName?: pulumi.Input<string>;

Name of DB subnet group. DB instance will be created in the VPC associated with the DB subnet group. If unspecified, will be created in the default VPC, or in EC2 Classic, if available. When working with read replicas, it needs to be specified only if the source database specifies an instance in another AWS Region. See DBSubnetGroupName in API action CreateDBInstanceReadReplica for additional read replica contraints.

property domain

domain?: pulumi.Input<string>;

The ID of the Directory Service Active Directory domain to create the instance in.

property domainIamRoleName

domainIamRoleName?: pulumi.Input<string>;

The name of the IAM role to be used when making API calls to the Directory Service.

property enabledCloudwatchLogsExports

enabledCloudwatchLogsExports?: pulumi.Input<pulumi.Input<string>[]>;

List of log types to enable for exporting to CloudWatch logs. If omitted, no logs will be exported. Valid values (depending on engine): alert, audit, error, general, listener, slowquery, trace.

property endpoint

endpoint?: pulumi.Input<string>;

The connection endpoint in address:port format.

property engine

engine?: pulumi.Input<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) The database engine to use. For supported values, see the Engine parameter in API action CreateDBInstance. Note that for Amazon Aurora instances the engine must match the DB cluster’s engine’. For information on the difference between the available Aurora MySQL engines see Comparison between Aurora MySQL 1 and Aurora MySQL 2 in the Amazon RDS User Guide.

property engineVersion

engineVersion?: pulumi.Input<string>;

The engine version to use. If auto_minor_version_upgrade is enabled, you can provide a prefix of the version such as 5.7 (for 5.7.10) and this attribute will ignore differences in the patch version automatically (e.g. 5.7.17). For supported values, see the EngineVersion parameter in API action CreateDBInstance. Note that for Amazon Aurora instances the engine version must match the DB cluster’s engine version’.

property finalSnapshotIdentifier

finalSnapshotIdentifier?: pulumi.Input<string>;

The name of your final DB snapshot when this DB instance is deleted. If omitted, no final snapshot will be made.

property hostedZoneId

hostedZoneId?: pulumi.Input<string>;

The canonical hosted zone ID of the DB instance (to be used in a Route 53 Alias record).

property iamDatabaseAuthenticationEnabled

iamDatabaseAuthenticationEnabled?: pulumi.Input<boolean>;

Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled.

property identifier

identifier?: pulumi.Input<string>;

The name of the RDS instance, if omitted, Terraform will assign a random, unique identifier.

property identifierPrefix

identifierPrefix?: pulumi.Input<string>;

Creates a unique identifier beginning with the specified prefix. Conflicts with identifer.

property instanceClass

instanceClass?: pulumi.Input<string>;

The instance type of the RDS instance.

property iops

iops?: pulumi.Input<number>;

The amount of provisioned IOPS. Setting this implies a storage_type of “io1”.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key. If creating an encrypted replica, set this to the destination KMS ARN.

property licenseModel

licenseModel?: pulumi.Input<string>;

(Optional, but required for some DB engines, i.e. Oracle SE1) License model information for this DB instance.

property maintenanceWindow

maintenanceWindow?: pulumi.Input<string>;

The window to perform maintenance in. Syntax: “ddd:hh24:mi-ddd:hh24:mi”. Eg: “Mon:00:00-Mon:03:00”. See RDS Maintenance Window docs for more information.

property monitoringInterval

monitoringInterval?: pulumi.Input<number>;

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0. Valid Values: 0, 1, 5, 10, 15, 30, 60.

property monitoringRoleArn

monitoringRoleArn?: pulumi.Input<string>;

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. You can find more information on the AWS Documentation what IAM permissions are needed to allow Enhanced Monitoring for RDS Instances.

property multiAz

multiAz?: pulumi.Input<boolean>;

Specifies if the RDS instance is multi-AZ

property name

name?: pulumi.Input<string>;

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Note that this does not apply for Oracle or SQL Server engines. See the AWS documentation for more details on what applies for those engines.

property optionGroupName

optionGroupName?: pulumi.Input<string>;

Name of the DB option group to associate.

property parameterGroupName

parameterGroupName?: pulumi.Input<string>;

Name of the DB parameter group to associate.

property password

password?: pulumi.Input<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file.

property port

port?: pulumi.Input<number>;

The port on which the DB accepts connections.

property publiclyAccessible

publiclyAccessible?: pulumi.Input<boolean>;

Bool to control if instance is publicly accessible. Default is false.

property replicas

replicas?: pulumi.Input<pulumi.Input<string>[]>;

property replicateSourceDb

replicateSourceDb?: pulumi.Input<string>;

Specifies that this resource is a Replicate database, and to use this value as the source database. This correlates to the identifier of another Amazon RDS Database to replicate. Note that if you are creating a cross-region replica of an encrypted database you will also need to specify a kms_key_id. See [DB Instance Replication][1] and Working with PostgreSQL and MySQL Read Replicas for more information on using Replication.

property resourceId

resourceId?: pulumi.Input<string>;

The RDS Resource ID of this instance.

property s3Import

s3Import?: pulumi.Input<{ ... }>;

Restore from a Percona Xtrabackup in S3. See Importing Data into an Amazon RDS MySQL DB Instance

property securityGroupNames

securityGroupNames?: pulumi.Input<pulumi.Input<string>[]>;

List of DB Security Groups to associate. Only used for DB Instances on the EC2-Classic Platform.

property skipFinalSnapshot

skipFinalSnapshot?: pulumi.Input<boolean>;

Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted, using the value from final_snapshot_identifier. Default is false.

property snapshotIdentifier

snapshotIdentifier?: pulumi.Input<string>;

Specifies whether or not to create this database from a snapshot. This correlates to the snapshot ID you’d find in the RDS console, e.g: rds:production-2015-06-26-06-05.

property status

status?: pulumi.Input<string>;

The RDS instance status.

property storageEncrypted

storageEncrypted?: pulumi.Input<boolean>;

Specifies whether the DB instance is encrypted. Note that if you are creating a cross-region read replica this field is ignored and you should instead declare kms_key_id with a valid ARN. The default is false if not specified.

property storageType

storageType?: pulumi.Input<string>;

One of “standard” (magnetic), “gp2” (general purpose SSD), or “io1” (provisioned IOPS SSD). The default is “io1” if iops is specified, “standard” if not. Note that this behaviour is different from the AWS web console, where the default is “gp2”.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

property timezone

timezone?: pulumi.Input<string>;

Time zone of the DB instance. timezone is currently only supported by Microsoft SQL Server. The timezone can only be set on creation. See MSSQL User Guide for more information.

property username

username?: pulumi.Input<string>;

(Required unless a snapshot_identifier or replicate_source_db is provided) Username for the master DB user.

property vpcSecurityGroupIds

vpcSecurityGroupIds?: pulumi.Input<pulumi.Input<string>[]>;

List of VPC security groups to associate.

interface OptionGroupArgs

The set of arguments for constructing a OptionGroup resource.

property engineName

engineName: pulumi.Input<string>;

Specifies the name of the engine that this option group should be associated with.

property majorEngineVersion

majorEngineVersion: pulumi.Input<string>;

Specifies the major version of the engine that this option group should be associated with.

property name

name?: pulumi.Input<string>;

The Name of the setting.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name. Must be lowercase, to match as it is stored in AWS.

property optionGroupDescription

optionGroupDescription?: pulumi.Input<string>;

The description of the option group. Defaults to “Managed by Terraform”.

property options

options?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of Options to apply.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface OptionGroupState

Input properties used for looking up and filtering OptionGroup resources.

property arn

arn?: pulumi.Input<string>;

The ARN of the db option group.

property engineName

engineName?: pulumi.Input<string>;

Specifies the name of the engine that this option group should be associated with.

property majorEngineVersion

majorEngineVersion?: pulumi.Input<string>;

Specifies the major version of the engine that this option group should be associated with.

property name

name?: pulumi.Input<string>;

The Name of the setting.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name. Must be lowercase, to match as it is stored in AWS.

property optionGroupDescription

optionGroupDescription?: pulumi.Input<string>;

The description of the option group. Defaults to “Managed by Terraform”.

property options

options?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of Options to apply.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface ParameterGroupArgs

The set of arguments for constructing a ParameterGroup resource.

property description

description?: pulumi.Input<string>;

The description of the DB parameter group. Defaults to “Managed by Terraform”.

property family

family: pulumi.Input<string>;

The family of the DB parameter group.

property name

name?: pulumi.Input<string>;

The name of the DB parameter.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property parameters

parameters?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of DB parameters to apply. Note that parameters may differ from a family to an other. Full list of all parameters can be discovered via aws rds describe-db-parameters after initial creation of the group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface ParameterGroupState

Input properties used for looking up and filtering ParameterGroup resources.

property arn

arn?: pulumi.Input<string>;

The ARN of the db parameter group.

property description

description?: pulumi.Input<string>;

The description of the DB parameter group. Defaults to “Managed by Terraform”.

property family

family?: pulumi.Input<string>;

The family of the DB parameter group.

property name

name?: pulumi.Input<string>;

The name of the DB parameter.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property parameters

parameters?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of DB parameters to apply. Note that parameters may differ from a family to an other. Full list of all parameters can be discovered via aws rds describe-db-parameters after initial creation of the group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface SecurityGroupArgs

The set of arguments for constructing a SecurityGroup resource.

property description

description?: pulumi.Input<string>;

The description of the DB security group. Defaults to “Managed by Terraform”.

property ingress

ingress: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of ingress rules.

property name

name?: pulumi.Input<string>;

The name of the DB security group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface SecurityGroupState

Input properties used for looking up and filtering SecurityGroup resources.

property arn

arn?: pulumi.Input<string>;

The arn of the DB security group.

property description

description?: pulumi.Input<string>;

The description of the DB security group. Defaults to “Managed by Terraform”.

property ingress

ingress?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of ingress rules.

property name

name?: pulumi.Input<string>;

The name of the DB security group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface SnapshotArgs

The set of arguments for constructing a Snapshot resource.

property dbInstanceIdentifier

dbInstanceIdentifier: pulumi.Input<string>;

The DB Instance Identifier from which to take the snapshot.

property dbSnapshotIdentifier

dbSnapshotIdentifier: pulumi.Input<string>;

The Identifier for the snapshot.

interface SnapshotState

Input properties used for looking up and filtering Snapshot resources.

property allocatedStorage

allocatedStorage?: pulumi.Input<number>;

Specifies the allocated storage size in gigabytes (GB).

property availabilityZone

availabilityZone?: pulumi.Input<string>;

Specifies the name of the Availability Zone the DB instance was located in at the time of the DB snapshot.

property dbInstanceIdentifier

dbInstanceIdentifier?: pulumi.Input<string>;

The DB Instance Identifier from which to take the snapshot.

property dbSnapshotArn

dbSnapshotArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) for the DB snapshot.

property dbSnapshotIdentifier

dbSnapshotIdentifier?: pulumi.Input<string>;

The Identifier for the snapshot.

property encrypted

encrypted?: pulumi.Input<boolean>;

Specifies whether the DB snapshot is encrypted.

property engine

engine?: pulumi.Input<string>;

Specifies the name of the database engine.

property engineVersion

engineVersion?: pulumi.Input<string>;

Specifies the version of the database engine.

property iops

iops?: pulumi.Input<number>;

Specifies the Provisioned IOPS (I/O operations per second) value of the DB instance at the time of the snapshot.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key.

property licenseModel

licenseModel?: pulumi.Input<string>;

License model information for the restored DB instance.

property optionGroupName

optionGroupName?: pulumi.Input<string>;

Provides the option group name for the DB snapshot.

property port

port?: pulumi.Input<number>;

property snapshotType

snapshotType?: pulumi.Input<string>;

property sourceDbSnapshotIdentifier

sourceDbSnapshotIdentifier?: pulumi.Input<string>;

The DB snapshot Arn that the DB snapshot was copied from. It only has value in case of cross customer or cross region copy.

property sourceRegion

sourceRegion?: pulumi.Input<string>;

The region that the DB snapshot was created in or copied from.

property status

status?: pulumi.Input<string>;

Specifies the status of this DB snapshot.

property storageType

storageType?: pulumi.Input<string>;

Specifies the storage type associated with DB snapshot.

property vpcId

vpcId?: pulumi.Input<string>;

Specifies the storage type associated with DB snapshot.

interface SubnetGroupArgs

The set of arguments for constructing a SubnetGroup resource.

property description

description?: pulumi.Input<string>;

The description of the DB subnet group. Defaults to “Managed by Terraform”.

property name

name?: pulumi.Input<string>;

The name of the DB subnet group. If omitted, Terraform will assign a random, unique name.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property subnetIds

subnetIds: pulumi.Input<pulumi.Input<string>[]>;

A list of VPC subnet IDs.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface SubnetGroupState

Input properties used for looking up and filtering SubnetGroup resources.

property arn

arn?: pulumi.Input<string>;

The ARN of the db subnet group.

property description

description?: pulumi.Input<string>;

The description of the DB subnet group. Defaults to “Managed by Terraform”.

property name

name?: pulumi.Input<string>;

The name of the DB subnet group. If omitted, Terraform will assign a random, unique name.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property subnetIds

subnetIds?: pulumi.Input<pulumi.Input<string>[]>;

A list of VPC subnet IDs.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.