Skip to content

Snapshot

Source code in docs_src/capo_redshift/types/snapshot.py
class Snapshot(TypedDict, closed=True):
    snapshot_identifier: NotRequired["capo_redshift.types.string.String"]
    """<p>The snapshot identifier that is provided in the request.</p>"""
    cluster_identifier: NotRequired["capo_redshift.types.string.String"]
    """<p>The identifier of the cluster for which the snapshot was taken.</p>"""
    snapshot_create_time: NotRequired["capo_redshift.types.t_stamp.TStamp"]
    """<p>The time (in UTC format) when Amazon Redshift began the snapshot. A snapshot contains a copy of the cluster data as of this exact time.</p>"""
    status: NotRequired["capo_redshift.types.string.String"]
    """<p>The snapshot status. The value of the status depends on the API operation used: </p> <ul> <li> <p> <a>CreateClusterSnapshot</a> and <a>CopyClusterSnapshot</a> returns status as "creating". </p> </li> <li> <p> <a>DescribeClusterSnapshots</a> returns status as "creating", "available", "final snapshot", or "failed".</p> </li> <li> <p> <a>DeleteClusterSnapshot</a> returns status as "deleted".</p> </li> </ul>"""
    port: NotRequired["capo_redshift.types.integer.Integer"]
    """<p>The port that the cluster is listening on.</p>"""
    availability_zone: NotRequired["capo_redshift.types.string.String"]
    """<p>The Availability Zone in which the cluster was created.</p>"""
    cluster_create_time: NotRequired["capo_redshift.types.t_stamp.TStamp"]
    """<p>The time (UTC) when the cluster was originally created.</p>"""
    master_username: NotRequired["capo_redshift.types.string.String"]
    """<p>The admin user name for the cluster.</p>"""
    cluster_version: NotRequired["capo_redshift.types.string.String"]
    """<p>The version ID of the Amazon Redshift engine that is running on the cluster.</p>"""
    engine_full_version: NotRequired["capo_redshift.types.string.String"]
    """<p>The cluster version of the cluster used to create the snapshot. For example, 1.0.15503. </p>"""
    snapshot_type: NotRequired["capo_redshift.types.string.String"]
    """<p>The snapshot type. Snapshots created using <a>CreateClusterSnapshot</a> and <a>CopyClusterSnapshot</a> are of type "manual". </p>"""
    node_type: NotRequired["capo_redshift.types.string.String"]
    """<p>The node type of the nodes in the cluster.</p>"""
    number_of_nodes: NotRequired["capo_redshift.types.integer.Integer"]
    """<p>The number of nodes in the cluster.</p>"""
    db_name: NotRequired["capo_redshift.types.string.String"]
    """<p>The name of the database that was created when the cluster was created.</p>"""
    vpc_id: NotRequired["capo_redshift.types.string.String"]
    """<p>The VPC identifier of the cluster if the snapshot is from a cluster in a VPC. Otherwise, this field is not in the output.</p>"""
    encrypted: NotRequired["capo_redshift.types.boolean.Boolean"]
    """<p>If <code>true</code>, the data in the snapshot is encrypted at rest.</p>"""
    kms_key_id: NotRequired["capo_redshift.types.string.String"]
    """<p>The Key Management Service (KMS) key ID of the encryption key that was used to encrypt data in the cluster from which the snapshot was taken.</p>"""
    encrypted_with_hsm: NotRequired["capo_redshift.types.boolean.Boolean"]
    """<p>A boolean that indicates whether the snapshot data is encrypted using the HSM keys of the source cluster. <code>true</code> indicates that the data is encrypted using HSM keys.</p>"""
    accounts_with_restore_access: NotRequired[
        "capo_redshift.types.accounts_with_restore_access_list.AccountsWithRestoreAccessList"
    ]
    """<p>A list of the Amazon Web Services accounts authorized to restore the snapshot. Returns <code>null</code> if no accounts are authorized. Visible only to the snapshot owner. </p>"""
    owner_account: NotRequired["capo_redshift.types.string.String"]
    """<p>For manual snapshots, the Amazon Web Services account used to create or copy the snapshot. For automatic snapshots, the owner of the cluster. The owner can perform all snapshot actions, such as sharing a manual snapshot.</p>"""
    total_backup_size_in_mega_bytes: NotRequired["capo_redshift.types.double.Double"]
    """<p>The size of the complete set of backup data that would be used to restore the cluster.</p>"""
    actual_incremental_backup_size_in_mega_bytes: NotRequired[
        "capo_redshift.types.double.Double"
    ]
    """<p>The size of the incremental backup.</p>"""
    backup_progress_in_mega_bytes: NotRequired["capo_redshift.types.double.Double"]
    """<p>The number of megabytes that have been transferred to the snapshot backup.</p>"""
    current_backup_rate_in_mega_bytes_per_second: NotRequired[
        "capo_redshift.types.double.Double"
    ]
    """<p>The number of megabytes per second being transferred to the snapshot backup. Returns <code>0</code> for a completed backup. </p>"""
    estimated_seconds_to_completion: NotRequired["capo_redshift.types.long.Long"]
    """<p>The estimate of the time remaining before the snapshot backup will complete. Returns <code>0</code> for a completed backup. </p>"""
    elapsed_time_in_seconds: NotRequired["capo_redshift.types.long.Long"]
    """<p>The amount of time an in-progress snapshot backup has been running, or the amount of time it took a completed backup to finish.</p>"""
    source_region: NotRequired["capo_redshift.types.string.String"]
    """<p>The source region from which the snapshot was copied.</p>"""
    tags: NotRequired["capo_redshift.types.tag_list.TagList"]
    """<p>The list of tags for the cluster snapshot.</p>"""
    restorable_node_types: NotRequired[
        "capo_redshift.types.restorable_node_type_list.RestorableNodeTypeList"
    ]
    """<p>The list of node types that this cluster snapshot is able to restore into.</p>"""
    enhanced_vpc_routing: NotRequired["capo_redshift.types.boolean.Boolean"]
    """<p>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 <a href="https://docs.aws.amazon.com/redshift/latest/mgmt/enhanced-vpc-routing.html">Enhanced VPC Routing</a> in the Amazon Redshift Cluster Management Guide.</p> <p>If this option is <code>true</code>, enhanced VPC routing is enabled. </p> <p>Default: false</p>"""
    maintenance_track_name: NotRequired["capo_redshift.types.string.String"]
    """<p>The name of the maintenance track for the snapshot.</p>"""
    manual_snapshot_retention_period: NotRequired[
        "capo_redshift.types.integer_optional.IntegerOptional"
    ]
    """<p>The number of days that a manual snapshot is retained. If the value is -1, the manual snapshot is retained indefinitely. </p> <p>The value must be either -1 or an integer between 1 and 3,653.</p>"""
    manual_snapshot_remaining_days: NotRequired[
        "capo_redshift.types.integer_optional.IntegerOptional"
    ]
    """<p>The number of days until a manual snapshot will pass its retention period.</p>"""
    snapshot_retention_start_time: NotRequired["capo_redshift.types.t_stamp.TStamp"]
    """<p>A timestamp representing the start of the retention period for the snapshot.</p>"""
    master_password_secret_arn: NotRequired["capo_redshift.types.string.String"]
    """<p>The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.</p>"""
    master_password_secret_kms_key_id: NotRequired["capo_redshift.types.string.String"]
    """<p>The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.</p>"""
    snapshot_arn: NotRequired["capo_redshift.types.string.String"]
    """<p>The Amazon Resource Name (ARN) of the snapshot.</p>"""

accounts_with_restore_access instance-attribute

accounts_with_restore_access: NotRequired[AccountsWithRestoreAccessList]

A list of the Amazon Web Services accounts authorized to restore the snapshot. Returns null if no accounts are authorized. Visible only to the snapshot owner.

actual_incremental_backup_size_in_mega_bytes instance-attribute

actual_incremental_backup_size_in_mega_bytes: NotRequired[Double]

The size of the incremental backup.

availability_zone instance-attribute

availability_zone: NotRequired[String]

The Availability Zone in which the cluster was created.

backup_progress_in_mega_bytes instance-attribute

backup_progress_in_mega_bytes: NotRequired[Double]

The number of megabytes that have been transferred to the snapshot backup.

cluster_create_time instance-attribute

cluster_create_time: NotRequired[TStamp]

The time (UTC) when the cluster was originally created.

cluster_identifier instance-attribute

cluster_identifier: NotRequired[String]

The identifier of the cluster for which the snapshot was taken.

cluster_version instance-attribute

cluster_version: NotRequired[String]

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

current_backup_rate_in_mega_bytes_per_second instance-attribute

current_backup_rate_in_mega_bytes_per_second: NotRequired[Double]

The number of megabytes per second being transferred to the snapshot backup. Returns 0 for a completed backup.

db_name instance-attribute

db_name: NotRequired[String]

The name of the database that was created when the cluster was created.

elapsed_time_in_seconds instance-attribute

elapsed_time_in_seconds: NotRequired[Long]

The amount of time an in-progress snapshot backup has been running, or the amount of time it took a completed backup to finish.

encrypted instance-attribute

encrypted: NotRequired[Boolean]

If true, the data in the snapshot is encrypted at rest.

encrypted_with_hsm instance-attribute

encrypted_with_hsm: NotRequired[Boolean]

A boolean that indicates whether the snapshot data is encrypted using the HSM keys of the source cluster. true indicates that the data is encrypted using HSM keys.

engine_full_version instance-attribute

engine_full_version: NotRequired[String]

The cluster version of the cluster used to create the snapshot. For example, 1.0.15503.

enhanced_vpc_routing instance-attribute

enhanced_vpc_routing: NotRequired[Boolean]

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

estimated_seconds_to_completion instance-attribute

estimated_seconds_to_completion: NotRequired[Long]

The estimate of the time remaining before the snapshot backup will complete. Returns 0 for a completed backup.

kms_key_id instance-attribute

kms_key_id: NotRequired[String]

The Key Management Service (KMS) key ID of the encryption key that was used to encrypt data in the cluster from which the snapshot was taken.

maintenance_track_name instance-attribute

maintenance_track_name: NotRequired[String]

The name of the maintenance track for the snapshot.

manual_snapshot_remaining_days instance-attribute

manual_snapshot_remaining_days: NotRequired[IntegerOptional]

The number of days until a manual snapshot will pass its retention period.

manual_snapshot_retention_period instance-attribute

manual_snapshot_retention_period: NotRequired[IntegerOptional]

The number of days that a manual snapshot is retained. If the value is -1, the manual snapshot is retained indefinitely.

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

master_password_secret_arn instance-attribute

master_password_secret_arn: NotRequired[String]

The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.

master_password_secret_kms_key_id instance-attribute

master_password_secret_kms_key_id: NotRequired[String]

The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.

master_username instance-attribute

master_username: NotRequired[String]

The admin user name for the cluster.

node_type instance-attribute

node_type: NotRequired[String]

The node type of the nodes in the cluster.

number_of_nodes instance-attribute

number_of_nodes: NotRequired[Integer]

The number of nodes in the cluster.

owner_account instance-attribute

owner_account: NotRequired[String]

For manual snapshots, the Amazon Web Services account used to create or copy the snapshot. For automatic snapshots, the owner of the cluster. The owner can perform all snapshot actions, such as sharing a manual snapshot.

port instance-attribute

port: NotRequired[Integer]

The port that the cluster is listening on.

restorable_node_types instance-attribute

restorable_node_types: NotRequired[RestorableNodeTypeList]

The list of node types that this cluster snapshot is able to restore into.

snapshot_arn instance-attribute

snapshot_arn: NotRequired[String]

The Amazon Resource Name (ARN) of the snapshot.

snapshot_create_time instance-attribute

snapshot_create_time: NotRequired[TStamp]

The time (in UTC format) when Amazon Redshift began the snapshot. A snapshot contains a copy of the cluster data as of this exact time.

snapshot_identifier instance-attribute

snapshot_identifier: NotRequired[String]

The snapshot identifier that is provided in the request.

snapshot_retention_start_time instance-attribute

snapshot_retention_start_time: NotRequired[TStamp]

A timestamp representing the start of the retention period for the snapshot.

snapshot_type instance-attribute

snapshot_type: NotRequired[String]

The snapshot type. Snapshots created using CreateClusterSnapshot and CopyClusterSnapshot are of type "manual".

source_region instance-attribute

source_region: NotRequired[String]

The source region from which the snapshot was copied.

status instance-attribute

status: NotRequired[String]

The snapshot status. The value of the status depends on the API operation used:

tags instance-attribute

tags: NotRequired[TagList]

The list of tags for the cluster snapshot.

total_backup_size_in_mega_bytes instance-attribute

total_backup_size_in_mega_bytes: NotRequired[Double]

The size of the complete set of backup data that would be used to restore the cluster.

vpc_id instance-attribute

vpc_id: NotRequired[String]

The VPC identifier of the cluster if the snapshot is from a cluster in a VPC. Otherwise, this field is not in the output.