Cluster
Manages a RDS Aurora Cluster. To manage cluster instances that inherit configuration from the cluster (when not running the cluster in serverless engine mode), see the aws.rds.ClusterInstance resource. To manage non-Aurora databases (e.g. MySQL, PostgreSQL, SQL Server, etc.), see the aws.rds.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 an RDS Cluster can occur when you manually change a
parameter, such as port, and are reflected in the next maintenance
window. Because of this, this provider 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_immediatelycan result in a brief downtime as the server reboots. See the AWS Docs on RDS Maintenance for more information.Note: All arguments including the username and password will be stored in the raw state as plain-text.
Example Usage
Aurora MySQL 2.x (MySQL 5.7)
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var @default = new Aws.Rds.Cluster("default", new Aws.Rds.ClusterArgs
{
AvailabilityZones =
{
"us-west-2a",
"us-west-2b",
"us-west-2c",
},
BackupRetentionPeriod = 5,
ClusterIdentifier = "aurora-cluster-demo",
DatabaseName = "mydb",
Engine = "aurora-mysql",
EngineVersion = "5.7.mysql_aurora.2.03.2",
MasterPassword = "bar",
MasterUsername = "foo",
PreferredBackupWindow = "07:00-09:00",
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/rds"
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := rds.NewCluster(ctx, "_default", &rds.ClusterArgs{
AvailabilityZones: pulumi.StringArray{
pulumi.String("us-west-2a"),
pulumi.String("us-west-2b"),
pulumi.String("us-west-2c"),
},
BackupRetentionPeriod: pulumi.Int(5),
ClusterIdentifier: pulumi.String("aurora-cluster-demo"),
DatabaseName: pulumi.String("mydb"),
Engine: pulumi.String("aurora-mysql"),
EngineVersion: pulumi.String("5.7.mysql_aurora.2.03.2"),
MasterPassword: pulumi.String("bar"),
MasterUsername: pulumi.String("foo"),
PreferredBackupWindow: pulumi.String("07:00-09:00"),
})
if err != nil {
return err
}
return nil
})
}import pulumi
import pulumi_aws as aws
default = aws.rds.Cluster("default",
availability_zones=[
"us-west-2a",
"us-west-2b",
"us-west-2c",
],
backup_retention_period=5,
cluster_identifier="aurora-cluster-demo",
database_name="mydb",
engine="aurora-mysql",
engine_version="5.7.mysql_aurora.2.03.2",
master_password="bar",
master_username="foo",
preferred_backup_window="07:00-09:00")import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const defaultCluster = new aws.rds.Cluster("default", {
availabilityZones: [
"us-west-2a",
"us-west-2b",
"us-west-2c",
],
backupRetentionPeriod: 5,
clusterIdentifier: "aurora-cluster-demo",
databaseName: "mydb",
engine: "aurora-mysql",
engineVersion: "5.7.mysql_aurora.2.03.2",
masterPassword: "bar",
masterUsername: "foo",
preferredBackupWindow: "07:00-09:00",
});Aurora MySQL 1.x (MySQL 5.6)
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var @default = new Aws.Rds.Cluster("default", new Aws.Rds.ClusterArgs
{
AvailabilityZones =
{
"us-west-2a",
"us-west-2b",
"us-west-2c",
},
BackupRetentionPeriod = 5,
ClusterIdentifier = "aurora-cluster-demo",
DatabaseName = "mydb",
MasterPassword = "bar",
MasterUsername = "foo",
PreferredBackupWindow = "07:00-09:00",
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/rds"
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := rds.NewCluster(ctx, "_default", &rds.ClusterArgs{
AvailabilityZones: pulumi.StringArray{
pulumi.String("us-west-2a"),
pulumi.String("us-west-2b"),
pulumi.String("us-west-2c"),
},
BackupRetentionPeriod: pulumi.Int(5),
ClusterIdentifier: pulumi.String("aurora-cluster-demo"),
DatabaseName: pulumi.String("mydb"),
MasterPassword: pulumi.String("bar"),
MasterUsername: pulumi.String("foo"),
PreferredBackupWindow: pulumi.String("07:00-09:00"),
})
if err != nil {
return err
}
return nil
})
}import pulumi
import pulumi_aws as aws
default = aws.rds.Cluster("default",
availability_zones=[
"us-west-2a",
"us-west-2b",
"us-west-2c",
],
backup_retention_period=5,
cluster_identifier="aurora-cluster-demo",
database_name="mydb",
master_password="bar",
master_username="foo",
preferred_backup_window="07:00-09:00")import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const defaultCluster = new aws.rds.Cluster("default", {
availabilityZones: [
"us-west-2a",
"us-west-2b",
"us-west-2c",
],
backupRetentionPeriod: 5,
clusterIdentifier: "aurora-cluster-demo",
databaseName: "mydb",
masterPassword: "bar",
masterUsername: "foo",
preferredBackupWindow: "07:00-09:00",
});Aurora with PostgreSQL engine
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var postgresql = new Aws.Rds.Cluster("postgresql", new Aws.Rds.ClusterArgs
{
AvailabilityZones =
{
"us-west-2a",
"us-west-2b",
"us-west-2c",
},
BackupRetentionPeriod = 5,
ClusterIdentifier = "aurora-cluster-demo",
DatabaseName = "mydb",
Engine = "aurora-postgresql",
MasterPassword = "bar",
MasterUsername = "foo",
PreferredBackupWindow = "07:00-09:00",
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/rds"
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := rds.NewCluster(ctx, "postgresql", &rds.ClusterArgs{
AvailabilityZones: pulumi.StringArray{
pulumi.String("us-west-2a"),
pulumi.String("us-west-2b"),
pulumi.String("us-west-2c"),
},
BackupRetentionPeriod: pulumi.Int(5),
ClusterIdentifier: pulumi.String("aurora-cluster-demo"),
DatabaseName: pulumi.String("mydb"),
Engine: pulumi.String("aurora-postgresql"),
MasterPassword: pulumi.String("bar"),
MasterUsername: pulumi.String("foo"),
PreferredBackupWindow: pulumi.String("07:00-09:00"),
})
if err != nil {
return err
}
return nil
})
}import pulumi
import pulumi_aws as aws
postgresql = aws.rds.Cluster("postgresql",
availability_zones=[
"us-west-2a",
"us-west-2b",
"us-west-2c",
],
backup_retention_period=5,
cluster_identifier="aurora-cluster-demo",
database_name="mydb",
engine="aurora-postgresql",
master_password="bar",
master_username="foo",
preferred_backup_window="07:00-09:00")import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const postgresql = new aws.rds.Cluster("postgresql", {
availabilityZones: [
"us-west-2a",
"us-west-2b",
"us-west-2c",
],
backupRetentionPeriod: 5,
clusterIdentifier: "aurora-cluster-demo",
databaseName: "mydb",
engine: "aurora-postgresql",
masterPassword: "bar",
masterUsername: "foo",
preferredBackupWindow: "07:00-09:00",
});Aurora Multi-Master Cluster
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var example = new Aws.Rds.Cluster("example", new Aws.Rds.ClusterArgs
{
ClusterIdentifier = "example",
DbSubnetGroupName = aws_db_subnet_group.Example.Name,
EngineMode = "multimaster",
MasterPassword = "barbarbarbar",
MasterUsername = "foo",
SkipFinalSnapshot = true,
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/rds"
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := rds.NewCluster(ctx, "example", &rds.ClusterArgs{
ClusterIdentifier: pulumi.String("example"),
DbSubnetGroupName: pulumi.String(aws_db_subnet_group.Example.Name),
EngineMode: pulumi.String("multimaster"),
MasterPassword: pulumi.String("barbarbarbar"),
MasterUsername: pulumi.String("foo"),
SkipFinalSnapshot: pulumi.Bool(true),
})
if err != nil {
return err
}
return nil
})
}import pulumi
import pulumi_aws as aws
example = aws.rds.Cluster("example",
cluster_identifier="example",
db_subnet_group_name=aws_db_subnet_group["example"]["name"],
engine_mode="multimaster",
master_password="barbarbarbar",
master_username="foo",
skip_final_snapshot=True)import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.rds.Cluster("example", {
clusterIdentifier: "example",
dbSubnetGroupName: aws_db_subnet_group_example.name,
engineMode: "multimaster",
masterPassword: "barbarbarbar",
masterUsername: "foo",
skipFinalSnapshot: true,
});Create a Cluster Resource
new Cluster(name: string, args?: ClusterArgs, opts?: CustomResourceOptions);def Cluster(resource_name, opts=None, apply_immediately=None, availability_zones=None, backtrack_window=None, backup_retention_period=None, cluster_identifier=None, cluster_identifier_prefix=None, cluster_members=None, copy_tags_to_snapshot=None, database_name=None, db_cluster_parameter_group_name=None, db_subnet_group_name=None, deletion_protection=None, enable_http_endpoint=None, enabled_cloudwatch_logs_exports=None, engine=None, engine_mode=None, engine_version=None, final_snapshot_identifier=None, global_cluster_identifier=None, iam_database_authentication_enabled=None, iam_roles=None, kms_key_id=None, master_password=None, master_username=None, port=None, preferred_backup_window=None, preferred_maintenance_window=None, replication_source_identifier=None, s3_import=None, scaling_configuration=None, skip_final_snapshot=None, snapshot_identifier=None, source_region=None, storage_encrypted=None, tags=None, vpc_security_group_ids=None, __props__=None);func NewCluster(ctx *Context, name string, args *ClusterArgs, opts ...ResourceOption) (*Cluster, error)public Cluster(string name, ClusterArgs? args = null, CustomResourceOptions? opts = null)- name string
- The unique name of the resource.
- args ClusterArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- opts ResourceOptions
- A bag of options that control this resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ClusterArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ClusterArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
Cluster Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.
Inputs
The Cluster resource accepts the following input properties:
- Apply
Immediately bool Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false. See Amazon RDS Documentation for more information.- Availability
Zones List<string> A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- Backtrack
Window int The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- Backup
Retention intPeriod The days to retain backups for. Default
1- Cluster
Identifier string The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- Cluster
Identifier stringPrefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- Cluster
Members List<string> List of RDS Instances that are a part of this cluster
- bool
Copy all Cluster
tagsto snapshots. Default isfalse.- Database
Name string Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- Db
Cluster stringParameter Group Name A cluster parameter group to associate with the cluster.
- Db
Subnet stringGroup Name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- Deletion
Protection bool If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- Enable
Http boolEndpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- Enabled
Cloudwatch List<string>Logs Exports 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,postgresql(PostgreSQL).- Engine string
The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- Engine
Mode string The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- Engine
Version string The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- Final
Snapshot stringIdentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- Global
Cluster stringIdentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- Iam
Database boolAuthentication Enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- Iam
Roles List<string> A List of ARNs for the IAM roles to associate to the RDS Cluster.
- Kms
Key stringId The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- Master
Password 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
- Master
Username string Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- Port int
The port on which the DB accepts connections
- Preferred
Backup stringWindow 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
- Preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- Replication
Source stringIdentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- S3Import
Cluster
S3Import Args - Scaling
Configuration ClusterScaling Configuration Args Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- Skip
Final boolSnapshot 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 isfalse.- Snapshot
Identifier 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.
- Source
Region string The source region for an encrypted replica DB cluster.
- Storage
Encrypted bool Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- Dictionary<string, string>
A map of tags to assign to the DB cluster.
- Vpc
Security List<string>Group Ids List of VPC security groups to associate with the Cluster
- Apply
Immediately bool Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false. See Amazon RDS Documentation for more information.- Availability
Zones []string A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- Backtrack
Window int The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- Backup
Retention intPeriod The days to retain backups for. Default
1- Cluster
Identifier string The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- Cluster
Identifier stringPrefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- Cluster
Members []string List of RDS Instances that are a part of this cluster
- bool
Copy all Cluster
tagsto snapshots. Default isfalse.- Database
Name string Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- Db
Cluster stringParameter Group Name A cluster parameter group to associate with the cluster.
- Db
Subnet stringGroup Name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- Deletion
Protection bool If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- Enable
Http boolEndpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- Enabled
Cloudwatch []stringLogs Exports 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,postgresql(PostgreSQL).- Engine string
The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- Engine
Mode string The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- Engine
Version string The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- Final
Snapshot stringIdentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- Global
Cluster stringIdentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- Iam
Database boolAuthentication Enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- Iam
Roles []string A List of ARNs for the IAM roles to associate to the RDS Cluster.
- Kms
Key stringId The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- Master
Password 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
- Master
Username string Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- Port int
The port on which the DB accepts connections
- Preferred
Backup stringWindow 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
- Preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- Replication
Source stringIdentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- S3Import
Cluster
S3Import - Scaling
Configuration ClusterScaling Configuration Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- Skip
Final boolSnapshot 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 isfalse.- Snapshot
Identifier 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.
- Source
Region string The source region for an encrypted replica DB cluster.
- Storage
Encrypted bool Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- map[string]string
A map of tags to assign to the DB cluster.
- Vpc
Security []stringGroup Ids List of VPC security groups to associate with the Cluster
- apply
Immediately 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.- availability
Zones string[] A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- backtrack
Window number The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- backup
Retention numberPeriod The days to retain backups for. Default
1- cluster
Identifier string The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- cluster
Identifier stringPrefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- cluster
Members string[] List of RDS Instances that are a part of this cluster
- boolean
Copy all Cluster
tagsto snapshots. Default isfalse.- database
Name string Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- db
Cluster stringParameter Group Name A cluster parameter group to associate with the cluster.
- db
Subnet stringGroup Name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- deletion
Protection boolean If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- enable
Http booleanEndpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- enabled
Cloudwatch string[]Logs Exports 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,postgresql(PostgreSQL).- engine
Engine
Type The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- engine
Mode EngineMode The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- engine
Version string The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- final
Snapshot stringIdentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- global
Cluster stringIdentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- iam
Database booleanAuthentication Enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- iam
Roles string[] A List of ARNs for the IAM roles to associate to the RDS Cluster.
- kms
Key stringId The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- master
Password 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
- master
Username string Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- port number
The port on which the DB accepts connections
- preferred
Backup stringWindow 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
- preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- replication
Source stringIdentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- s3Import
Cluster
S3Import - scaling
Configuration ClusterScaling Configuration Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- skip
Final booleanSnapshot 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 isfalse.- snapshot
Identifier 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.
- source
Region string The source region for an encrypted replica DB cluster.
- storage
Encrypted boolean Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- {[key: string]: string}
A map of tags to assign to the DB cluster.
- vpc
Security string[]Group Ids List of VPC security groups to associate with the Cluster
- apply_
immediately bool Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false. See Amazon RDS Documentation for more information.- availability_
zones List[str] A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- backtrack_
window float The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- backup_
retention_ floatperiod The days to retain backups for. Default
1- cluster_
identifier str The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- cluster_
identifier_ strprefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- cluster_
members List[str] List of RDS Instances that are a part of this cluster
- bool
Copy all Cluster
tagsto snapshots. Default isfalse.- database_
name str Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- db_
cluster_ strparameter_ group_ name A cluster parameter group to associate with the cluster.
- db_
subnet_ strgroup_ name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- deletion_
protection bool If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- enable_
http_ boolendpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- enabled_
cloudwatch_ List[str]logs_ exports 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,postgresql(PostgreSQL).- engine str
The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- engine_
mode str The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- engine_
version str The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- final_
snapshot_ stridentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- global_
cluster_ stridentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- iam_
database_ boolauthentication_ enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- iam_
roles List[str] A List of ARNs for the IAM roles to associate to the RDS Cluster.
- kms_
key_ strid The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- master_
password str 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
- master_
username str Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- port float
The port on which the DB accepts connections
- preferred_
backup_ strwindow 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
- preferred_
maintenance_ strwindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- replication_
source_ stridentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- s3_
import Dict[ClusterS3Import] - scaling_
configuration Dict[ClusterScaling Configuration] Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- skip_
final_ boolsnapshot 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 isfalse.- snapshot_
identifier str 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.
- source_
region str The source region for an encrypted replica DB cluster.
- storage_
encrypted bool Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- Dict[str, str]
A map of tags to assign to the DB cluster.
- vpc_
security_ List[str]group_ ids List of VPC security groups to associate with the Cluster
Outputs
All input properties are implicitly available as output properties. Additionally, the Cluster resource produces the following output properties:
- Arn string
Amazon Resource Name (ARN) of cluster
- Cluster
Resource stringId The RDS Cluster Resource ID
- Endpoint string
The DNS address of the RDS instance
- Hosted
Zone stringId The Route53 Hosted Zone ID of the endpoint
- Id string
- The provider-assigned unique ID for this managed resource.
- Reader
Endpoint string A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- Arn string
Amazon Resource Name (ARN) of cluster
- Cluster
Resource stringId The RDS Cluster Resource ID
- Endpoint string
The DNS address of the RDS instance
- Hosted
Zone stringId The Route53 Hosted Zone ID of the endpoint
- Id string
- The provider-assigned unique ID for this managed resource.
- Reader
Endpoint string A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- arn string
Amazon Resource Name (ARN) of cluster
- cluster
Resource stringId The RDS Cluster Resource ID
- endpoint string
The DNS address of the RDS instance
- hosted
Zone stringId The Route53 Hosted Zone ID of the endpoint
- id string
- The provider-assigned unique ID for this managed resource.
- reader
Endpoint string A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- arn str
Amazon Resource Name (ARN) of cluster
- cluster_
resource_ strid The RDS Cluster Resource ID
- endpoint str
The DNS address of the RDS instance
- hosted_
zone_ strid The Route53 Hosted Zone ID of the endpoint
- id str
- The provider-assigned unique ID for this managed resource.
- reader_
endpoint str A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
Look up an Existing Cluster Resource
Get an existing Cluster resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ClusterState, opts?: CustomResourceOptions): Clusterstatic get(resource_name, id, opts=None, apply_immediately=None, arn=None, availability_zones=None, backtrack_window=None, backup_retention_period=None, cluster_identifier=None, cluster_identifier_prefix=None, cluster_members=None, cluster_resource_id=None, copy_tags_to_snapshot=None, database_name=None, db_cluster_parameter_group_name=None, db_subnet_group_name=None, deletion_protection=None, enable_http_endpoint=None, enabled_cloudwatch_logs_exports=None, endpoint=None, engine=None, engine_mode=None, engine_version=None, final_snapshot_identifier=None, global_cluster_identifier=None, hosted_zone_id=None, iam_database_authentication_enabled=None, iam_roles=None, kms_key_id=None, master_password=None, master_username=None, port=None, preferred_backup_window=None, preferred_maintenance_window=None, reader_endpoint=None, replication_source_identifier=None, s3_import=None, scaling_configuration=None, skip_final_snapshot=None, snapshot_identifier=None, source_region=None, storage_encrypted=None, tags=None, vpc_security_group_ids=None, __props__=None);func GetCluster(ctx *Context, name string, id IDInput, state *ClusterState, opts ...ResourceOption) (*Cluster, error)public static Cluster Get(string name, Input<string> id, ClusterState? state, CustomResourceOptions? opts = null)- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
The following state arguments are supported:
- Apply
Immediately bool Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false. See Amazon RDS Documentation for more information.- Arn string
Amazon Resource Name (ARN) of cluster
- Availability
Zones List<string> A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- Backtrack
Window int The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- Backup
Retention intPeriod The days to retain backups for. Default
1- Cluster
Identifier string The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- Cluster
Identifier stringPrefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- Cluster
Members List<string> List of RDS Instances that are a part of this cluster
- Cluster
Resource stringId The RDS Cluster Resource ID
- bool
Copy all Cluster
tagsto snapshots. Default isfalse.- Database
Name string Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- Db
Cluster stringParameter Group Name A cluster parameter group to associate with the cluster.
- Db
Subnet stringGroup Name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- Deletion
Protection bool If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- Enable
Http boolEndpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- Enabled
Cloudwatch List<string>Logs Exports 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,postgresql(PostgreSQL).- Endpoint string
The DNS address of the RDS instance
- Engine string
The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- Engine
Mode string The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- Engine
Version string The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- Final
Snapshot stringIdentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- Global
Cluster stringIdentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- Hosted
Zone stringId The Route53 Hosted Zone ID of the endpoint
- Iam
Database boolAuthentication Enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- Iam
Roles List<string> A List of ARNs for the IAM roles to associate to the RDS Cluster.
- Kms
Key stringId The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- Master
Password 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
- Master
Username string Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- Port int
The port on which the DB accepts connections
- Preferred
Backup stringWindow 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
- Preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- Reader
Endpoint string A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- Replication
Source stringIdentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- S3Import
Cluster
S3Import Args - Scaling
Configuration ClusterScaling Configuration Args Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- Skip
Final boolSnapshot 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 isfalse.- Snapshot
Identifier 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.
- Source
Region string The source region for an encrypted replica DB cluster.
- Storage
Encrypted bool Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- Dictionary<string, string>
A map of tags to assign to the DB cluster.
- Vpc
Security List<string>Group Ids List of VPC security groups to associate with the Cluster
- Apply
Immediately bool Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false. See Amazon RDS Documentation for more information.- Arn string
Amazon Resource Name (ARN) of cluster
- Availability
Zones []string A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- Backtrack
Window int The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- Backup
Retention intPeriod The days to retain backups for. Default
1- Cluster
Identifier string The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- Cluster
Identifier stringPrefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- Cluster
Members []string List of RDS Instances that are a part of this cluster
- Cluster
Resource stringId The RDS Cluster Resource ID
- bool
Copy all Cluster
tagsto snapshots. Default isfalse.- Database
Name string Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- Db
Cluster stringParameter Group Name A cluster parameter group to associate with the cluster.
- Db
Subnet stringGroup Name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- Deletion
Protection bool If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- Enable
Http boolEndpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- Enabled
Cloudwatch []stringLogs Exports 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,postgresql(PostgreSQL).- Endpoint string
The DNS address of the RDS instance
- Engine string
The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- Engine
Mode string The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- Engine
Version string The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- Final
Snapshot stringIdentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- Global
Cluster stringIdentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- Hosted
Zone stringId The Route53 Hosted Zone ID of the endpoint
- Iam
Database boolAuthentication Enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- Iam
Roles []string A List of ARNs for the IAM roles to associate to the RDS Cluster.
- Kms
Key stringId The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- Master
Password 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
- Master
Username string Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- Port int
The port on which the DB accepts connections
- Preferred
Backup stringWindow 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
- Preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- Reader
Endpoint string A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- Replication
Source stringIdentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- S3Import
Cluster
S3Import - Scaling
Configuration ClusterScaling Configuration Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- Skip
Final boolSnapshot 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 isfalse.- Snapshot
Identifier 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.
- Source
Region string The source region for an encrypted replica DB cluster.
- Storage
Encrypted bool Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- map[string]string
A map of tags to assign to the DB cluster.
- Vpc
Security []stringGroup Ids List of VPC security groups to associate with the Cluster
- apply
Immediately 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.- arn string
Amazon Resource Name (ARN) of cluster
- availability
Zones string[] A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- backtrack
Window number The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- backup
Retention numberPeriod The days to retain backups for. Default
1- cluster
Identifier string The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- cluster
Identifier stringPrefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- cluster
Members string[] List of RDS Instances that are a part of this cluster
- cluster
Resource stringId The RDS Cluster Resource ID
- boolean
Copy all Cluster
tagsto snapshots. Default isfalse.- database
Name string Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- db
Cluster stringParameter Group Name A cluster parameter group to associate with the cluster.
- db
Subnet stringGroup Name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- deletion
Protection boolean If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- enable
Http booleanEndpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- enabled
Cloudwatch string[]Logs Exports 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,postgresql(PostgreSQL).- endpoint string
The DNS address of the RDS instance
- engine
Engine
Type The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- engine
Mode EngineMode The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- engine
Version string The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- final
Snapshot stringIdentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- global
Cluster stringIdentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- hosted
Zone stringId The Route53 Hosted Zone ID of the endpoint
- iam
Database booleanAuthentication Enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- iam
Roles string[] A List of ARNs for the IAM roles to associate to the RDS Cluster.
- kms
Key stringId The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- master
Password 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
- master
Username string Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- port number
The port on which the DB accepts connections
- preferred
Backup stringWindow 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
- preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- reader
Endpoint string A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- replication
Source stringIdentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- s3Import
Cluster
S3Import - scaling
Configuration ClusterScaling Configuration Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- skip
Final booleanSnapshot 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 isfalse.- snapshot
Identifier 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.
- source
Region string The source region for an encrypted replica DB cluster.
- storage
Encrypted boolean Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- {[key: string]: string}
A map of tags to assign to the DB cluster.
- vpc
Security string[]Group Ids List of VPC security groups to associate with the Cluster
- apply_
immediately bool Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false. See Amazon RDS Documentation for more information.- arn str
Amazon Resource Name (ARN) of cluster
- availability_
zones List[str] A list of EC2 Availability Zones for the DB cluster storage where DB cluster instances can be created. RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next provider update. It is recommended to specify 3 AZs or use the
ignoreChangesargument if necessary.- backtrack_
window float The target backtrack window, in seconds. Only available for
auroraengine currently. To disable backtracking, set this value to0. Defaults to0. Must be between0and259200(72 hours)- backup_
retention_ floatperiod The days to retain backups for. Default
1- cluster_
identifier str The cluster identifier. If omitted, this provider will assign a random, unique identifier.
- cluster_
identifier_ strprefix Creates a unique cluster identifier beginning with the specified prefix. Conflicts with
cluster_identifier.- cluster_
members List[str] List of RDS Instances that are a part of this cluster
- cluster_
resource_ strid The RDS Cluster Resource ID
- bool
Copy all Cluster
tagsto snapshots. Default isfalse.- database_
name str Name for an automatically created database on cluster creation. There are different naming restrictions per database engine: RDS Naming Constraints
- db_
cluster_ strparameter_ group_ name A cluster parameter group to associate with the cluster.
- db_
subnet_ strgroup_ name A DB subnet group to associate with this DB instance. NOTE: This must match the
db_subnet_group_namespecified on everyaws.rds.ClusterInstancein the cluster.- deletion_
protection bool If the DB instance should have deletion protection enabled. The database can’t be deleted when this value is set to
true. The default isfalse.- enable_
http_ boolendpoint Enable HTTP endpoint (data API). Only valid when
engine_modeis set toserverless.- enabled_
cloudwatch_ List[str]logs_ exports 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,postgresql(PostgreSQL).- endpoint str
The DNS address of the RDS instance
- engine str
The name of the database engine to be used for this DB cluster. Defaults to
aurora. Valid Values:aurora,aurora-mysql,aurora-postgresql- engine_
mode str The database engine mode. Valid values:
global,multimaster,parallelquery,provisioned,serverless. Defaults to:provisioned. See the RDS User Guide for limitations when usingserverless.- engine_
version str The database engine version. Updating this argument results in an outage. See the Aurora MySQL and Aurora Postgres documentation for your configured engine to determine this value. For example with Aurora MySQL 2, a potential value for this argument is
5.7.mysql_aurora.2.03.2.- final_
snapshot_ stridentifier The name of your final DB snapshot when this DB cluster is deleted. If omitted, no final snapshot will be made.
- global_
cluster_ stridentifier The global cluster identifier specified on
aws.rds.GlobalCluster.- hosted_
zone_ strid The Route53 Hosted Zone ID of the endpoint
- iam_
database_ boolauthentication_ enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled. Please see AWS Documentation for availability and limitations.
- iam_
roles List[str] A List of ARNs for the IAM roles to associate to the RDS Cluster.
- kms_
key_ strid The ARN for the KMS encryption key. When specifying
kms_key_id,storage_encryptedneeds to be set to true.- master_
password str 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
- master_
username str Username for the master DB user. Please refer to the RDS Naming Constraints. This argument does not support in-place updates and cannot be changed during a restore from snapshot.
- port float
The port on which the DB accepts connections
- preferred_
backup_ strwindow 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
- preferred_
maintenance_ strwindow The weekly time range during which system maintenance can occur, in (UTC) e.g. wed:04:00-wed:04:30
- reader_
endpoint str A read-only endpoint for the Aurora cluster, automatically load-balanced across replicas
- replication_
source_ stridentifier ARN of a source DB cluster or DB instance if this DB cluster is to be created as a Read Replica.
- s3_
import Dict[ClusterS3Import] - scaling_
configuration Dict[ClusterScaling Configuration] Nested attribute with scaling properties. Only valid when
engine_modeis set toserverless. More details below.- skip_
final_ boolsnapshot 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 isfalse.- snapshot_
identifier str 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.
- source_
region str The source region for an encrypted replica DB cluster.
- storage_
encrypted bool Specifies whether the DB cluster is encrypted. The default is
falseforprovisionedengine_modeandtrueforserverlessengine_mode.- Dict[str, str]
A map of tags to assign to the DB cluster.
- vpc_
security_ List[str]group_ ids List of VPC security groups to associate with the Cluster
Supporting Types
ClusterS3Import
- Bucket
Name string The bucket name where your backup is stored
- Ingestion
Role string Role applied to load the data.
- Source
Engine string Source engine for the backup
- Source
Engine stringVersion Version of the source engine used to make the backup
- Bucket
Prefix string Can be blank, but is the path to your backup
- Bucket
Name string The bucket name where your backup is stored
- Ingestion
Role string Role applied to load the data.
- Source
Engine string Source engine for the backup
- Source
Engine stringVersion Version of the source engine used to make the backup
- Bucket
Prefix string Can be blank, but is the path to your backup
- bucket
Name string The bucket name where your backup is stored
- ingestion
Role string Role applied to load the data.
- source
Engine string Source engine for the backup
- source
Engine stringVersion Version of the source engine used to make the backup
- bucket
Prefix string Can be blank, but is the path to your backup
- bucket_
name str The bucket name where your backup is stored
- ingestion
Role str Role applied to load the data.
- source
Engine str Source engine for the backup
- source
Engine strVersion Version of the source engine used to make the backup
- bucket_
prefix str Can be blank, but is the path to your backup
ClusterScalingConfiguration
- Auto
Pause bool Whether to enable automatic pause. A DB cluster can be paused only when it’s idle (it has no connections). If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it. Defaults to
true.- Max
Capacity int The maximum capacity. The maximum capacity must be greater than or equal to the minimum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to16.- Min
Capacity int The minimum capacity. The minimum capacity must be lesser than or equal to the maximum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to2.- Seconds
Until intAuto Pause The time, in seconds, before an Aurora DB cluster in serverless mode is paused. Valid values are
300through86400. Defaults to300.- Timeout
Action string The action to take when the timeout is reached. Valid values:
ForceApplyCapacityChange,RollbackCapacityChange. Defaults toRollbackCapacityChange. See documentation.
- Auto
Pause bool Whether to enable automatic pause. A DB cluster can be paused only when it’s idle (it has no connections). If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it. Defaults to
true.- Max
Capacity int The maximum capacity. The maximum capacity must be greater than or equal to the minimum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to16.- Min
Capacity int The minimum capacity. The minimum capacity must be lesser than or equal to the maximum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to2.- Seconds
Until intAuto Pause The time, in seconds, before an Aurora DB cluster in serverless mode is paused. Valid values are
300through86400. Defaults to300.- Timeout
Action string The action to take when the timeout is reached. Valid values:
ForceApplyCapacityChange,RollbackCapacityChange. Defaults toRollbackCapacityChange. See documentation.
- auto
Pause boolean Whether to enable automatic pause. A DB cluster can be paused only when it’s idle (it has no connections). If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it. Defaults to
true.- max
Capacity number The maximum capacity. The maximum capacity must be greater than or equal to the minimum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to16.- min
Capacity number The minimum capacity. The minimum capacity must be lesser than or equal to the maximum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to2.- seconds
Until numberAuto Pause The time, in seconds, before an Aurora DB cluster in serverless mode is paused. Valid values are
300through86400. Defaults to300.- timeout
Action string The action to take when the timeout is reached. Valid values:
ForceApplyCapacityChange,RollbackCapacityChange. Defaults toRollbackCapacityChange. See documentation.
- auto
Pause bool Whether to enable automatic pause. A DB cluster can be paused only when it’s idle (it has no connections). If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it. Defaults to
true.- max_
capacity float The maximum capacity. The maximum capacity must be greater than or equal to the minimum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to16.- min_
capacity float The minimum capacity. The minimum capacity must be lesser than or equal to the maximum capacity. Valid capacity values are
1,2,4,8,16,32,64,128, and256. Defaults to2.- seconds
Until floatAuto Pause The time, in seconds, before an Aurora DB cluster in serverless mode is paused. Valid values are
300through86400. Defaults to300.- timeout
Action str The action to take when the timeout is reached. Valid values:
ForceApplyCapacityChange,RollbackCapacityChange. Defaults toRollbackCapacityChange. See documentation.
Package Details
- Repository
- https://github.com/pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awsTerraform Provider.