AWS Native v0.54.0, Mar 21 23

aws-native.memorydb.Cluster

The AWS::MemoryDB::Cluster resource creates an Amazon MemoryDB Cluster.

Create Cluster Resource

new Cluster(name: string, args: ClusterArgs, opts?: CustomResourceOptions);

@overload
def Cluster(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            a_cl_name: Optional[str] = None,
            auto_minor_version_upgrade: Optional[bool] = None,
            cluster_endpoint: Optional[ClusterEndpointArgs] = None,
            cluster_name: Optional[str] = None,
            data_tiering: Optional[ClusterDataTieringStatus] = None,
            description: Optional[str] = None,
            engine_version: Optional[str] = None,
            final_snapshot_name: Optional[str] = None,
            kms_key_id: Optional[str] = None,
            maintenance_window: Optional[str] = None,
            node_type: Optional[str] = None,
            num_replicas_per_shard: Optional[int] = None,
            num_shards: Optional[int] = None,
            parameter_group_name: Optional[str] = None,
            port: Optional[int] = None,
            security_group_ids: Optional[Sequence[str]] = None,
            snapshot_arns: Optional[Sequence[str]] = None,
            snapshot_name: Optional[str] = None,
            snapshot_retention_limit: Optional[int] = None,
            snapshot_window: Optional[str] = None,
            sns_topic_arn: Optional[str] = None,
            sns_topic_status: Optional[str] = None,
            subnet_group_name: Optional[str] = None,
            t_ls_enabled: Optional[bool] = None,
            tags: Optional[Sequence[ClusterTagArgs]] = None)
@overload
def Cluster(resource_name: str,
            args: ClusterArgs,
            opts: Optional[ResourceOptions] = 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-native:memorydb:Cluster
properties: # The arguments to resource properties.
options: # 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.

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.

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

The Cluster resource accepts the following input properties:

ACLName string

The name of the Access Control List to associate with the cluster.

NodeType string

The compute and memory capacity of the nodes in the cluster.

AutoMinorVersionUpgrade bool

A flag that enables automatic minor version upgrade when set to true.

You cannot modify the value of AutoMinorVersionUpgrade after the cluster is created. To enable AutoMinorVersionUpgrade on a cluster you must set AutoMinorVersionUpgrade to true when you create a cluster.

ClusterEndpoint Pulumi.AwsNative.MemoryDB.Inputs.ClusterEndpointArgs

The cluster endpoint.

ClusterName string

The name of the cluster. This value must be unique as it also serves as the cluster identifier.

DataTiering Pulumi.AwsNative.MemoryDB.ClusterDataTieringStatus

Enables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes.

Description string

An optional description of the cluster.

EngineVersion string

The Redis engine version used by the cluster.

FinalSnapshotName string

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.

KmsKeyId string

The ID of the KMS key used to encrypt the cluster.

MaintenanceWindow string

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

NumReplicasPerShard int

The number of replicas to apply to each shard. The limit is 5.

NumShards int

The number of shards the cluster will contain.

ParameterGroupName string

The name of the parameter group associated with the cluster.

Port int

The port number on which each member of the cluster accepts connections.

SecurityGroupIds List<string>

One or more Amazon VPC security groups associated with this cluster.

SnapshotArns List<string>

A list of Amazon Resource Names (ARN) that uniquely identify the RDB snapshot files stored in Amazon S3. The snapshot files are used to populate the new cluster. The Amazon S3 object name in the ARN cannot contain any commas.

SnapshotName string

The name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.

SnapshotRetentionLimit int

The number of days for which MemoryDB retains automatic snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.

SnapshotWindow string

The daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.

SnsTopicArn string

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

SnsTopicStatus string

The status of the Amazon SNS notification topic. Notifications are sent only if the status is enabled.

SubnetGroupName string

The name of the subnet group to be used for the cluster.

TLSEnabled bool

A flag that enables in-transit encryption when set to true.

You cannot modify the value of TransitEncryptionEnabled after the cluster is created. To enable in-transit encryption on a cluster you must set TransitEncryptionEnabled to true when you create a cluster.

Tags List<Pulumi.AwsNative.MemoryDB.Inputs.ClusterTagArgs>

An array of key-value pairs to apply to this cluster.

ACLName string

The name of the Access Control List to associate with the cluster.

NodeType string

The compute and memory capacity of the nodes in the cluster.

AutoMinorVersionUpgrade bool

A flag that enables automatic minor version upgrade when set to true.

ClusterEndpoint ClusterEndpointArgs

The cluster endpoint.

ClusterName string

The name of the cluster. This value must be unique as it also serves as the cluster identifier.

DataTiering ClusterDataTieringStatus

Enables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes.

Description string

An optional description of the cluster.

EngineVersion string

The Redis engine version used by the cluster.

FinalSnapshotName string

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.

KmsKeyId string

The ID of the KMS key used to encrypt the cluster.

MaintenanceWindow string

NumReplicasPerShard int

The number of replicas to apply to each shard. The limit is 5.

NumShards int

The number of shards the cluster will contain.

ParameterGroupName string

The name of the parameter group associated with the cluster.

Port int

The port number on which each member of the cluster accepts connections.

SecurityGroupIds []string

One or more Amazon VPC security groups associated with this cluster.

SnapshotArns []string

SnapshotName string

The name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.

SnapshotRetentionLimit int

SnapshotWindow string

The daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.

SnsTopicArn string

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

SnsTopicStatus string

The status of the Amazon SNS notification topic. Notifications are sent only if the status is enabled.

SubnetGroupName string

The name of the subnet group to be used for the cluster.

TLSEnabled bool

A flag that enables in-transit encryption when set to true.

Tags []ClusterTagArgs

An array of key-value pairs to apply to this cluster.

aCLName String

The name of the Access Control List to associate with the cluster.

nodeType String

The compute and memory capacity of the nodes in the cluster.

autoMinorVersionUpgrade Boolean

A flag that enables automatic minor version upgrade when set to true.

clusterEndpoint ClusterEndpointArgs

The cluster endpoint.

clusterName String

The name of the cluster. This value must be unique as it also serves as the cluster identifier.

dataTiering ClusterDataTieringStatus

Enables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes.

description String

An optional description of the cluster.

engineVersion String

The Redis engine version used by the cluster.

finalSnapshotName String

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.

kmsKeyId String

The ID of the KMS key used to encrypt the cluster.

maintenanceWindow String

numReplicasPerShard Integer

The number of replicas to apply to each shard. The limit is 5.

numShards Integer

The number of shards the cluster will contain.

parameterGroupName String

The name of the parameter group associated with the cluster.

port Integer

The port number on which each member of the cluster accepts connections.

securityGroupIds List<String>

One or more Amazon VPC security groups associated with this cluster.

snapshotArns List<String>

snapshotName String

The name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.

snapshotRetentionLimit Integer

snapshotWindow String

The daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.

snsTopicArn String

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

snsTopicStatus String

The status of the Amazon SNS notification topic. Notifications are sent only if the status is enabled.

subnetGroupName String

The name of the subnet group to be used for the cluster.

tLSEnabled Boolean

A flag that enables in-transit encryption when set to true.

tags List<ClusterTagArgs>

An array of key-value pairs to apply to this cluster.

aCLName string

The name of the Access Control List to associate with the cluster.

nodeType string

The compute and memory capacity of the nodes in the cluster.

autoMinorVersionUpgrade boolean

A flag that enables automatic minor version upgrade when set to true.

clusterEndpoint ClusterEndpointArgs

The cluster endpoint.

clusterName string

The name of the cluster. This value must be unique as it also serves as the cluster identifier.

dataTiering ClusterDataTieringStatus

Enables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes.

description string

An optional description of the cluster.

engineVersion string

The Redis engine version used by the cluster.

finalSnapshotName string

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.

kmsKeyId string

The ID of the KMS key used to encrypt the cluster.

maintenanceWindow string

numReplicasPerShard number

The number of replicas to apply to each shard. The limit is 5.

numShards number

The number of shards the cluster will contain.

parameterGroupName string

The name of the parameter group associated with the cluster.

port number

The port number on which each member of the cluster accepts connections.

securityGroupIds string[]

One or more Amazon VPC security groups associated with this cluster.

snapshotArns string[]

snapshotName string

The name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.

snapshotRetentionLimit number

snapshotWindow string

The daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.

snsTopicArn string

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

snsTopicStatus string

The status of the Amazon SNS notification topic. Notifications are sent only if the status is enabled.

subnetGroupName string

The name of the subnet group to be used for the cluster.

tLSEnabled boolean

A flag that enables in-transit encryption when set to true.

tags ClusterTagArgs[]

An array of key-value pairs to apply to this cluster.

a_cl_name str

The name of the Access Control List to associate with the cluster.

node_type str

The compute and memory capacity of the nodes in the cluster.

auto_minor_version_upgrade bool

A flag that enables automatic minor version upgrade when set to true.

cluster_endpoint ClusterEndpointArgs

The cluster endpoint.

cluster_name str

The name of the cluster. This value must be unique as it also serves as the cluster identifier.

data_tiering ClusterDataTieringStatus

Enables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes.

description str

An optional description of the cluster.

engine_version str

The Redis engine version used by the cluster.

final_snapshot_name str

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.

kms_key_id str

The ID of the KMS key used to encrypt the cluster.

maintenance_window str

num_replicas_per_shard int

The number of replicas to apply to each shard. The limit is 5.

num_shards int

The number of shards the cluster will contain.

parameter_group_name str

The name of the parameter group associated with the cluster.

port int

The port number on which each member of the cluster accepts connections.

security_group_ids Sequence[str]

One or more Amazon VPC security groups associated with this cluster.

snapshot_arns Sequence[str]

snapshot_name str

The name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.

snapshot_retention_limit int

snapshot_window str

The daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.

sns_topic_arn str

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

sns_topic_status str

The status of the Amazon SNS notification topic. Notifications are sent only if the status is enabled.

subnet_group_name str

The name of the subnet group to be used for the cluster.

t_ls_enabled bool

A flag that enables in-transit encryption when set to true.

tags Sequence[ClusterTagArgs]

An array of key-value pairs to apply to this cluster.

aCLName String

The name of the Access Control List to associate with the cluster.

nodeType String

The compute and memory capacity of the nodes in the cluster.

autoMinorVersionUpgrade Boolean

A flag that enables automatic minor version upgrade when set to true.

clusterEndpoint Property Map

The cluster endpoint.

clusterName String

The name of the cluster. This value must be unique as it also serves as the cluster identifier.

dataTiering "true" | "false"

Enables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes.

description String

An optional description of the cluster.

engineVersion String

The Redis engine version used by the cluster.

finalSnapshotName String

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.

kmsKeyId String

The ID of the KMS key used to encrypt the cluster.

maintenanceWindow String

numReplicasPerShard Number

The number of replicas to apply to each shard. The limit is 5.

numShards Number

The number of shards the cluster will contain.

parameterGroupName String

The name of the parameter group associated with the cluster.

port Number

The port number on which each member of the cluster accepts connections.

securityGroupIds List<String>

One or more Amazon VPC security groups associated with this cluster.

snapshotArns List<String>

snapshotName String

The name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.

snapshotRetentionLimit Number

snapshotWindow String

The daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.

snsTopicArn String

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

snsTopicStatus String

The status of the Amazon SNS notification topic. Notifications are sent only if the status is enabled.

subnetGroupName String

The name of the subnet group to be used for the cluster.

tLSEnabled Boolean

A flag that enables in-transit encryption when set to true.

tags List<Property Map>

An array of key-value pairs to apply to this cluster.

Outputs

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

ARN string: The Amazon Resource Name (ARN) of the cluster.
Id string: The provider-assigned unique ID for this managed resource.
ParameterGroupStatus string: The status of the parameter group used by the cluster.
Status string: The status of the cluster. For example, Available, Updating, Creating.

ARN string: The Amazon Resource Name (ARN) of the cluster.
Id string: The provider-assigned unique ID for this managed resource.
ParameterGroupStatus string: The status of the parameter group used by the cluster.
Status string: The status of the cluster. For example, Available, Updating, Creating.

aRN String: The Amazon Resource Name (ARN) of the cluster.
id String: The provider-assigned unique ID for this managed resource.
parameterGroupStatus String: The status of the parameter group used by the cluster.
status String: The status of the cluster. For example, Available, Updating, Creating.

aRN string: The Amazon Resource Name (ARN) of the cluster.
id string: The provider-assigned unique ID for this managed resource.
parameterGroupStatus string: The status of the parameter group used by the cluster.
status string: The status of the cluster. For example, Available, Updating, Creating.

a_rn str: The Amazon Resource Name (ARN) of the cluster.
id str: The provider-assigned unique ID for this managed resource.
parameter_group_status str: The status of the parameter group used by the cluster.
status str: The status of the cluster. For example, Available, Updating, Creating.

aRN String: The Amazon Resource Name (ARN) of the cluster.
id String: The provider-assigned unique ID for this managed resource.
parameterGroupStatus String: The status of the parameter group used by the cluster.
status String: The status of the cluster. For example, Available, Updating, Creating.

Supporting Types

ClusterDataTieringStatus

True: true
False: false

ClusterDataTieringStatusTrue: true
ClusterDataTieringStatusFalse: false

True: true
False: false

True: true
False: false

TRUE: true
FALSE: false

"true": true
"false": false

ClusterEndpoint

Address string: The DNS address of the primary read-write node.
Port int: The port number that the engine is listening on.

Address string: The DNS address of the primary read-write node.
Port int: The port number that the engine is listening on.

address String: The DNS address of the primary read-write node.
port Integer: The port number that the engine is listening on.

address string: The DNS address of the primary read-write node.
port number: The port number that the engine is listening on.

address str: The DNS address of the primary read-write node.
port int: The port number that the engine is listening on.

address String: The DNS address of the primary read-write node.
port Number: The port number that the engine is listening on.

ClusterTag

Key string: The key for the tag. May not be null.
Value string: The tag's value. May be null.

Key string: The key for the tag. May not be null.
Value string: The tag's value. May be null.

key String: The key for the tag. May not be null.
value String: The tag's value. May be null.

key string: The key for the tag. May not be null.
value string: The tag's value. May be null.

key str: The key for the tag. May not be null.
value str: The tag's value. May be null.

key String: The key for the tag. May not be null.
value String: The tag's value. May be null.

Package Details

Repository: AWS Native pulumi/pulumi-aws-native
License: Apache-2.0

aws-native.memorydb.Cluster

Create Cluster Resource

Cluster Resource Properties

Inputs

Outputs

Supporting Types

ClusterDataTieringStatus

ClusterEndpoint

ClusterTag

Package Details

Contents