1. Packages
  2. AWS QuickStart Redshift
  3. API Docs
  4. Cluster
AWS QuickStart Redshift v0.0.3 published on Friday, Oct 15, 2021 by Pulumi

aws-quickstart-redshift.Cluster

Explore with Pulumi AI

aws-quickstart-redshift logo
AWS QuickStart Redshift v0.0.3 published on Friday, Oct 15, 2021 by Pulumi

    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?: ComponentResourceOptions);
    @overload
    def Cluster(resource_name: str,
                args: ClusterArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def Cluster(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                subnet_ids: Optional[Sequence[str]] = None,
                db_cluster_identifier: Optional[str] = None,
                vpc_id: Optional[str] = None,
                db_master_password: Optional[str] = None,
                db_master_username: Optional[str] = None,
                db_name: Optional[str] = None,
                db_node_type: Optional[str] = None,
                enable_event_subscription: Optional[bool] = None,
                additional_security_group_id: Optional[Sequence[str]] = None,
                enable_logging: Optional[bool] = None,
                glue_catalog_database_name: Optional[str] = None,
                max_concurrent_cluster: Optional[float] = None,
                notification_email: Optional[str] = None,
                num_db_nodes: Optional[int] = None,
                publicly_accessible: Optional[bool] = None,
                redshift_logging_s3_bucket_name: Optional[str] = None,
                db_port: Optional[int] = None,
                db_maintenance_window: Optional[str] = None)
    func NewCluster(ctx *Context, name string, args ClusterArgs, opts ...ResourceOption) (*Cluster, error)
    public Cluster(string name, ClusterArgs args, ComponentResourceOptions? opts = null)
    public Cluster(String name, ClusterArgs args)
    public Cluster(String name, ClusterArgs args, ComponentResourceOptions options)
    
    type: aws-quickstart-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 ComponentResourceOptions
    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 ComponentResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ClusterArgs
    The arguments to resource properties.
    options ComponentResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var clusterResource = new AwsQuickStartRedshift.Cluster("clusterResource", new()
    {
        SubnetIDs = new[]
        {
            "string",
        },
        DbClusterIdentifier = "string",
        VpcID = "string",
        DbMasterPassword = "string",
        DbMasterUsername = "string",
        DbName = "string",
        DbNodeType = "string",
        EnableEventSubscription = false,
        AdditionalSecurityGroupID = new[]
        {
            "string",
        },
        EnableLogging = false,
        GlueCatalogDatabaseName = "string",
        MaxConcurrentCluster = 0,
        NotificationEmail = "string",
        NumDbNodes = 0,
        PubliclyAccessible = false,
        RedshiftLoggingS3BucketName = "string",
        DbPort = 0,
        DbMaintenanceWindow = "string",
    });
    
    example, err := awsquickstartredshift.NewCluster(ctx, "clusterResource", &awsquickstartredshift.ClusterArgs{
    	SubnetIDs: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	DbClusterIdentifier:     "string",
    	VpcID:                   pulumi.String("string"),
    	DbMasterPassword:        pulumi.String("string"),
    	DbMasterUsername:        "string",
    	DbName:                  "string",
    	DbNodeType:              "string",
    	EnableEventSubscription: false,
    	AdditionalSecurityGroupID: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	EnableLogging:               false,
    	GlueCatalogDatabaseName:     "string",
    	MaxConcurrentCluster:        0,
    	NotificationEmail:           "string",
    	NumDbNodes:                  0,
    	PubliclyAccessible:          false,
    	RedshiftLoggingS3BucketName: "string",
    	DbPort:                      0,
    	DbMaintenanceWindow:         "string",
    })
    
    var clusterResource = new Cluster("clusterResource", ClusterArgs.builder()
        .subnetIDs("string")
        .dbClusterIdentifier("string")
        .vpcID("string")
        .dbMasterPassword("string")
        .dbMasterUsername("string")
        .dbName("string")
        .dbNodeType("string")
        .enableEventSubscription(false)
        .additionalSecurityGroupID("string")
        .enableLogging(false)
        .glueCatalogDatabaseName("string")
        .maxConcurrentCluster(0)
        .notificationEmail("string")
        .numDbNodes(0)
        .publiclyAccessible(false)
        .redshiftLoggingS3BucketName("string")
        .dbPort(0)
        .dbMaintenanceWindow("string")
        .build());
    
    cluster_resource = aws_quickstart_redshift.Cluster("clusterResource",
        subnet_ids=["string"],
        db_cluster_identifier="string",
        vpc_id="string",
        db_master_password="string",
        db_master_username="string",
        db_name="string",
        db_node_type="string",
        enable_event_subscription=False,
        additional_security_group_id=["string"],
        enable_logging=False,
        glue_catalog_database_name="string",
        max_concurrent_cluster=0,
        notification_email="string",
        num_db_nodes=0,
        publicly_accessible=False,
        redshift_logging_s3_bucket_name="string",
        db_port=0,
        db_maintenance_window="string")
    
    const clusterResource = new aws_quickstart_redshift.Cluster("clusterResource", {
        subnetIDs: ["string"],
        dbClusterIdentifier: "string",
        vpcID: "string",
        dbMasterPassword: "string",
        dbMasterUsername: "string",
        dbName: "string",
        dbNodeType: "string",
        enableEventSubscription: false,
        additionalSecurityGroupID: ["string"],
        enableLogging: false,
        glueCatalogDatabaseName: "string",
        maxConcurrentCluster: 0,
        notificationEmail: "string",
        numDbNodes: 0,
        publiclyAccessible: false,
        redshiftLoggingS3BucketName: "string",
        dbPort: 0,
        dbMaintenanceWindow: "string",
    });
    
    type: aws-quickstart-redshift:Cluster
    properties:
        additionalSecurityGroupID:
            - string
        dbClusterIdentifier: string
        dbMaintenanceWindow: string
        dbMasterPassword: string
        dbMasterUsername: string
        dbName: string
        dbNodeType: string
        dbPort: 0
        enableEventSubscription: false
        enableLogging: false
        glueCatalogDatabaseName: string
        maxConcurrentCluster: 0
        notificationEmail: string
        numDbNodes: 0
        publiclyAccessible: false
        redshiftLoggingS3BucketName: string
        subnetIDs:
            - string
        vpcID: 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:

    DbClusterIdentifier string
    The identifier of the Redshift Cluster. Must contain only lowercase, alphanumeric characters and hyphens.
    DbMasterPassword string
    The password that is associated with the master user account for the cluster that is being created. Must have at least 8 characters and no more than 64 characters, and must include 1 uppercase letter, 1 lowercase letter, 1 number, and 1 symbol (excluding / @ " ').
    DbMasterUsername string
    The user name that is associated with the master user account for the cluster that is being created.
    DbName string
    The name of the first database to be created when the cluster is created.
    DbNodeType string
    The type of node to be provisioned
    SubnetIDs List<string>
    The list of subnet IDs in which to deploy the Redshift Cluster
    VpcID string
    The VPC with which to create the Redshift Cluster
    AdditionalSecurityGroupID List<string>
    An additional list of security group IDs to attach to the redshift cluster
    DbMaintenanceWindow string
    The maintenance window for the Redshift cluster. e.g 'sat:05:00-sat:05:30'
    DbPort int
    The port number on which the cluster accepts incoming connections. Default is 8200
    EnableEventSubscription bool
    Set this parameter to false if you want to disable Amazon Redshift Cluster and Instance level event subscriptions. You might want to disable it if you are testing or running continuous integration (CI) processes. Default is true.
    EnableLogging bool
    Enables or disables logging to an S3 bucket. To enable logging, select True.
    GlueCatalogDatabaseName string
    The name of your Glue Data Catalog database.
    MaxConcurrentCluster double
    The maximum number of concurrency scaling Redshift clusters.
    NotificationEmail string
    The email notification list that is used to configure an SNS topic for sending CloudWatch alarm and event notifications.
    NumDbNodes int
    The number of compute nodes in the cluster. For multi-node clusters, the NumberOfNodes parameter must be greater than 1.
    PubliclyAccessible bool
    Specifies whether Amazon Redshift will be publicly accessible. If this option is set to True, the Amazon Redshift cluster will be created in a public subnet with security group whitelisting to RemoteAccessCIDR. If you leave the default option of False, the Amazon Redshift cluster will be created in a private subnet with security group whitelisting to VPCCIDR.
    RedshiftLoggingS3BucketName string
    Name for an S3 bucket for logging. An IAM role will be created and associated to the Redshift cluster with GET and LIST access to this bucket.
    DbClusterIdentifier string
    The identifier of the Redshift Cluster. Must contain only lowercase, alphanumeric characters and hyphens.
    DbMasterPassword string
    The password that is associated with the master user account for the cluster that is being created. Must have at least 8 characters and no more than 64 characters, and must include 1 uppercase letter, 1 lowercase letter, 1 number, and 1 symbol (excluding / @ " ').
    DbMasterUsername string
    The user name that is associated with the master user account for the cluster that is being created.
    DbName string
    The name of the first database to be created when the cluster is created.
    DbNodeType string
    The type of node to be provisioned
    SubnetIDs []string
    The list of subnet IDs in which to deploy the Redshift Cluster
    VpcID string
    The VPC with which to create the Redshift Cluster
    AdditionalSecurityGroupID []string
    An additional list of security group IDs to attach to the redshift cluster
    DbMaintenanceWindow string
    The maintenance window for the Redshift cluster. e.g 'sat:05:00-sat:05:30'
    DbPort int
    The port number on which the cluster accepts incoming connections. Default is 8200
    EnableEventSubscription bool
    Set this parameter to false if you want to disable Amazon Redshift Cluster and Instance level event subscriptions. You might want to disable it if you are testing or running continuous integration (CI) processes. Default is true.
    EnableLogging bool
    Enables or disables logging to an S3 bucket. To enable logging, select True.
    GlueCatalogDatabaseName string
    The name of your Glue Data Catalog database.
    MaxConcurrentCluster float64
    The maximum number of concurrency scaling Redshift clusters.
    NotificationEmail string
    The email notification list that is used to configure an SNS topic for sending CloudWatch alarm and event notifications.
    NumDbNodes int
    The number of compute nodes in the cluster. For multi-node clusters, the NumberOfNodes parameter must be greater than 1.
    PubliclyAccessible bool
    Specifies whether Amazon Redshift will be publicly accessible. If this option is set to True, the Amazon Redshift cluster will be created in a public subnet with security group whitelisting to RemoteAccessCIDR. If you leave the default option of False, the Amazon Redshift cluster will be created in a private subnet with security group whitelisting to VPCCIDR.
    RedshiftLoggingS3BucketName string
    Name for an S3 bucket for logging. An IAM role will be created and associated to the Redshift cluster with GET and LIST access to this bucket.
    dbClusterIdentifier String
    The identifier of the Redshift Cluster. Must contain only lowercase, alphanumeric characters and hyphens.
    dbMasterPassword String
    The password that is associated with the master user account for the cluster that is being created. Must have at least 8 characters and no more than 64 characters, and must include 1 uppercase letter, 1 lowercase letter, 1 number, and 1 symbol (excluding / @ " ').
    dbMasterUsername String
    The user name that is associated with the master user account for the cluster that is being created.
    dbName String
    The name of the first database to be created when the cluster is created.
    dbNodeType String
    The type of node to be provisioned
    subnetIDs List<String>
    The list of subnet IDs in which to deploy the Redshift Cluster
    vpcID String
    The VPC with which to create the Redshift Cluster
    additionalSecurityGroupID List<String>
    An additional list of security group IDs to attach to the redshift cluster
    dbMaintenanceWindow String
    The maintenance window for the Redshift cluster. e.g 'sat:05:00-sat:05:30'
    dbPort Integer
    The port number on which the cluster accepts incoming connections. Default is 8200
    enableEventSubscription Boolean
    Set this parameter to false if you want to disable Amazon Redshift Cluster and Instance level event subscriptions. You might want to disable it if you are testing or running continuous integration (CI) processes. Default is true.
    enableLogging Boolean
    Enables or disables logging to an S3 bucket. To enable logging, select True.
    glueCatalogDatabaseName String
    The name of your Glue Data Catalog database.
    maxConcurrentCluster Double
    The maximum number of concurrency scaling Redshift clusters.
    notificationEmail String
    The email notification list that is used to configure an SNS topic for sending CloudWatch alarm and event notifications.
    numDbNodes Integer
    The number of compute nodes in the cluster. For multi-node clusters, the NumberOfNodes parameter must be greater than 1.
    publiclyAccessible Boolean
    Specifies whether Amazon Redshift will be publicly accessible. If this option is set to True, the Amazon Redshift cluster will be created in a public subnet with security group whitelisting to RemoteAccessCIDR. If you leave the default option of False, the Amazon Redshift cluster will be created in a private subnet with security group whitelisting to VPCCIDR.
    redshiftLoggingS3BucketName String
    Name for an S3 bucket for logging. An IAM role will be created and associated to the Redshift cluster with GET and LIST access to this bucket.
    dbClusterIdentifier string
    The identifier of the Redshift Cluster. Must contain only lowercase, alphanumeric characters and hyphens.
    dbMasterPassword string
    The password that is associated with the master user account for the cluster that is being created. Must have at least 8 characters and no more than 64 characters, and must include 1 uppercase letter, 1 lowercase letter, 1 number, and 1 symbol (excluding / @ " ').
    dbMasterUsername string
    The user name that is associated with the master user account for the cluster that is being created.
    dbName string
    The name of the first database to be created when the cluster is created.
    dbNodeType string
    The type of node to be provisioned
    subnetIDs string[]
    The list of subnet IDs in which to deploy the Redshift Cluster
    vpcID string
    The VPC with which to create the Redshift Cluster
    additionalSecurityGroupID string[]
    An additional list of security group IDs to attach to the redshift cluster
    dbMaintenanceWindow string
    The maintenance window for the Redshift cluster. e.g 'sat:05:00-sat:05:30'
    dbPort number
    The port number on which the cluster accepts incoming connections. Default is 8200
    enableEventSubscription boolean
    Set this parameter to false if you want to disable Amazon Redshift Cluster and Instance level event subscriptions. You might want to disable it if you are testing or running continuous integration (CI) processes. Default is true.
    enableLogging boolean
    Enables or disables logging to an S3 bucket. To enable logging, select True.
    glueCatalogDatabaseName string
    The name of your Glue Data Catalog database.
    maxConcurrentCluster number
    The maximum number of concurrency scaling Redshift clusters.
    notificationEmail string
    The email notification list that is used to configure an SNS topic for sending CloudWatch alarm and event notifications.
    numDbNodes number
    The number of compute nodes in the cluster. For multi-node clusters, the NumberOfNodes parameter must be greater than 1.
    publiclyAccessible boolean
    Specifies whether Amazon Redshift will be publicly accessible. If this option is set to True, the Amazon Redshift cluster will be created in a public subnet with security group whitelisting to RemoteAccessCIDR. If you leave the default option of False, the Amazon Redshift cluster will be created in a private subnet with security group whitelisting to VPCCIDR.
    redshiftLoggingS3BucketName string
    Name for an S3 bucket for logging. An IAM role will be created and associated to the Redshift cluster with GET and LIST access to this bucket.
    db_cluster_identifier str
    The identifier of the Redshift Cluster. Must contain only lowercase, alphanumeric characters and hyphens.
    db_master_password str
    The password that is associated with the master user account for the cluster that is being created. Must have at least 8 characters and no more than 64 characters, and must include 1 uppercase letter, 1 lowercase letter, 1 number, and 1 symbol (excluding / @ " ').
    db_master_username str
    The user name that is associated with the master user account for the cluster that is being created.
    db_name str
    The name of the first database to be created when the cluster is created.
    db_node_type str
    The type of node to be provisioned
    subnet_ids Sequence[str]
    The list of subnet IDs in which to deploy the Redshift Cluster
    vpc_id str
    The VPC with which to create the Redshift Cluster
    additional_security_group_id Sequence[str]
    An additional list of security group IDs to attach to the redshift cluster
    db_maintenance_window str
    The maintenance window for the Redshift cluster. e.g 'sat:05:00-sat:05:30'
    db_port int
    The port number on which the cluster accepts incoming connections. Default is 8200
    enable_event_subscription bool
    Set this parameter to false if you want to disable Amazon Redshift Cluster and Instance level event subscriptions. You might want to disable it if you are testing or running continuous integration (CI) processes. Default is true.
    enable_logging bool
    Enables or disables logging to an S3 bucket. To enable logging, select True.
    glue_catalog_database_name str
    The name of your Glue Data Catalog database.
    max_concurrent_cluster float
    The maximum number of concurrency scaling Redshift clusters.
    notification_email str
    The email notification list that is used to configure an SNS topic for sending CloudWatch alarm and event notifications.
    num_db_nodes int
    The number of compute nodes in the cluster. For multi-node clusters, the NumberOfNodes parameter must be greater than 1.
    publicly_accessible bool
    Specifies whether Amazon Redshift will be publicly accessible. If this option is set to True, the Amazon Redshift cluster will be created in a public subnet with security group whitelisting to RemoteAccessCIDR. If you leave the default option of False, the Amazon Redshift cluster will be created in a private subnet with security group whitelisting to VPCCIDR.
    redshift_logging_s3_bucket_name str
    Name for an S3 bucket for logging. An IAM role will be created and associated to the Redshift cluster with GET and LIST access to this bucket.
    dbClusterIdentifier String
    The identifier of the Redshift Cluster. Must contain only lowercase, alphanumeric characters and hyphens.
    dbMasterPassword String
    The password that is associated with the master user account for the cluster that is being created. Must have at least 8 characters and no more than 64 characters, and must include 1 uppercase letter, 1 lowercase letter, 1 number, and 1 symbol (excluding / @ " ').
    dbMasterUsername String
    The user name that is associated with the master user account for the cluster that is being created.
    dbName String
    The name of the first database to be created when the cluster is created.
    dbNodeType String
    The type of node to be provisioned
    subnetIDs List<String>
    The list of subnet IDs in which to deploy the Redshift Cluster
    vpcID String
    The VPC with which to create the Redshift Cluster
    additionalSecurityGroupID List<String>
    An additional list of security group IDs to attach to the redshift cluster
    dbMaintenanceWindow String
    The maintenance window for the Redshift cluster. e.g 'sat:05:00-sat:05:30'
    dbPort Number
    The port number on which the cluster accepts incoming connections. Default is 8200
    enableEventSubscription Boolean
    Set this parameter to false if you want to disable Amazon Redshift Cluster and Instance level event subscriptions. You might want to disable it if you are testing or running continuous integration (CI) processes. Default is true.
    enableLogging Boolean
    Enables or disables logging to an S3 bucket. To enable logging, select True.
    glueCatalogDatabaseName String
    The name of your Glue Data Catalog database.
    maxConcurrentCluster Number
    The maximum number of concurrency scaling Redshift clusters.
    notificationEmail String
    The email notification list that is used to configure an SNS topic for sending CloudWatch alarm and event notifications.
    numDbNodes Number
    The number of compute nodes in the cluster. For multi-node clusters, the NumberOfNodes parameter must be greater than 1.
    publiclyAccessible Boolean
    Specifies whether Amazon Redshift will be publicly accessible. If this option is set to True, the Amazon Redshift cluster will be created in a public subnet with security group whitelisting to RemoteAccessCIDR. If you leave the default option of False, the Amazon Redshift cluster will be created in a private subnet with security group whitelisting to VPCCIDR.
    redshiftLoggingS3BucketName String
    Name for an S3 bucket for logging. An IAM role will be created and associated to the Redshift cluster with GET and LIST access to this bucket.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Cluster resource produces the following output properties:

    Package Details

    Repository
    AWS QuickStart Redshift
    License
    aws-quickstart-redshift logo
    AWS QuickStart Redshift v0.0.3 published on Friday, Oct 15, 2021 by Pulumi