Documentation

Describes a cluster.

See: newCluster smart constructor.

Create a value of Cluster with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:aquaConfiguration:Cluster', cluster_aquaConfiguration - The AQUA (Advanced Query Accelerator) configuration of the cluster.

$sel:resizeInfo:Cluster', cluster_resizeInfo - Returns the following:

• AllowCancelResize: a boolean value indicating if the resize operation can be cancelled.
• ResizeType: Returns ClassicResize

$sel:restoreStatus:Cluster', cluster_restoreStatus - A value that describes the status of a cluster restore action. This parameter returns null if the cluster was not created by restoring a snapshot.

$sel:manualSnapshotRetentionPeriod:Cluster', cluster_manualSnapshotRetentionPeriod - 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.

The value must be either -1 or an integer between 1 and 3,653.

$sel:enhancedVpcRouting:Cluster', cluster_enhancedVpcRouting - An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

$sel:clusterSnapshotCopyStatus:Cluster', cluster_clusterSnapshotCopyStatus - A value that returns the destination region and retention period that are configured for cross-region snapshot copy.

$sel:clusterAvailabilityStatus:Cluster', cluster_clusterAvailabilityStatus - The availability status of the cluster for queries. Possible values are the following:

• Available - The cluster is available for queries.
• Unavailable - The cluster is not available for queries.
• Maintenance - The cluster is intermittently available for queries due to maintenance activities.
• Modifying - The cluster is intermittently available for queries due to changes that modify the cluster.
• Failed - The cluster failed and is not available for queries.

$sel:clusterRevisionNumber:Cluster', cluster_clusterRevisionNumber - The specific revision number of the database in the cluster.

$sel:snapshotScheduleIdentifier:Cluster', cluster_snapshotScheduleIdentifier - A unique identifier for the cluster snapshot schedule.

$sel:publiclyAccessible:Cluster', cluster_publiclyAccessible - A boolean value that, if true, indicates that the cluster can be accessed from a public network.

$sel:masterUsername:Cluster', cluster_masterUsername - The admin user name for the cluster. This name is used to connect to the database that is specified in the DBName parameter.

$sel:maintenanceTrackName:Cluster', cluster_maintenanceTrackName - The name of the maintenance track for the cluster.

$sel:expectedNextSnapshotScheduleTime:Cluster', cluster_expectedNextSnapshotScheduleTime - The date and time when the next snapshot is expected to be taken for clusters with a valid snapshot schedule and backups enabled.

$sel:elasticResizeNumberOfNodeOptions:Cluster', cluster_elasticResizeNumberOfNodeOptions - The number of nodes that you can resize the cluster to with the elastic resize method.

$sel:vpcId:Cluster', cluster_vpcId - The identifier of the VPC the cluster is in, if the cluster is in a VPC.

$sel:clusterSecurityGroups:Cluster', cluster_clusterSecurityGroups - A list of cluster security group that are associated with the cluster. Each security group is represented by an element that contains ClusterSecurityGroup.Name and ClusterSecurityGroup.Status subelements.

Cluster security groups are used when the cluster is not created in an Amazon Virtual Private Cloud (VPC). Clusters that are created in a VPC use VPC security groups, which are listed by the VpcSecurityGroups parameter.

$sel:automatedSnapshotRetentionPeriod:Cluster', cluster_automatedSnapshotRetentionPeriod - The number of days that automatic cluster snapshots are retained.

$sel:snapshotScheduleState:Cluster', cluster_snapshotScheduleState - The current state of the cluster snapshot schedule.

$sel:dataTransferProgress:Cluster', cluster_dataTransferProgress -

$sel:encrypted:Cluster', cluster_encrypted - A boolean value that, if true, indicates that data in the cluster is encrypted at rest.

$sel:clusterSubnetGroupName:Cluster', cluster_clusterSubnetGroupName - The name of the subnet group that is associated with the cluster. This parameter is valid only when the cluster is in a VPC.

$sel:expectedNextSnapshotScheduleTimeStatus:Cluster', cluster_expectedNextSnapshotScheduleTimeStatus - The status of next expected snapshot for clusters having a valid snapshot schedule and backups enabled. Possible values are the following:

• OnTrack - The next snapshot is expected to be taken on time.
• Pending - The next snapshot is pending to be taken.

$sel:clusterIdentifier:Cluster', cluster_clusterIdentifier - The unique identifier of the cluster.

$sel:deferredMaintenanceWindows:Cluster', cluster_deferredMaintenanceWindows - Describes a group of DeferredMaintenanceWindow objects.

$sel:numberOfNodes:Cluster', cluster_numberOfNodes - The number of compute nodes in the cluster.

$sel:clusterPublicKey:Cluster', cluster_clusterPublicKey - The public key for the cluster.

$sel:preferredMaintenanceWindow:Cluster', cluster_preferredMaintenanceWindow - The weekly time range, in Universal Coordinated Time (UTC), during which system maintenance can occur.

$sel:modifyStatus:Cluster', cluster_modifyStatus - The status of a modify operation, if any, initiated for the cluster.

$sel:clusterNamespaceArn:Cluster', cluster_clusterNamespaceArn - The namespace Amazon Resource Name (ARN) of the cluster.

$sel:kmsKeyId:Cluster', cluster_kmsKeyId - The Key Management Service (KMS) key ID of the encryption key used to encrypt data in the cluster.

$sel:clusterParameterGroups:Cluster', cluster_clusterParameterGroups - The list of cluster parameter groups that are associated with this cluster. Each parameter group in the list is returned with its status.

$sel:totalStorageCapacityInMegaBytes:Cluster', cluster_totalStorageCapacityInMegaBytes - The total storage capacity of the cluster in megabytes.

$sel:availabilityZone:Cluster', cluster_availabilityZone - The name of the Availability Zone in which the cluster is located.

$sel:vpcSecurityGroups:Cluster', cluster_vpcSecurityGroups - A list of Amazon Virtual Private Cloud (Amazon VPC) security groups that are associated with the cluster. This parameter is returned only if the cluster is in a VPC.

$sel:hsmStatus:Cluster', cluster_hsmStatus - A value that reports whether the Amazon Redshift cluster has finished applying any hardware security module (HSM) settings changes specified in a modify cluster command.

Values: active, applying

$sel:iamRoles:Cluster', cluster_iamRoles - A list of Identity and Access Management (IAM) roles that can be used by the cluster to access other Amazon Web Services services.

$sel:pendingActions:Cluster', cluster_pendingActions - Cluster operations that are waiting to be started.

$sel:elasticIpStatus:Cluster', cluster_elasticIpStatus - The status of the elastic IP (EIP) address.

$sel:clusterVersion:Cluster', cluster_clusterVersion - The version ID of the Amazon Redshift engine that is running on the cluster.

$sel:nodeType:Cluster', cluster_nodeType - The node type for the nodes in the cluster.

$sel:nextMaintenanceWindowStartTime:Cluster', cluster_nextMaintenanceWindowStartTime - The date and time in UTC when system maintenance can begin.

$sel:clusterCreateTime:Cluster', cluster_clusterCreateTime - The date and time that the cluster was created.

$sel:endpoint:Cluster', cluster_endpoint - The connection endpoint.

$sel:allowVersionUpgrade:Cluster', cluster_allowVersionUpgrade - A boolean value that, if true, indicates that major version upgrades will be applied automatically to the cluster during the maintenance window.

$sel:clusterStatus:Cluster', cluster_clusterStatus - The current state of the cluster. Possible values are the following:

• available

• available, prep-for-resize

• available, resize-cleanup

• cancelling-resize

• creating

• deleting

• final-snapshot

• hardware-failure

• incompatible-hsm

• incompatible-network

• incompatible-parameters

• incompatible-restore

• modifying

• paused

• rebooting

• renaming

• resizing

• rotating-keys

• storage-full

• updating-hsm

$sel:pendingModifiedValues:Cluster', cluster_pendingModifiedValues - A value that, if present, indicates that changes to the cluster are pending. Specific pending changes are identified by subelements.

$sel:tags:Cluster', cluster_tags - The list of tags for the cluster.

$sel:availabilityZoneRelocationStatus:Cluster', cluster_availabilityZoneRelocationStatus - Describes the status of the Availability Zone relocation operation.

$sel:clusterNodes:Cluster', cluster_clusterNodes - The nodes in the cluster.

$sel:dbName:Cluster', cluster_dbName - The name of the initial database that was created when the cluster was created. This same name is returned for the life of the cluster. If an initial database was not specified, a database named devdev was created by default.

The AQUA (Advanced Query Accelerator) configuration of the cluster.

Returns the following:

• AllowCancelResize: a boolean value indicating if the resize operation can be cancelled.
• ResizeType: Returns ClassicResize

A value that describes the status of a cluster restore action. This parameter returns null if the cluster was not created by restoring a snapshot.

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.

The value must be either -1 or an integer between 1 and 3,653.

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

A value that returns the destination region and retention period that are configured for cross-region snapshot copy.

The availability status of the cluster for queries. Possible values are the following:

• Available - The cluster is available for queries.
• Unavailable - The cluster is not available for queries.
• Maintenance - The cluster is intermittently available for queries due to maintenance activities.
• Modifying - The cluster is intermittently available for queries due to changes that modify the cluster.
• Failed - The cluster failed and is not available for queries.

The specific revision number of the database in the cluster.

A unique identifier for the cluster snapshot schedule.

A boolean value that, if true, indicates that the cluster can be accessed from a public network.

The admin user name for the cluster. This name is used to connect to the database that is specified in the DBName parameter.

The name of the maintenance track for the cluster.

The date and time when the next snapshot is expected to be taken for clusters with a valid snapshot schedule and backups enabled.

The number of nodes that you can resize the cluster to with the elastic resize method.

The identifier of the VPC the cluster is in, if the cluster is in a VPC.

A list of cluster security group that are associated with the cluster. Each security group is represented by an element that contains ClusterSecurityGroup.Name and ClusterSecurityGroup.Status subelements.

Cluster security groups are used when the cluster is not created in an Amazon Virtual Private Cloud (VPC). Clusters that are created in a VPC use VPC security groups, which are listed by the VpcSecurityGroups parameter.

The number of days that automatic cluster snapshots are retained.

The current state of the cluster snapshot schedule.

A boolean value that, if true, indicates that data in the cluster is encrypted at rest.

The name of the subnet group that is associated with the cluster. This parameter is valid only when the cluster is in a VPC.

The status of next expected snapshot for clusters having a valid snapshot schedule and backups enabled. Possible values are the following:

• OnTrack - The next snapshot is expected to be taken on time.
• Pending - The next snapshot is pending to be taken.

The unique identifier of the cluster.

Describes a group of DeferredMaintenanceWindow objects.

The number of compute nodes in the cluster.

The public key for the cluster.

The weekly time range, in Universal Coordinated Time (UTC), during which system maintenance can occur.

The status of a modify operation, if any, initiated for the cluster.

The namespace Amazon Resource Name (ARN) of the cluster.

The Key Management Service (KMS) key ID of the encryption key used to encrypt data in the cluster.

The list of cluster parameter groups that are associated with this cluster. Each parameter group in the list is returned with its status.

The total storage capacity of the cluster in megabytes.

The name of the Availability Zone in which the cluster is located.

A list of Amazon Virtual Private Cloud (Amazon VPC) security groups that are associated with the cluster. This parameter is returned only if the cluster is in a VPC.

A value that reports whether the Amazon Redshift cluster has finished applying any hardware security module (HSM) settings changes specified in a modify cluster command.

Values: active, applying

A list of Identity and Access Management (IAM) roles that can be used by the cluster to access other Amazon Web Services services.

Cluster operations that are waiting to be started.

The status of the elastic IP (EIP) address.

The version ID of the Amazon Redshift engine that is running on the cluster.

The node type for the nodes in the cluster.

The date and time in UTC when system maintenance can begin.

The date and time that the cluster was created.

The connection endpoint.

A boolean value that, if true, indicates that major version upgrades will be applied automatically to the cluster during the maintenance window.

The current state of the cluster. Possible values are the following:

• available

• available, prep-for-resize

• available, resize-cleanup

• cancelling-resize

• creating

• deleting

• final-snapshot

• hardware-failure

• incompatible-hsm

• incompatible-network

• incompatible-parameters

• incompatible-restore

• modifying

• paused

• rebooting

• renaming

• resizing

• rotating-keys

• storage-full

• updating-hsm

A value that, if present, indicates that changes to the cluster are pending. Specific pending changes are identified by subelements.

The list of tags for the cluster.

Describes the status of the Availability Zone relocation operation.

The nodes in the cluster.

The name of the initial database that was created when the cluster was created. This same name is returned for the life of the cluster. If an initial database was not specified, a database named devdev was created by default.