We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi
Creates a snapshot of a DB cluster.
Create ClusterSnapshot Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ClusterSnapshot(name: string, args: ClusterSnapshotArgs, opts?: CustomResourceOptions);@overload
def ClusterSnapshot(resource_name: str,
args: ClusterSnapshotArgs,
opts: Optional[ResourceOptions] = None)
@overload
def ClusterSnapshot(resource_name: str,
opts: Optional[ResourceOptions] = None,
db_cluster_identifier: Optional[str] = None,
db_cluster_snapshot_identifier: Optional[str] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None)func NewClusterSnapshot(ctx *Context, name string, args ClusterSnapshotArgs, opts ...ResourceOption) (*ClusterSnapshot, error)public ClusterSnapshot(string name, ClusterSnapshotArgs args, CustomResourceOptions? opts = null)
public ClusterSnapshot(String name, ClusterSnapshotArgs args)
public ClusterSnapshot(String name, ClusterSnapshotArgs args, CustomResourceOptions options)
type: aws-native:rds:ClusterSnapshot
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "aws-native_rds_cluster_snapshot" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args ClusterSnapshotArgs
- 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 ClusterSnapshotArgs
- 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 ClusterSnapshotArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ClusterSnapshotArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ClusterSnapshotArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
ClusterSnapshot 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 ClusterSnapshot resource accepts the following input properties:
- Db
Cluster stringIdentifier - The identifier of the DB cluster to create a snapshot for.
- Db
Cluster stringSnapshot Identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
-
List<Pulumi.
Aws Native. Inputs. Tag> - The tags to be assigned to the DB cluster snapshot.
- Db
Cluster stringIdentifier - The identifier of the DB cluster to create a snapshot for.
- Db
Cluster stringSnapshot Identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
-
Tag
Args - The tags to be assigned to the DB cluster snapshot.
- db_
cluster_ stringidentifier - The identifier of the DB cluster to create a snapshot for.
- db_
cluster_ stringsnapshot_ identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
- list(object)
- The tags to be assigned to the DB cluster snapshot.
- db
Cluster StringIdentifier - The identifier of the DB cluster to create a snapshot for.
- db
Cluster StringSnapshot Identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
- List<Tag>
- The tags to be assigned to the DB cluster snapshot.
- db
Cluster stringIdentifier - The identifier of the DB cluster to create a snapshot for.
- db
Cluster stringSnapshot Identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
- Tag[]
- The tags to be assigned to the DB cluster snapshot.
- db_
cluster_ stridentifier - The identifier of the DB cluster to create a snapshot for.
- db_
cluster_ strsnapshot_ identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
-
Sequence[Tag
Args] - The tags to be assigned to the DB cluster snapshot.
- db
Cluster StringIdentifier - The identifier of the DB cluster to create a snapshot for.
- db
Cluster StringSnapshot Identifier - The identifier for the DB cluster snapshot. Must contain from 1 to 63 letters, numbers, or hyphens. First character must be a letter. Can't end with a hyphen or contain two consecutive hyphens.
- List<Property Map>
- The tags to be assigned to the DB cluster snapshot.
Outputs
All input properties are implicitly available as output properties. Additionally, the ClusterSnapshot resource produces the following output properties:
- Allocated
Storage int - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- Availability
Zones List<string> - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- Cluster
Create stringTime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- Db
Cluster stringResource Id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- Db
Cluster stringSnapshot Arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- Engine string
- The name of the database engine for this DB cluster snapshot.
- Engine
Mode string - The engine mode of the database engine for this DB cluster snapshot.
- Engine
Version string - The version of the database engine for this DB cluster snapshot.
- Iam
Database boolAuthentication Enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- Id string
- The provider-assigned unique ID for this managed resource.
- Kms
Key stringId - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- License
Model string - The license model information for this DB cluster snapshot.
- Master
Username string - The master username for this DB cluster snapshot.
- Port int
- The port that the DB cluster was listening on at the time of the snapshot.
- Snapshot
Create stringTime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- Snapshot
Type string - The type of the DB cluster snapshot.
- Status string
- The status of this DB cluster snapshot.
- Storage
Encrypted bool - Indicates whether the DB cluster snapshot is encrypted.
- Vpc
Id string - The VPC ID associated with the DB cluster snapshot.
- Allocated
Storage int - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- Availability
Zones []string - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- Cluster
Create stringTime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- Db
Cluster stringResource Id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- Db
Cluster stringSnapshot Arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- Engine string
- The name of the database engine for this DB cluster snapshot.
- Engine
Mode string - The engine mode of the database engine for this DB cluster snapshot.
- Engine
Version string - The version of the database engine for this DB cluster snapshot.
- Iam
Database boolAuthentication Enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- Id string
- The provider-assigned unique ID for this managed resource.
- Kms
Key stringId - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- License
Model string - The license model information for this DB cluster snapshot.
- Master
Username string - The master username for this DB cluster snapshot.
- Port int
- The port that the DB cluster was listening on at the time of the snapshot.
- Snapshot
Create stringTime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- Snapshot
Type string - The type of the DB cluster snapshot.
- Status string
- The status of this DB cluster snapshot.
- Storage
Encrypted bool - Indicates whether the DB cluster snapshot is encrypted.
- Vpc
Id string - The VPC ID associated with the DB cluster snapshot.
- allocated_
storage number - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- availability_
zones list(string) - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- cluster_
create_ stringtime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- db_
cluster_ stringresource_ id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- db_
cluster_ stringsnapshot_ arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- engine string
- The name of the database engine for this DB cluster snapshot.
- engine_
mode string - The engine mode of the database engine for this DB cluster snapshot.
- engine_
version string - The version of the database engine for this DB cluster snapshot.
- iam_
database_ boolauthentication_ enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- id string
- The provider-assigned unique ID for this managed resource.
- kms_
key_ stringid - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- license_
model string - The license model information for this DB cluster snapshot.
- master_
username string - The master username for this DB cluster snapshot.
- port number
- The port that the DB cluster was listening on at the time of the snapshot.
- snapshot_
create_ stringtime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- snapshot_
type string - The type of the DB cluster snapshot.
- status string
- The status of this DB cluster snapshot.
- storage_
encrypted bool - Indicates whether the DB cluster snapshot is encrypted.
- vpc_
id string - The VPC ID associated with the DB cluster snapshot.
- allocated
Storage Integer - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- availability
Zones List<String> - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- cluster
Create StringTime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- db
Cluster StringResource Id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- db
Cluster StringSnapshot Arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- engine String
- The name of the database engine for this DB cluster snapshot.
- engine
Mode String - The engine mode of the database engine for this DB cluster snapshot.
- engine
Version String - The version of the database engine for this DB cluster snapshot.
- iam
Database BooleanAuthentication Enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- id String
- The provider-assigned unique ID for this managed resource.
- kms
Key StringId - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- license
Model String - The license model information for this DB cluster snapshot.
- master
Username String - The master username for this DB cluster snapshot.
- port Integer
- The port that the DB cluster was listening on at the time of the snapshot.
- snapshot
Create StringTime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- snapshot
Type String - The type of the DB cluster snapshot.
- status String
- The status of this DB cluster snapshot.
- storage
Encrypted Boolean - Indicates whether the DB cluster snapshot is encrypted.
- vpc
Id String - The VPC ID associated with the DB cluster snapshot.
- allocated
Storage number - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- availability
Zones string[] - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- cluster
Create stringTime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- db
Cluster stringResource Id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- db
Cluster stringSnapshot Arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- engine string
- The name of the database engine for this DB cluster snapshot.
- engine
Mode string - The engine mode of the database engine for this DB cluster snapshot.
- engine
Version string - The version of the database engine for this DB cluster snapshot.
- iam
Database booleanAuthentication Enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- id string
- The provider-assigned unique ID for this managed resource.
- kms
Key stringId - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- license
Model string - The license model information for this DB cluster snapshot.
- master
Username string - The master username for this DB cluster snapshot.
- port number
- The port that the DB cluster was listening on at the time of the snapshot.
- snapshot
Create stringTime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- snapshot
Type string - The type of the DB cluster snapshot.
- status string
- The status of this DB cluster snapshot.
- storage
Encrypted boolean - Indicates whether the DB cluster snapshot is encrypted.
- vpc
Id string - The VPC ID associated with the DB cluster snapshot.
- allocated_
storage int - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- availability_
zones Sequence[str] - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- cluster_
create_ strtime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- db_
cluster_ strresource_ id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- db_
cluster_ strsnapshot_ arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- engine str
- The name of the database engine for this DB cluster snapshot.
- engine_
mode str - The engine mode of the database engine for this DB cluster snapshot.
- engine_
version str - The version of the database engine for this DB cluster snapshot.
- iam_
database_ boolauthentication_ enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- id str
- The provider-assigned unique ID for this managed resource.
- kms_
key_ strid - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- license_
model str - The license model information for this DB cluster snapshot.
- master_
username str - The master username for this DB cluster snapshot.
- port int
- The port that the DB cluster was listening on at the time of the snapshot.
- snapshot_
create_ strtime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- snapshot_
type str - The type of the DB cluster snapshot.
- status str
- The status of this DB cluster snapshot.
- storage_
encrypted bool - Indicates whether the DB cluster snapshot is encrypted.
- vpc_
id str - The VPC ID associated with the DB cluster snapshot.
- allocated
Storage Number - The allocated storage size of the DB cluster snapshot in gibibytes (GiB).
- availability
Zones List<String> - The list of Availability Zones where instances in the DB cluster snapshot can be restored.
- cluster
Create StringTime - The time when the DB cluster was created, in Universal Coordinated Time (UTC).
- db
Cluster StringResource Id - The resource ID of the DB cluster that this DB cluster snapshot was created from.
- db
Cluster StringSnapshot Arn - The Amazon Resource Name (ARN) for the DB cluster snapshot.
- engine String
- The name of the database engine for this DB cluster snapshot.
- engine
Mode String - The engine mode of the database engine for this DB cluster snapshot.
- engine
Version String - The version of the database engine for this DB cluster snapshot.
- iam
Database BooleanAuthentication Enabled - Indicates whether mapping of AWS IAM accounts to database accounts is enabled.
- id String
- The provider-assigned unique ID for this managed resource.
- kms
Key StringId - If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.
- license
Model String - The license model information for this DB cluster snapshot.
- master
Username String - The master username for this DB cluster snapshot.
- port Number
- The port that the DB cluster was listening on at the time of the snapshot.
- snapshot
Create StringTime - The time when the snapshot was taken, in Universal Coordinated Time (UTC).
- snapshot
Type String - The type of the DB cluster snapshot.
- status String
- The status of this DB cluster snapshot.
- storage
Encrypted Boolean - Indicates whether the DB cluster snapshot is encrypted.
- vpc
Id String - The VPC ID associated with the DB cluster snapshot.
Supporting Types
Tag, TagArgs
A set of tags to apply to the resource.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi