aws.redshift.Cluster
Explore with Pulumi AI
Provides a Redshift Cluster Resource.
NOTE: A Redshift cluster’s default IAM role can be managed both by this resource’s
default_iam_role_arn
argument and theaws.redshift.ClusterIamRoles
resource’sdefault_iam_role_arn
argument. Do not configure different values for both arguments. Doing so will cause a conflict of default IAM roles.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.redshift.Cluster("example", {
clusterIdentifier: "tf-redshift-cluster",
databaseName: "mydb",
masterUsername: "exampleuser",
masterPassword: "Mustbe8characters",
nodeType: "dc1.large",
clusterType: "single-node",
});
import pulumi
import pulumi_aws as aws
example = aws.redshift.Cluster("example",
cluster_identifier="tf-redshift-cluster",
database_name="mydb",
master_username="exampleuser",
master_password="Mustbe8characters",
node_type="dc1.large",
cluster_type="single-node")
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/redshift"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := redshift.NewCluster(ctx, "example", &redshift.ClusterArgs{
ClusterIdentifier: pulumi.String("tf-redshift-cluster"),
DatabaseName: pulumi.String("mydb"),
MasterUsername: pulumi.String("exampleuser"),
MasterPassword: pulumi.String("Mustbe8characters"),
NodeType: pulumi.String("dc1.large"),
ClusterType: pulumi.String("single-node"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.RedShift.Cluster("example", new()
{
ClusterIdentifier = "tf-redshift-cluster",
DatabaseName = "mydb",
MasterUsername = "exampleuser",
MasterPassword = "Mustbe8characters",
NodeType = "dc1.large",
ClusterType = "single-node",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.redshift.Cluster;
import com.pulumi.aws.redshift.ClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new Cluster("example", ClusterArgs.builder()
.clusterIdentifier("tf-redshift-cluster")
.databaseName("mydb")
.masterUsername("exampleuser")
.masterPassword("Mustbe8characters")
.nodeType("dc1.large")
.clusterType("single-node")
.build());
}
}
resources:
example:
type: aws:redshift:Cluster
properties:
clusterIdentifier: tf-redshift-cluster
databaseName: mydb
masterUsername: exampleuser
masterPassword: Mustbe8characters
nodeType: dc1.large
clusterType: single-node
With Managed Credentials
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.redshift.Cluster("example", {
clusterIdentifier: "tf-redshift-cluster",
databaseName: "mydb",
masterUsername: "exampleuser",
nodeType: "dc1.large",
clusterType: "single-node",
manageMasterPassword: true,
});
import pulumi
import pulumi_aws as aws
example = aws.redshift.Cluster("example",
cluster_identifier="tf-redshift-cluster",
database_name="mydb",
master_username="exampleuser",
node_type="dc1.large",
cluster_type="single-node",
manage_master_password=True)
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/redshift"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := redshift.NewCluster(ctx, "example", &redshift.ClusterArgs{
ClusterIdentifier: pulumi.String("tf-redshift-cluster"),
DatabaseName: pulumi.String("mydb"),
MasterUsername: pulumi.String("exampleuser"),
NodeType: pulumi.String("dc1.large"),
ClusterType: pulumi.String("single-node"),
ManageMasterPassword: pulumi.Bool(true),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.RedShift.Cluster("example", new()
{
ClusterIdentifier = "tf-redshift-cluster",
DatabaseName = "mydb",
MasterUsername = "exampleuser",
NodeType = "dc1.large",
ClusterType = "single-node",
ManageMasterPassword = true,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.redshift.Cluster;
import com.pulumi.aws.redshift.ClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new Cluster("example", ClusterArgs.builder()
.clusterIdentifier("tf-redshift-cluster")
.databaseName("mydb")
.masterUsername("exampleuser")
.nodeType("dc1.large")
.clusterType("single-node")
.manageMasterPassword(true)
.build());
}
}
resources:
example:
type: aws:redshift:Cluster
properties:
clusterIdentifier: tf-redshift-cluster
databaseName: mydb
masterUsername: exampleuser
nodeType: dc1.large
clusterType: single-node
manageMasterPassword: true
Create Cluster Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Cluster(name: string, args: ClusterArgs, opts?: CustomResourceOptions);
@overload
def Cluster(resource_name: str,
args: ClusterArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Cluster(resource_name: str,
opts: Optional[ResourceOptions] = None,
cluster_identifier: Optional[str] = None,
node_type: Optional[str] = None,
cluster_subnet_group_name: Optional[str] = None,
cluster_revision_number: Optional[str] = None,
availability_zone: Optional[str] = None,
logging: Optional[ClusterLoggingArgs] = None,
aqua_configuration_status: Optional[str] = None,
manage_master_password: Optional[bool] = None,
cluster_public_key: Optional[str] = None,
maintenance_track_name: Optional[str] = None,
allow_version_upgrade: Optional[bool] = None,
cluster_type: Optional[str] = None,
cluster_version: Optional[str] = None,
database_name: Optional[str] = None,
default_iam_role_arn: Optional[str] = None,
elastic_ip: Optional[str] = None,
encrypted: Optional[bool] = None,
endpoint: Optional[str] = None,
enhanced_vpc_routing: Optional[bool] = None,
final_snapshot_identifier: Optional[str] = None,
iam_roles: Optional[Sequence[str]] = None,
kms_key_id: Optional[str] = None,
availability_zone_relocation_enabled: Optional[bool] = None,
automated_snapshot_retention_period: Optional[int] = None,
cluster_parameter_group_name: Optional[str] = None,
manual_snapshot_retention_period: Optional[int] = None,
master_password: Optional[str] = None,
master_password_secret_kms_key_id: Optional[str] = None,
master_username: Optional[str] = None,
multi_az: Optional[bool] = None,
apply_immediately: Optional[bool] = None,
number_of_nodes: Optional[int] = None,
owner_account: Optional[str] = None,
port: Optional[int] = None,
preferred_maintenance_window: Optional[str] = None,
publicly_accessible: Optional[bool] = None,
skip_final_snapshot: Optional[bool] = None,
snapshot_arn: Optional[str] = None,
snapshot_cluster_identifier: Optional[str] = None,
snapshot_copy: Optional[ClusterSnapshotCopyArgs] = None,
snapshot_identifier: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
vpc_security_group_ids: Optional[Sequence[str]] = None)
func NewCluster(ctx *Context, name string, args ClusterArgs, opts ...ResourceOption) (*Cluster, error)
public Cluster(string name, ClusterArgs args, CustomResourceOptions? opts = null)
public Cluster(String name, ClusterArgs args)
public Cluster(String name, ClusterArgs args, CustomResourceOptions options)
type: aws:redshift:Cluster
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- 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.
- args ClusterArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control 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.
- name String
- The unique name of the resource.
- args ClusterArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var exampleclusterResourceResourceFromRedshiftcluster = new Aws.RedShift.Cluster("exampleclusterResourceResourceFromRedshiftcluster", new()
{
ClusterIdentifier = "string",
NodeType = "string",
ClusterSubnetGroupName = "string",
ClusterRevisionNumber = "string",
AvailabilityZone = "string",
ManageMasterPassword = false,
ClusterPublicKey = "string",
MaintenanceTrackName = "string",
AllowVersionUpgrade = false,
ClusterType = "string",
ClusterVersion = "string",
DatabaseName = "string",
DefaultIamRoleArn = "string",
ElasticIp = "string",
Encrypted = false,
Endpoint = "string",
EnhancedVpcRouting = false,
FinalSnapshotIdentifier = "string",
IamRoles = new[]
{
"string",
},
KmsKeyId = "string",
AvailabilityZoneRelocationEnabled = false,
AutomatedSnapshotRetentionPeriod = 0,
ClusterParameterGroupName = "string",
ManualSnapshotRetentionPeriod = 0,
MasterPassword = "string",
MasterPasswordSecretKmsKeyId = "string",
MasterUsername = "string",
MultiAz = false,
ApplyImmediately = false,
NumberOfNodes = 0,
OwnerAccount = "string",
Port = 0,
PreferredMaintenanceWindow = "string",
PubliclyAccessible = false,
SkipFinalSnapshot = false,
SnapshotArn = "string",
SnapshotClusterIdentifier = "string",
SnapshotIdentifier = "string",
Tags =
{
{ "string", "string" },
},
VpcSecurityGroupIds = new[]
{
"string",
},
});
example, err := redshift.NewCluster(ctx, "exampleclusterResourceResourceFromRedshiftcluster", &redshift.ClusterArgs{
ClusterIdentifier: pulumi.String("string"),
NodeType: pulumi.String("string"),
ClusterSubnetGroupName: pulumi.String("string"),
ClusterRevisionNumber: pulumi.String("string"),
AvailabilityZone: pulumi.String("string"),
ManageMasterPassword: pulumi.Bool(false),
ClusterPublicKey: pulumi.String("string"),
MaintenanceTrackName: pulumi.String("string"),
AllowVersionUpgrade: pulumi.Bool(false),
ClusterType: pulumi.String("string"),
ClusterVersion: pulumi.String("string"),
DatabaseName: pulumi.String("string"),
DefaultIamRoleArn: pulumi.String("string"),
ElasticIp: pulumi.String("string"),
Encrypted: pulumi.Bool(false),
Endpoint: pulumi.String("string"),
EnhancedVpcRouting: pulumi.Bool(false),
FinalSnapshotIdentifier: pulumi.String("string"),
IamRoles: pulumi.StringArray{
pulumi.String("string"),
},
KmsKeyId: pulumi.String("string"),
AvailabilityZoneRelocationEnabled: pulumi.Bool(false),
AutomatedSnapshotRetentionPeriod: pulumi.Int(0),
ClusterParameterGroupName: pulumi.String("string"),
ManualSnapshotRetentionPeriod: pulumi.Int(0),
MasterPassword: pulumi.String("string"),
MasterPasswordSecretKmsKeyId: pulumi.String("string"),
MasterUsername: pulumi.String("string"),
MultiAz: pulumi.Bool(false),
ApplyImmediately: pulumi.Bool(false),
NumberOfNodes: pulumi.Int(0),
OwnerAccount: pulumi.String("string"),
Port: pulumi.Int(0),
PreferredMaintenanceWindow: pulumi.String("string"),
PubliclyAccessible: pulumi.Bool(false),
SkipFinalSnapshot: pulumi.Bool(false),
SnapshotArn: pulumi.String("string"),
SnapshotClusterIdentifier: pulumi.String("string"),
SnapshotIdentifier: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
VpcSecurityGroupIds: pulumi.StringArray{
pulumi.String("string"),
},
})
var exampleclusterResourceResourceFromRedshiftcluster = new Cluster("exampleclusterResourceResourceFromRedshiftcluster", ClusterArgs.builder()
.clusterIdentifier("string")
.nodeType("string")
.clusterSubnetGroupName("string")
.clusterRevisionNumber("string")
.availabilityZone("string")
.manageMasterPassword(false)
.clusterPublicKey("string")
.maintenanceTrackName("string")
.allowVersionUpgrade(false)
.clusterType("string")
.clusterVersion("string")
.databaseName("string")
.defaultIamRoleArn("string")
.elasticIp("string")
.encrypted(false)
.endpoint("string")
.enhancedVpcRouting(false)
.finalSnapshotIdentifier("string")
.iamRoles("string")
.kmsKeyId("string")
.availabilityZoneRelocationEnabled(false)
.automatedSnapshotRetentionPeriod(0)
.clusterParameterGroupName("string")
.manualSnapshotRetentionPeriod(0)
.masterPassword("string")
.masterPasswordSecretKmsKeyId("string")
.masterUsername("string")
.multiAz(false)
.applyImmediately(false)
.numberOfNodes(0)
.ownerAccount("string")
.port(0)
.preferredMaintenanceWindow("string")
.publiclyAccessible(false)
.skipFinalSnapshot(false)
.snapshotArn("string")
.snapshotClusterIdentifier("string")
.snapshotIdentifier("string")
.tags(Map.of("string", "string"))
.vpcSecurityGroupIds("string")
.build());
examplecluster_resource_resource_from_redshiftcluster = aws.redshift.Cluster("exampleclusterResourceResourceFromRedshiftcluster",
cluster_identifier="string",
node_type="string",
cluster_subnet_group_name="string",
cluster_revision_number="string",
availability_zone="string",
manage_master_password=False,
cluster_public_key="string",
maintenance_track_name="string",
allow_version_upgrade=False,
cluster_type="string",
cluster_version="string",
database_name="string",
default_iam_role_arn="string",
elastic_ip="string",
encrypted=False,
endpoint="string",
enhanced_vpc_routing=False,
final_snapshot_identifier="string",
iam_roles=["string"],
kms_key_id="string",
availability_zone_relocation_enabled=False,
automated_snapshot_retention_period=0,
cluster_parameter_group_name="string",
manual_snapshot_retention_period=0,
master_password="string",
master_password_secret_kms_key_id="string",
master_username="string",
multi_az=False,
apply_immediately=False,
number_of_nodes=0,
owner_account="string",
port=0,
preferred_maintenance_window="string",
publicly_accessible=False,
skip_final_snapshot=False,
snapshot_arn="string",
snapshot_cluster_identifier="string",
snapshot_identifier="string",
tags={
"string": "string",
},
vpc_security_group_ids=["string"])
const exampleclusterResourceResourceFromRedshiftcluster = new aws.redshift.Cluster("exampleclusterResourceResourceFromRedshiftcluster", {
clusterIdentifier: "string",
nodeType: "string",
clusterSubnetGroupName: "string",
clusterRevisionNumber: "string",
availabilityZone: "string",
manageMasterPassword: false,
clusterPublicKey: "string",
maintenanceTrackName: "string",
allowVersionUpgrade: false,
clusterType: "string",
clusterVersion: "string",
databaseName: "string",
defaultIamRoleArn: "string",
elasticIp: "string",
encrypted: false,
endpoint: "string",
enhancedVpcRouting: false,
finalSnapshotIdentifier: "string",
iamRoles: ["string"],
kmsKeyId: "string",
availabilityZoneRelocationEnabled: false,
automatedSnapshotRetentionPeriod: 0,
clusterParameterGroupName: "string",
manualSnapshotRetentionPeriod: 0,
masterPassword: "string",
masterPasswordSecretKmsKeyId: "string",
masterUsername: "string",
multiAz: false,
applyImmediately: false,
numberOfNodes: 0,
ownerAccount: "string",
port: 0,
preferredMaintenanceWindow: "string",
publiclyAccessible: false,
skipFinalSnapshot: false,
snapshotArn: "string",
snapshotClusterIdentifier: "string",
snapshotIdentifier: "string",
tags: {
string: "string",
},
vpcSecurityGroupIds: ["string"],
});
type: aws:redshift:Cluster
properties:
allowVersionUpgrade: false
applyImmediately: false
automatedSnapshotRetentionPeriod: 0
availabilityZone: string
availabilityZoneRelocationEnabled: false
clusterIdentifier: string
clusterParameterGroupName: string
clusterPublicKey: string
clusterRevisionNumber: string
clusterSubnetGroupName: string
clusterType: string
clusterVersion: string
databaseName: string
defaultIamRoleArn: string
elasticIp: string
encrypted: false
endpoint: string
enhancedVpcRouting: false
finalSnapshotIdentifier: string
iamRoles:
- string
kmsKeyId: string
maintenanceTrackName: string
manageMasterPassword: false
manualSnapshotRetentionPeriod: 0
masterPassword: string
masterPasswordSecretKmsKeyId: string
masterUsername: string
multiAz: false
nodeType: string
numberOfNodes: 0
ownerAccount: string
port: 0
preferredMaintenanceWindow: string
publiclyAccessible: false
skipFinalSnapshot: false
snapshotArn: string
snapshotClusterIdentifier: string
snapshotIdentifier: string
tags:
string: string
vpcSecurityGroupIds:
- string
Cluster Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Cluster resource accepts the following input properties:
- Cluster
Identifier string - The Cluster Identifier. Must be a lower case string.
- Node
Type string - The node type to be provisioned for the cluster.
- Allow
Version boolUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - Apply
Immediately bool - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - Aqua
Configuration stringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - Automated
Snapshot intRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- Availability
Zone string - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - Availability
Zone boolRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - Cluster
Parameter stringGroup Name - The name of the parameter group to be associated with this cluster.
- Cluster
Public stringKey - The public key for the cluster
- Cluster
Revision stringNumber - The specific revision number of the database in the cluster
- Cluster
Subnet stringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- Cluster
Type string - The cluster type to use. Either
single-node
ormulti-node
. - Cluster
Version string - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- Database
Name string - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - Default
Iam stringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- Elastic
Ip string - The Elastic IP (EIP) address for the cluster.
- Encrypted bool
- If true , the data in the cluster is encrypted at rest.
- Endpoint string
- The connection endpoint
- Enhanced
Vpc boolRouting - If true , enhanced VPC routing is enabled.
- Final
Snapshot stringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - Iam
Roles List<string> - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- Kms
Key stringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - Logging
Cluster
Logging - Logging, documented below.
- Maintenance
Track stringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - Manage
Master boolPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - Manual
Snapshot intRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - Master
Password string - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - Master
Password stringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- Master
Username string - Username for the master DB user.
- Multi
Az bool - Specifies if the Redshift cluster is multi-AZ.
- Number
Of intNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- Owner
Account string - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- Port int
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - Preferred
Maintenance stringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- Publicly
Accessible bool - If true, the cluster can be accessed from a public network. Default is
true
. - Skip
Final boolSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- Snapshot
Arn string - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - Snapshot
Cluster stringIdentifier - The name of the cluster the source snapshot was created from.
- Snapshot
Copy ClusterSnapshot Copy - Configuration of automatic copy of snapshots from one region to another. Documented below.
- Snapshot
Identifier string - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Dictionary<string, string>
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Vpc
Security List<string>Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- Cluster
Identifier string - The Cluster Identifier. Must be a lower case string.
- Node
Type string - The node type to be provisioned for the cluster.
- Allow
Version boolUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - Apply
Immediately bool - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - Aqua
Configuration stringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - Automated
Snapshot intRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- Availability
Zone string - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - Availability
Zone boolRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - Cluster
Parameter stringGroup Name - The name of the parameter group to be associated with this cluster.
- Cluster
Public stringKey - The public key for the cluster
- Cluster
Revision stringNumber - The specific revision number of the database in the cluster
- Cluster
Subnet stringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- Cluster
Type string - The cluster type to use. Either
single-node
ormulti-node
. - Cluster
Version string - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- Database
Name string - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - Default
Iam stringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- Elastic
Ip string - The Elastic IP (EIP) address for the cluster.
- Encrypted bool
- If true , the data in the cluster is encrypted at rest.
- Endpoint string
- The connection endpoint
- Enhanced
Vpc boolRouting - If true , enhanced VPC routing is enabled.
- Final
Snapshot stringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - Iam
Roles []string - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- Kms
Key stringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - Logging
Cluster
Logging Args - Logging, documented below.
- Maintenance
Track stringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - Manage
Master boolPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - Manual
Snapshot intRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - Master
Password string - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - Master
Password stringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- Master
Username string - Username for the master DB user.
- Multi
Az bool - Specifies if the Redshift cluster is multi-AZ.
- Number
Of intNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- Owner
Account string - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- Port int
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - Preferred
Maintenance stringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- Publicly
Accessible bool - If true, the cluster can be accessed from a public network. Default is
true
. - Skip
Final boolSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- Snapshot
Arn string - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - Snapshot
Cluster stringIdentifier - The name of the cluster the source snapshot was created from.
- Snapshot
Copy ClusterSnapshot Copy Args - Configuration of automatic copy of snapshots from one region to another. Documented below.
- Snapshot
Identifier string - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - map[string]string
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Vpc
Security []stringGroup Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- cluster
Identifier String - The Cluster Identifier. Must be a lower case string.
- node
Type String - The node type to be provisioned for the cluster.
- allow
Version BooleanUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply
Immediately Boolean - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua
Configuration StringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - automated
Snapshot IntegerRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability
Zone String - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability
Zone BooleanRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster
Parameter StringGroup Name - The name of the parameter group to be associated with this cluster.
- cluster
Public StringKey - The public key for the cluster
- cluster
Revision StringNumber - The specific revision number of the database in the cluster
- cluster
Subnet StringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster
Type String - The cluster type to use. Either
single-node
ormulti-node
. - cluster
Version String - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database
Name String - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default
Iam StringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- elastic
Ip String - The Elastic IP (EIP) address for the cluster.
- encrypted Boolean
- If true , the data in the cluster is encrypted at rest.
- endpoint String
- The connection endpoint
- enhanced
Vpc BooleanRouting - If true , enhanced VPC routing is enabled.
- final
Snapshot StringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam
Roles List<String> - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms
Key StringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging
Cluster
Logging - Logging, documented below.
- maintenance
Track StringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage
Master BooleanPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual
Snapshot IntegerRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master
Password String - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master
Password StringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master
Username String - Username for the master DB user.
- multi
Az Boolean - Specifies if the Redshift cluster is multi-AZ.
- number
Of IntegerNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner
Account String - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port Integer
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred
Maintenance StringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly
Accessible Boolean - If true, the cluster can be accessed from a public network. Default is
true
. - skip
Final BooleanSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot
Arn String - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot
Cluster StringIdentifier - The name of the cluster the source snapshot was created from.
- snapshot
Copy ClusterSnapshot Copy - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot
Identifier String - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Map<String,String>
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - vpc
Security List<String>Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- cluster
Identifier string - The Cluster Identifier. Must be a lower case string.
- node
Type string - The node type to be provisioned for the cluster.
- allow
Version booleanUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply
Immediately boolean - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua
Configuration stringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - automated
Snapshot numberRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability
Zone string - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability
Zone booleanRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster
Parameter stringGroup Name - The name of the parameter group to be associated with this cluster.
- cluster
Public stringKey - The public key for the cluster
- cluster
Revision stringNumber - The specific revision number of the database in the cluster
- cluster
Subnet stringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster
Type string - The cluster type to use. Either
single-node
ormulti-node
. - cluster
Version string - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database
Name string - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default
Iam stringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- elastic
Ip string - The Elastic IP (EIP) address for the cluster.
- encrypted boolean
- If true , the data in the cluster is encrypted at rest.
- endpoint string
- The connection endpoint
- enhanced
Vpc booleanRouting - If true , enhanced VPC routing is enabled.
- final
Snapshot stringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam
Roles string[] - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms
Key stringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging
Cluster
Logging - Logging, documented below.
- maintenance
Track stringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage
Master booleanPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual
Snapshot numberRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master
Password string - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master
Password stringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master
Username string - Username for the master DB user.
- multi
Az boolean - Specifies if the Redshift cluster is multi-AZ.
- number
Of numberNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner
Account string - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port number
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred
Maintenance stringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly
Accessible boolean - If true, the cluster can be accessed from a public network. Default is
true
. - skip
Final booleanSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot
Arn string - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot
Cluster stringIdentifier - The name of the cluster the source snapshot was created from.
- snapshot
Copy ClusterSnapshot Copy - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot
Identifier string - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - {[key: string]: string}
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - vpc
Security string[]Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- cluster_
identifier str - The Cluster Identifier. Must be a lower case string.
- node_
type str - The node type to be provisioned for the cluster.
- allow_
version_ boolupgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply_
immediately bool - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua_
configuration_ strstatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - automated_
snapshot_ intretention_ period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability_
zone str - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability_
zone_ boolrelocation_ enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster_
parameter_ strgroup_ name - The name of the parameter group to be associated with this cluster.
- cluster_
public_ strkey - The public key for the cluster
- cluster_
revision_ strnumber - The specific revision number of the database in the cluster
- cluster_
subnet_ strgroup_ name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster_
type str - The cluster type to use. Either
single-node
ormulti-node
. - cluster_
version str - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database_
name str - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default_
iam_ strrole_ arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- elastic_
ip str - The Elastic IP (EIP) address for the cluster.
- encrypted bool
- If true , the data in the cluster is encrypted at rest.
- endpoint str
- The connection endpoint
- enhanced_
vpc_ boolrouting - If true , enhanced VPC routing is enabled.
- final_
snapshot_ stridentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam_
roles Sequence[str] - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms_
key_ strid - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging
Cluster
Logging Args - Logging, documented below.
- maintenance_
track_ strname - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage_
master_ boolpassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual_
snapshot_ intretention_ period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master_
password str - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master_
password_ strsecret_ kms_ key_ id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master_
username str - Username for the master DB user.
- multi_
az bool - Specifies if the Redshift cluster is multi-AZ.
- number_
of_ intnodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner_
account str - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port int
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred_
maintenance_ strwindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly_
accessible bool - If true, the cluster can be accessed from a public network. Default is
true
. - skip_
final_ boolsnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot_
arn str - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot_
cluster_ stridentifier - The name of the cluster the source snapshot was created from.
- snapshot_
copy ClusterSnapshot Copy Args - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot_
identifier str - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Mapping[str, str]
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - vpc_
security_ Sequence[str]group_ ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- cluster
Identifier String - The Cluster Identifier. Must be a lower case string.
- node
Type String - The node type to be provisioned for the cluster.
- allow
Version BooleanUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply
Immediately Boolean - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua
Configuration StringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - automated
Snapshot NumberRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability
Zone String - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability
Zone BooleanRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster
Parameter StringGroup Name - The name of the parameter group to be associated with this cluster.
- cluster
Public StringKey - The public key for the cluster
- cluster
Revision StringNumber - The specific revision number of the database in the cluster
- cluster
Subnet StringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster
Type String - The cluster type to use. Either
single-node
ormulti-node
. - cluster
Version String - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database
Name String - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default
Iam StringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- elastic
Ip String - The Elastic IP (EIP) address for the cluster.
- encrypted Boolean
- If true , the data in the cluster is encrypted at rest.
- endpoint String
- The connection endpoint
- enhanced
Vpc BooleanRouting - If true , enhanced VPC routing is enabled.
- final
Snapshot StringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam
Roles List<String> - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms
Key StringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging Property Map
- Logging, documented below.
- maintenance
Track StringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage
Master BooleanPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual
Snapshot NumberRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master
Password String - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master
Password StringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master
Username String - Username for the master DB user.
- multi
Az Boolean - Specifies if the Redshift cluster is multi-AZ.
- number
Of NumberNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner
Account String - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port Number
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred
Maintenance StringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly
Accessible Boolean - If true, the cluster can be accessed from a public network. Default is
true
. - skip
Final BooleanSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot
Arn String - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot
Cluster StringIdentifier - The name of the cluster the source snapshot was created from.
- snapshot
Copy Property Map - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot
Identifier String - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Map<String>
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - vpc
Security List<String>Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated 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
Namespace stringArn - The namespace Amazon Resource Name (ARN) of the cluster
- Cluster
Nodes List<ClusterCluster Node> - The nodes in the cluster. Cluster node blocks are documented below
- Dns
Name string - The DNS name of the cluster
- Id string
- The provider-assigned unique ID for this managed resource.
- Master
Password stringSecret Arn - ARN of the cluster admin credentials secret
- Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- Arn string
- Amazon Resource Name (ARN) of cluster
- Cluster
Namespace stringArn - The namespace Amazon Resource Name (ARN) of the cluster
- Cluster
Nodes []ClusterCluster Node - The nodes in the cluster. Cluster node blocks are documented below
- Dns
Name string - The DNS name of the cluster
- Id string
- The provider-assigned unique ID for this managed resource.
- Master
Password stringSecret Arn - ARN of the cluster admin credentials secret
- map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
- Amazon Resource Name (ARN) of cluster
- cluster
Namespace StringArn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster
Nodes List<ClusterCluster Node> - The nodes in the cluster. Cluster node blocks are documented below
- dns
Name String - The DNS name of the cluster
- id String
- The provider-assigned unique ID for this managed resource.
- master
Password StringSecret Arn - ARN of the cluster admin credentials secret
- Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn string
- Amazon Resource Name (ARN) of cluster
- cluster
Namespace stringArn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster
Nodes ClusterCluster Node[] - The nodes in the cluster. Cluster node blocks are documented below
- dns
Name string - The DNS name of the cluster
- id string
- The provider-assigned unique ID for this managed resource.
- master
Password stringSecret Arn - ARN of the cluster admin credentials secret
- {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn str
- Amazon Resource Name (ARN) of cluster
- cluster_
namespace_ strarn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster_
nodes Sequence[ClusterCluster Node] - The nodes in the cluster. Cluster node blocks are documented below
- dns_
name str - The DNS name of the cluster
- id str
- The provider-assigned unique ID for this managed resource.
- master_
password_ strsecret_ arn - ARN of the cluster admin credentials secret
- Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
- Amazon Resource Name (ARN) of cluster
- cluster
Namespace StringArn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster
Nodes List<Property Map> - The nodes in the cluster. Cluster node blocks are documented below
- dns
Name String - The DNS name of the cluster
- id String
- The provider-assigned unique ID for this managed resource.
- master
Password StringSecret Arn - ARN of the cluster admin credentials secret
- Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
Look up 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): Cluster
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
allow_version_upgrade: Optional[bool] = None,
apply_immediately: Optional[bool] = None,
aqua_configuration_status: Optional[str] = None,
arn: Optional[str] = None,
automated_snapshot_retention_period: Optional[int] = None,
availability_zone: Optional[str] = None,
availability_zone_relocation_enabled: Optional[bool] = None,
cluster_identifier: Optional[str] = None,
cluster_namespace_arn: Optional[str] = None,
cluster_nodes: Optional[Sequence[ClusterClusterNodeArgs]] = None,
cluster_parameter_group_name: Optional[str] = None,
cluster_public_key: Optional[str] = None,
cluster_revision_number: Optional[str] = None,
cluster_subnet_group_name: Optional[str] = None,
cluster_type: Optional[str] = None,
cluster_version: Optional[str] = None,
database_name: Optional[str] = None,
default_iam_role_arn: Optional[str] = None,
dns_name: Optional[str] = None,
elastic_ip: Optional[str] = None,
encrypted: Optional[bool] = None,
endpoint: Optional[str] = None,
enhanced_vpc_routing: Optional[bool] = None,
final_snapshot_identifier: Optional[str] = None,
iam_roles: Optional[Sequence[str]] = None,
kms_key_id: Optional[str] = None,
logging: Optional[ClusterLoggingArgs] = None,
maintenance_track_name: Optional[str] = None,
manage_master_password: Optional[bool] = None,
manual_snapshot_retention_period: Optional[int] = None,
master_password: Optional[str] = None,
master_password_secret_arn: Optional[str] = None,
master_password_secret_kms_key_id: Optional[str] = None,
master_username: Optional[str] = None,
multi_az: Optional[bool] = None,
node_type: Optional[str] = None,
number_of_nodes: Optional[int] = None,
owner_account: Optional[str] = None,
port: Optional[int] = None,
preferred_maintenance_window: Optional[str] = None,
publicly_accessible: Optional[bool] = None,
skip_final_snapshot: Optional[bool] = None,
snapshot_arn: Optional[str] = None,
snapshot_cluster_identifier: Optional[str] = None,
snapshot_copy: Optional[ClusterSnapshotCopyArgs] = None,
snapshot_identifier: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
vpc_security_group_ids: Optional[Sequence[str]] = None) -> Cluster
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)
public static Cluster get(String name, Output<String> id, ClusterState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- 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.
- Allow
Version boolUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - Apply
Immediately bool - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - Aqua
Configuration stringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - Arn string
- Amazon Resource Name (ARN) of cluster
- Automated
Snapshot intRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- Availability
Zone string - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - Availability
Zone boolRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - Cluster
Identifier string - The Cluster Identifier. Must be a lower case string.
- Cluster
Namespace stringArn - The namespace Amazon Resource Name (ARN) of the cluster
- Cluster
Nodes List<ClusterCluster Node> - The nodes in the cluster. Cluster node blocks are documented below
- Cluster
Parameter stringGroup Name - The name of the parameter group to be associated with this cluster.
- Cluster
Public stringKey - The public key for the cluster
- Cluster
Revision stringNumber - The specific revision number of the database in the cluster
- Cluster
Subnet stringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- Cluster
Type string - The cluster type to use. Either
single-node
ormulti-node
. - Cluster
Version string - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- Database
Name string - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - Default
Iam stringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- Dns
Name string - The DNS name of the cluster
- Elastic
Ip string - The Elastic IP (EIP) address for the cluster.
- Encrypted bool
- If true , the data in the cluster is encrypted at rest.
- Endpoint string
- The connection endpoint
- Enhanced
Vpc boolRouting - If true , enhanced VPC routing is enabled.
- Final
Snapshot stringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - Iam
Roles List<string> - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- Kms
Key stringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - Logging
Cluster
Logging - Logging, documented below.
- Maintenance
Track stringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - Manage
Master boolPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - Manual
Snapshot intRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - Master
Password string - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - Master
Password stringSecret Arn - ARN of the cluster admin credentials secret
- Master
Password stringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- Master
Username string - Username for the master DB user.
- Multi
Az bool - Specifies if the Redshift cluster is multi-AZ.
- Node
Type string - The node type to be provisioned for the cluster.
- Number
Of intNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- Owner
Account string - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- Port int
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - Preferred
Maintenance stringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- Publicly
Accessible bool - If true, the cluster can be accessed from a public network. Default is
true
. - Skip
Final boolSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- Snapshot
Arn string - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - Snapshot
Cluster stringIdentifier - The name of the cluster the source snapshot was created from.
- Snapshot
Copy ClusterSnapshot Copy - Configuration of automatic copy of snapshots from one region to another. Documented below.
- Snapshot
Identifier string - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Dictionary<string, string>
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - Vpc
Security List<string>Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- Allow
Version boolUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - Apply
Immediately bool - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - Aqua
Configuration stringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - Arn string
- Amazon Resource Name (ARN) of cluster
- Automated
Snapshot intRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- Availability
Zone string - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - Availability
Zone boolRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - Cluster
Identifier string - The Cluster Identifier. Must be a lower case string.
- Cluster
Namespace stringArn - The namespace Amazon Resource Name (ARN) of the cluster
- Cluster
Nodes []ClusterCluster Node Args - The nodes in the cluster. Cluster node blocks are documented below
- Cluster
Parameter stringGroup Name - The name of the parameter group to be associated with this cluster.
- Cluster
Public stringKey - The public key for the cluster
- Cluster
Revision stringNumber - The specific revision number of the database in the cluster
- Cluster
Subnet stringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- Cluster
Type string - The cluster type to use. Either
single-node
ormulti-node
. - Cluster
Version string - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- Database
Name string - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - Default
Iam stringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- Dns
Name string - The DNS name of the cluster
- Elastic
Ip string - The Elastic IP (EIP) address for the cluster.
- Encrypted bool
- If true , the data in the cluster is encrypted at rest.
- Endpoint string
- The connection endpoint
- Enhanced
Vpc boolRouting - If true , enhanced VPC routing is enabled.
- Final
Snapshot stringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - Iam
Roles []string - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- Kms
Key stringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - Logging
Cluster
Logging Args - Logging, documented below.
- Maintenance
Track stringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - Manage
Master boolPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - Manual
Snapshot intRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - Master
Password string - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - Master
Password stringSecret Arn - ARN of the cluster admin credentials secret
- Master
Password stringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- Master
Username string - Username for the master DB user.
- Multi
Az bool - Specifies if the Redshift cluster is multi-AZ.
- Node
Type string - The node type to be provisioned for the cluster.
- Number
Of intNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- Owner
Account string - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- Port int
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - Preferred
Maintenance stringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- Publicly
Accessible bool - If true, the cluster can be accessed from a public network. Default is
true
. - Skip
Final boolSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- Snapshot
Arn string - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - Snapshot
Cluster stringIdentifier - The name of the cluster the source snapshot was created from.
- Snapshot
Copy ClusterSnapshot Copy Args - Configuration of automatic copy of snapshots from one region to another. Documented below.
- Snapshot
Identifier string - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - map[string]string
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - Vpc
Security []stringGroup Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- allow
Version BooleanUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply
Immediately Boolean - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua
Configuration StringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - arn String
- Amazon Resource Name (ARN) of cluster
- automated
Snapshot IntegerRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability
Zone String - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability
Zone BooleanRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster
Identifier String - The Cluster Identifier. Must be a lower case string.
- cluster
Namespace StringArn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster
Nodes List<ClusterCluster Node> - The nodes in the cluster. Cluster node blocks are documented below
- cluster
Parameter StringGroup Name - The name of the parameter group to be associated with this cluster.
- cluster
Public StringKey - The public key for the cluster
- cluster
Revision StringNumber - The specific revision number of the database in the cluster
- cluster
Subnet StringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster
Type String - The cluster type to use. Either
single-node
ormulti-node
. - cluster
Version String - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database
Name String - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default
Iam StringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- dns
Name String - The DNS name of the cluster
- elastic
Ip String - The Elastic IP (EIP) address for the cluster.
- encrypted Boolean
- If true , the data in the cluster is encrypted at rest.
- endpoint String
- The connection endpoint
- enhanced
Vpc BooleanRouting - If true , enhanced VPC routing is enabled.
- final
Snapshot StringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam
Roles List<String> - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms
Key StringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging
Cluster
Logging - Logging, documented below.
- maintenance
Track StringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage
Master BooleanPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual
Snapshot IntegerRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master
Password String - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master
Password StringSecret Arn - ARN of the cluster admin credentials secret
- master
Password StringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master
Username String - Username for the master DB user.
- multi
Az Boolean - Specifies if the Redshift cluster is multi-AZ.
- node
Type String - The node type to be provisioned for the cluster.
- number
Of IntegerNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner
Account String - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port Integer
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred
Maintenance StringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly
Accessible Boolean - If true, the cluster can be accessed from a public network. Default is
true
. - skip
Final BooleanSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot
Arn String - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot
Cluster StringIdentifier - The name of the cluster the source snapshot was created from.
- snapshot
Copy ClusterSnapshot Copy - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot
Identifier String - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Map<String,String>
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - vpc
Security List<String>Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- allow
Version booleanUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply
Immediately boolean - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua
Configuration stringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - arn string
- Amazon Resource Name (ARN) of cluster
- automated
Snapshot numberRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability
Zone string - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability
Zone booleanRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster
Identifier string - The Cluster Identifier. Must be a lower case string.
- cluster
Namespace stringArn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster
Nodes ClusterCluster Node[] - The nodes in the cluster. Cluster node blocks are documented below
- cluster
Parameter stringGroup Name - The name of the parameter group to be associated with this cluster.
- cluster
Public stringKey - The public key for the cluster
- cluster
Revision stringNumber - The specific revision number of the database in the cluster
- cluster
Subnet stringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster
Type string - The cluster type to use. Either
single-node
ormulti-node
. - cluster
Version string - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database
Name string - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default
Iam stringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- dns
Name string - The DNS name of the cluster
- elastic
Ip string - The Elastic IP (EIP) address for the cluster.
- encrypted boolean
- If true , the data in the cluster is encrypted at rest.
- endpoint string
- The connection endpoint
- enhanced
Vpc booleanRouting - If true , enhanced VPC routing is enabled.
- final
Snapshot stringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam
Roles string[] - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms
Key stringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging
Cluster
Logging - Logging, documented below.
- maintenance
Track stringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage
Master booleanPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual
Snapshot numberRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master
Password string - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master
Password stringSecret Arn - ARN of the cluster admin credentials secret
- master
Password stringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master
Username string - Username for the master DB user.
- multi
Az boolean - Specifies if the Redshift cluster is multi-AZ.
- node
Type string - The node type to be provisioned for the cluster.
- number
Of numberNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner
Account string - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port number
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred
Maintenance stringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly
Accessible boolean - If true, the cluster can be accessed from a public network. Default is
true
. - skip
Final booleanSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot
Arn string - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot
Cluster stringIdentifier - The name of the cluster the source snapshot was created from.
- snapshot
Copy ClusterSnapshot Copy - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot
Identifier string - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - {[key: string]: string}
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - vpc
Security string[]Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- allow_
version_ boolupgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply_
immediately bool - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua_
configuration_ strstatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - arn str
- Amazon Resource Name (ARN) of cluster
- automated_
snapshot_ intretention_ period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability_
zone str - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability_
zone_ boolrelocation_ enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster_
identifier str - The Cluster Identifier. Must be a lower case string.
- cluster_
namespace_ strarn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster_
nodes Sequence[ClusterCluster Node Args] - The nodes in the cluster. Cluster node blocks are documented below
- cluster_
parameter_ strgroup_ name - The name of the parameter group to be associated with this cluster.
- cluster_
public_ strkey - The public key for the cluster
- cluster_
revision_ strnumber - The specific revision number of the database in the cluster
- cluster_
subnet_ strgroup_ name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster_
type str - The cluster type to use. Either
single-node
ormulti-node
. - cluster_
version str - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database_
name str - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default_
iam_ strrole_ arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- dns_
name str - The DNS name of the cluster
- elastic_
ip str - The Elastic IP (EIP) address for the cluster.
- encrypted bool
- If true , the data in the cluster is encrypted at rest.
- endpoint str
- The connection endpoint
- enhanced_
vpc_ boolrouting - If true , enhanced VPC routing is enabled.
- final_
snapshot_ stridentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam_
roles Sequence[str] - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms_
key_ strid - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging
Cluster
Logging Args - Logging, documented below.
- maintenance_
track_ strname - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage_
master_ boolpassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual_
snapshot_ intretention_ period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master_
password str - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master_
password_ strsecret_ arn - ARN of the cluster admin credentials secret
- master_
password_ strsecret_ kms_ key_ id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master_
username str - Username for the master DB user.
- multi_
az bool - Specifies if the Redshift cluster is multi-AZ.
- node_
type str - The node type to be provisioned for the cluster.
- number_
of_ intnodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner_
account str - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port int
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred_
maintenance_ strwindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly_
accessible bool - If true, the cluster can be accessed from a public network. Default is
true
. - skip_
final_ boolsnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot_
arn str - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot_
cluster_ stridentifier - The name of the cluster the source snapshot was created from.
- snapshot_
copy ClusterSnapshot Copy Args - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot_
identifier str - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Mapping[str, str]
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - vpc_
security_ Sequence[str]group_ ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
- allow
Version BooleanUpgrade - If true , major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster. Default is
true
. - apply
Immediately Boolean - Specifies whether any cluster modifications are applied immediately, or during the next maintenance window. Default is
false
. - aqua
Configuration StringStatus - The value represents how the cluster is configured to use AQUA (Advanced Query Accelerator) after the cluster is restored.
No longer supported by the AWS API.
Always returns
auto
. - arn String
- Amazon Resource Name (ARN) of cluster
- automated
Snapshot NumberRetention Period - The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with create-cluster-snapshot. Default is 1.
- availability
Zone String - The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency. Can only be changed if
availability_zone_relocation_enabled
istrue
. - availability
Zone BooleanRelocation Enabled - If true, the cluster can be relocated to another availabity zone, either automatically by AWS or when requested. Default is
false
. Available for use on clusters from the RA3 instance family. - cluster
Identifier String - The Cluster Identifier. Must be a lower case string.
- cluster
Namespace StringArn - The namespace Amazon Resource Name (ARN) of the cluster
- cluster
Nodes List<Property Map> - The nodes in the cluster. Cluster node blocks are documented below
- cluster
Parameter StringGroup Name - The name of the parameter group to be associated with this cluster.
- cluster
Public StringKey - The public key for the cluster
- cluster
Revision StringNumber - The specific revision number of the database in the cluster
- cluster
Subnet StringGroup Name - The name of a cluster subnet group to be associated with this cluster. If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).
- cluster
Type String - The cluster type to use. Either
single-node
ormulti-node
. - cluster
Version String - The version of the Amazon Redshift engine software that you want to deploy on the cluster. The version selected runs on all the nodes in the cluster.
- database
Name String - The name of the first database to be created when the cluster is created.
If you do not provide a name, Amazon Redshift will create a default database called
dev
. - default
Iam StringRole Arn - The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was created.
- dns
Name String - The DNS name of the cluster
- elastic
Ip String - The Elastic IP (EIP) address for the cluster.
- encrypted Boolean
- If true , the data in the cluster is encrypted at rest.
- endpoint String
- The connection endpoint
- enhanced
Vpc BooleanRouting - If true , enhanced VPC routing is enabled.
- final
Snapshot StringIdentifier - The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided,
skip_final_snapshot
must be false. - iam
Roles List<String> - A list of IAM Role ARNs to associate with the cluster. A Maximum of 10 can be associated to the cluster at any time.
- kms
Key StringId - The ARN for the KMS encryption key. When specifying
kms_key_id
,encrypted
needs to be set to true. - logging Property Map
- Logging, documented below.
- maintenance
Track StringName - The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks. Default value is
current
. - manage
Master BooleanPassword - Whether to use AWS SecretsManager to manage the cluster admin credentials.
Conflicts with
master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. - manual
Snapshot NumberRetention Period - The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots. Valid values are between
-1
and3653
. Default value is-1
. - master
Password String - Password for the master DB user.
Conflicts with
manage_master_password
. One ofmaster_password
ormanage_master_password
is required unlesssnapshot_identifier
is provided. Note that this may show up in logs, and it will be stored in the state file. Password must contain at least 8 characters and contain at least one uppercase letter, one lowercase letter, and one number. - master
Password StringSecret Arn - ARN of the cluster admin credentials secret
- master
Password StringSecret Kms Key Id - ID of the KMS key used to encrypt the cluster admin credentials secret.
- master
Username String - Username for the master DB user.
- multi
Az Boolean - Specifies if the Redshift cluster is multi-AZ.
- node
Type String - The node type to be provisioned for the cluster.
- number
Of NumberNodes - The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node. Default is 1.
- owner
Account String - The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.
- port Number
- The port number on which the cluster accepts incoming connections. Valid values are between
1115
and65535
. The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections. Default port is5439
. - preferred
Maintenance StringWindow - The weekly time range (in UTC) during which automated cluster maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi
- publicly
Accessible Boolean - If true, the cluster can be accessed from a public network. Default is
true
. - skip
Final BooleanSnapshot - Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true , a final cluster snapshot is not created. If false , a final cluster snapshot is created before the cluster is deleted. Default is false.
- snapshot
Arn String - The ARN of the snapshot from which to create the new cluster. Conflicts with
snapshot_identifier
. - snapshot
Cluster StringIdentifier - The name of the cluster the source snapshot was created from.
- snapshot
Copy Property Map - Configuration of automatic copy of snapshots from one region to another. Documented below.
- snapshot
Identifier String - The name of the snapshot from which to create the new cluster. Conflicts with
snapshot_arn
. - Map<String>
- A map of tags to assign to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - vpc
Security List<String>Group Ids - A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.
Supporting Types
ClusterClusterNode, ClusterClusterNodeArgs
- Node
Role string - Whether the node is a leader node or a compute node
- Private
Ip stringAddress - The private IP address of a node within a cluster
- Public
Ip stringAddress - The public IP address of a node within a cluster
- Node
Role string - Whether the node is a leader node or a compute node
- Private
Ip stringAddress - The private IP address of a node within a cluster
- Public
Ip stringAddress - The public IP address of a node within a cluster
- node
Role String - Whether the node is a leader node or a compute node
- private
Ip StringAddress - The private IP address of a node within a cluster
- public
Ip StringAddress - The public IP address of a node within a cluster
- node
Role string - Whether the node is a leader node or a compute node
- private
Ip stringAddress - The private IP address of a node within a cluster
- public
Ip stringAddress - The public IP address of a node within a cluster
- node_
role str - Whether the node is a leader node or a compute node
- private_
ip_ straddress - The private IP address of a node within a cluster
- public_
ip_ straddress - The public IP address of a node within a cluster
- node
Role String - Whether the node is a leader node or a compute node
- private
Ip StringAddress - The private IP address of a node within a cluster
- public
Ip StringAddress - The public IP address of a node within a cluster
ClusterLogging, ClusterLoggingArgs
- Enable bool
- Enables logging information such as queries and connection attempts, for the specified Amazon Redshift cluster.
- Bucket
Name string - The name of an existing S3 bucket where the log files are to be stored. Must be in the same region as the cluster and the cluster must have read bucket and put object permissions. For more information on the permissions required for the bucket, please read the AWS documentation
- Log
Destination stringType - The log destination type. An enum with possible values of
s3
andcloudwatch
. - Log
Exports List<string> - The collection of exported log types. Log types include the connection log, user log and user activity log. Required when
log_destination_type
iscloudwatch
. Valid log types areconnectionlog
,userlog
, anduseractivitylog
. - S3Key
Prefix string - The prefix applied to the log file names.
- Enable bool
- Enables logging information such as queries and connection attempts, for the specified Amazon Redshift cluster.
- Bucket
Name string - The name of an existing S3 bucket where the log files are to be stored. Must be in the same region as the cluster and the cluster must have read bucket and put object permissions. For more information on the permissions required for the bucket, please read the AWS documentation
- Log
Destination stringType - The log destination type. An enum with possible values of
s3
andcloudwatch
. - Log
Exports []string - The collection of exported log types. Log types include the connection log, user log and user activity log. Required when
log_destination_type
iscloudwatch
. Valid log types areconnectionlog
,userlog
, anduseractivitylog
. - S3Key
Prefix string - The prefix applied to the log file names.
- enable Boolean
- Enables logging information such as queries and connection attempts, for the specified Amazon Redshift cluster.
- bucket
Name String - The name of an existing S3 bucket where the log files are to be stored. Must be in the same region as the cluster and the cluster must have read bucket and put object permissions. For more information on the permissions required for the bucket, please read the AWS documentation
- log
Destination StringType - The log destination type. An enum with possible values of
s3
andcloudwatch
. - log
Exports List<String> - The collection of exported log types. Log types include the connection log, user log and user activity log. Required when
log_destination_type
iscloudwatch
. Valid log types areconnectionlog
,userlog
, anduseractivitylog
. - s3Key
Prefix String - The prefix applied to the log file names.
- enable boolean
- Enables logging information such as queries and connection attempts, for the specified Amazon Redshift cluster.
- bucket
Name string - The name of an existing S3 bucket where the log files are to be stored. Must be in the same region as the cluster and the cluster must have read bucket and put object permissions. For more information on the permissions required for the bucket, please read the AWS documentation
- log
Destination stringType - The log destination type. An enum with possible values of
s3
andcloudwatch
. - log
Exports string[] - The collection of exported log types. Log types include the connection log, user log and user activity log. Required when
log_destination_type
iscloudwatch
. Valid log types areconnectionlog
,userlog
, anduseractivitylog
. - s3Key
Prefix string - The prefix applied to the log file names.
- enable bool
- Enables logging information such as queries and connection attempts, for the specified Amazon Redshift cluster.
- bucket_
name str - The name of an existing S3 bucket where the log files are to be stored. Must be in the same region as the cluster and the cluster must have read bucket and put object permissions. For more information on the permissions required for the bucket, please read the AWS documentation
- log_
destination_ strtype - The log destination type. An enum with possible values of
s3
andcloudwatch
. - log_
exports Sequence[str] - The collection of exported log types. Log types include the connection log, user log and user activity log. Required when
log_destination_type
iscloudwatch
. Valid log types areconnectionlog
,userlog
, anduseractivitylog
. - s3_
key_ strprefix - The prefix applied to the log file names.
- enable Boolean
- Enables logging information such as queries and connection attempts, for the specified Amazon Redshift cluster.
- bucket
Name String - The name of an existing S3 bucket where the log files are to be stored. Must be in the same region as the cluster and the cluster must have read bucket and put object permissions. For more information on the permissions required for the bucket, please read the AWS documentation
- log
Destination StringType - The log destination type. An enum with possible values of
s3
andcloudwatch
. - log
Exports List<String> - The collection of exported log types. Log types include the connection log, user log and user activity log. Required when
log_destination_type
iscloudwatch
. Valid log types areconnectionlog
,userlog
, anduseractivitylog
. - s3Key
Prefix String - The prefix applied to the log file names.
ClusterSnapshotCopy, ClusterSnapshotCopyArgs
- Destination
Region string - The destination region that you want to copy snapshots to.
- Grant
Name string - The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.
- Retention
Period int - The number of days to retain automated snapshots in the destination region after they are copied from the source region. Defaults to
7
.
- Destination
Region string - The destination region that you want to copy snapshots to.
- Grant
Name string - The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.
- Retention
Period int - The number of days to retain automated snapshots in the destination region after they are copied from the source region. Defaults to
7
.
- destination
Region String - The destination region that you want to copy snapshots to.
- grant
Name String - The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.
- retention
Period Integer - The number of days to retain automated snapshots in the destination region after they are copied from the source region. Defaults to
7
.
- destination
Region string - The destination region that you want to copy snapshots to.
- grant
Name string - The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.
- retention
Period number - The number of days to retain automated snapshots in the destination region after they are copied from the source region. Defaults to
7
.
- destination_
region str - The destination region that you want to copy snapshots to.
- grant_
name str - The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.
- retention_
period int - The number of days to retain automated snapshots in the destination region after they are copied from the source region. Defaults to
7
.
- destination
Region String - The destination region that you want to copy snapshots to.
- grant
Name String - The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.
- retention
Period Number - The number of days to retain automated snapshots in the destination region after they are copied from the source region. Defaults to
7
.
Import
Using pulumi import
, import Redshift Clusters using the cluster_identifier
. For example:
$ pulumi import aws:redshift/cluster:Cluster myprodcluster tf-redshift-cluster-12345
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
aws
Terraform Provider.