Cluster
Describes a cluster.
Types
Properties
A boolean value that, if true
, indicates that major version upgrades will be applied automatically to the cluster during the maintenance window.
This field is retired. Amazon Redshift automatically determines whether to use AQUA (Advanced Query Accelerator).
The number of days that automatic cluster snapshots are retained.
The name of the Availability Zone in which the cluster is located.
Describes the status of the Availability Zone relocation operation.
The availability status of the cluster for queries. Possible values are the following:
The date and time that the cluster was created.
The unique identifier of the cluster.
The namespace Amazon Resource Name (ARN) of the cluster.
The nodes 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 public key for the cluster.
The specific revision number of the database in the cluster.
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.
A value that returns the destination region and retention period that are configured for cross-region snapshot copy.
The current state of the cluster. Possible values are the following:
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 version ID of the Amazon Redshift engine that is running on the cluster.
The certificate Amazon Resource Name (ARN) for the custom domain name.
The expiration date for the certificate associated with the custom domain name.
The custom domain name associated with the cluster.
The Amazon Resource Name (ARN) for the IAM role set as default for the cluster.
Describes a group of DeferredMaintenanceWindow
objects.
The status of the elastic IP (EIP) address.
The number of nodes that you can resize the cluster to with the elastic resize method.
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.
The date and time when the next snapshot is expected to be taken for clusters with a valid snapshot schedule and backups enabled.
The status of next expected snapshot for clusters having a valid snapshot schedule and backups enabled. Possible values are the following:
A list of Identity and Access Management (IAM) roles that can be used by the cluster to access other Amazon Web Services services.
The IP address type for the cluster. Possible values are ipv4
and dualstack
.
The name of the maintenance track for the cluster.
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 Amazon Resource Name (ARN) for the cluster's admin user credentials secret.
The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.
The admin user name for the cluster. This name is used to connect to the database that is specified in the DBName parameter.
The status of a modify operation, if any, initiated for the cluster.
The secondary compute unit of a cluster, if Multi-AZ deployment is turned on.
The date and time in UTC when system maintenance can begin.
The number of compute nodes in the cluster.
Cluster operations that are waiting to be started.
A value that, if present, indicates that changes to the cluster are pending. Specific pending changes are identified by subelements.
The weekly time range, in Universal Coordinated Time (UTC), during which system maintenance can occur.
A boolean value that, if true
, indicates that the cluster can be accessed from a public network.
The status of the reserved-node exchange request. Statuses include in-progress and requested.
Returns the following:
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.
A unique identifier for the cluster snapshot schedule.
The current state of the cluster snapshot schedule.
The total storage capacity of the cluster in megabytes.
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.