Skip to content

Snapshot

Source code in docs_src/capo_ec2/types/snapshot.py
class Snapshot(TypedDict, closed=True):
    owner_alias: NotRequired["capo_ec2.types.string.String"]
    """<p>The Amazon Web Services owner alias, from an Amazon-maintained list (<code>amazon</code>). This is not the user-configured Amazon Web Services account alias set using the IAM console.</p>"""
    outpost_arn: NotRequired["capo_ec2.types.string.String"]
    """<p>The ARN of the Outpost on which the snapshot is stored. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html">Amazon EBS local snapshots on Outposts</a> in the <i>Amazon EBS User Guide</i>.</p>"""
    tags: NotRequired["capo_ec2.types.tag_list.TagList"]
    """<p>Any tags assigned to the snapshot.</p>"""
    storage_tier: NotRequired["capo_ec2.types.storage_tier.StorageTier"]
    """<p>The storage tier in which the snapshot is stored. <code>standard</code> indicates that the snapshot is stored in the standard snapshot storage tier and that it is ready for use. <code>archive</code> indicates that the snapshot is currently archived and that it must be restored before it can be used.</p>"""
    restore_expiry_time: NotRequired[
        "capo_ec2.types.millisecond_date_time.MillisecondDateTime"
    ]
    """<p>Only for archived snapshots that are temporarily restored. Indicates the date and time when a temporarily restored snapshot will be automatically re-archived.</p>"""
    sse_type: NotRequired["capo_ec2.types.sse_type.SSEType"]
    """<p>Reserved for future use.</p>"""
    availability_zone: NotRequired["capo_ec2.types.string.String"]
    """<p>The Availability Zone or Local Zone of the snapshot. For example, <code>us-west-1a</code> (Availability Zone) or <code>us-west-2-lax-1a</code> (Local Zone).</p>"""
    transfer_type: NotRequired["capo_ec2.types.transfer_type.TransferType"]
    """<note> <p>Only for snapshot copies.</p> </note> <p>Indicates whether the snapshot copy was created with a standard or time-based snapshot copy operation. Time-based snapshot copy operations complete within the completion duration specified in the request. Standard snapshot copy operations are completed on a best-effort basis.</p> <ul> <li> <p> <code>standard</code> - The snapshot copy was created with a standard snapshot copy operation.</p> </li> <li> <p> <code>time-based</code> - The snapshot copy was created with a time-based snapshot copy operation.</p> </li> </ul>"""
    completion_duration_minutes: NotRequired[
        "capo_ec2.types.snapshot_completion_duration_minutes_response.SnapshotCompletionDurationMinutesResponse"
    ]
    """<note> <p>Only for snapshot copies created with time-based snapshot copy operations.</p> </note> <p>The completion duration requested for the time-based snapshot copy operation.</p>"""
    completion_time: NotRequired[
        "capo_ec2.types.millisecond_date_time.MillisecondDateTime"
    ]
    """<p>The time stamp when the snapshot was completed.</p>"""
    full_snapshot_size_in_bytes: NotRequired["capo_ec2.types.long.Long"]
    """<p>The full size of the snapshot, in bytes.</p> <important> <p>This is <b>not</b> the incremental size of the snapshot. This is the full snapshot size and represents the size of all the blocks that were written to the source volume at the time the snapshot was created.</p> </important>"""
    snapshot_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the snapshot. Each snapshot receives a unique identifier when it is created.</p>"""
    volume_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the volume that was used to create the snapshot. Snapshots created by a copy snapshot operation have an arbitrary volume ID that you should not use for any purpose.</p>"""
    state: NotRequired["capo_ec2.types.snapshot_state.SnapshotState"]
    """<p>The snapshot state.</p>"""
    state_message: NotRequired["capo_ec2.types.string.String"]
    """<p>Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper KMS permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by <a>DescribeSnapshots</a>.</p>"""
    start_time: NotRequired["capo_ec2.types.date_time.DateTime"]
    """<p>The time stamp when the snapshot was initiated.</p>"""
    progress: NotRequired["capo_ec2.types.string.String"]
    """<p>The progress of the snapshot, as a percentage.</p>"""
    owner_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the Amazon Web Services account that owns the EBS snapshot.</p>"""
    description: NotRequired["capo_ec2.types.string.String"]
    """<p>The description for the snapshot.</p>"""
    volume_size: NotRequired["capo_ec2.types.integer.Integer"]
    """<p>The size of the volume, in GiB.</p>"""
    encrypted: NotRequired["capo_ec2.types.boolean.Boolean"]
    """<p>Indicates whether the snapshot is encrypted.</p>"""
    kms_key_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The Amazon Resource Name (ARN) of the KMS key that was used to protect the volume encryption key for the parent volume.</p>"""
    data_encryption_key_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by <a>DescribeSnapshots</a>.</p>"""

availability_zone instance-attribute

availability_zone: NotRequired[String]

The Availability Zone or Local Zone of the snapshot. For example, us-west-1a (Availability Zone) or us-west-2-lax-1a (Local Zone).

completion_duration_minutes instance-attribute

completion_duration_minutes: NotRequired[SnapshotCompletionDurationMinutesResponse]

Only for snapshot copies created with time-based snapshot copy operations.

The completion duration requested for the time-based snapshot copy operation.

completion_time instance-attribute

completion_time: NotRequired[MillisecondDateTime]

The time stamp when the snapshot was completed.

data_encryption_key_id instance-attribute

data_encryption_key_id: NotRequired[String]

The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by DescribeSnapshots.

description instance-attribute

description: NotRequired[String]

The description for the snapshot.

encrypted instance-attribute

encrypted: NotRequired[Boolean]

Indicates whether the snapshot is encrypted.

full_snapshot_size_in_bytes instance-attribute

full_snapshot_size_in_bytes: NotRequired[Long]

The full size of the snapshot, in bytes.

This is not the incremental size of the snapshot. This is the full snapshot size and represents the size of all the blocks that were written to the source volume at the time the snapshot was created.

kms_key_id instance-attribute

kms_key_id: NotRequired[String]

The Amazon Resource Name (ARN) of the KMS key that was used to protect the volume encryption key for the parent volume.

outpost_arn instance-attribute

outpost_arn: NotRequired[String]

The ARN of the Outpost on which the snapshot is stored. For more information, see Amazon EBS local snapshots on Outposts in the Amazon EBS User Guide.

owner_alias instance-attribute

owner_alias: NotRequired[String]

The Amazon Web Services owner alias, from an Amazon-maintained list (amazon). This is not the user-configured Amazon Web Services account alias set using the IAM console.

owner_id instance-attribute

owner_id: NotRequired[String]

The ID of the Amazon Web Services account that owns the EBS snapshot.

progress instance-attribute

progress: NotRequired[String]

The progress of the snapshot, as a percentage.

restore_expiry_time instance-attribute

restore_expiry_time: NotRequired[MillisecondDateTime]

Only for archived snapshots that are temporarily restored. Indicates the date and time when a temporarily restored snapshot will be automatically re-archived.

snapshot_id instance-attribute

snapshot_id: NotRequired[String]

The ID of the snapshot. Each snapshot receives a unique identifier when it is created.

sse_type instance-attribute

sse_type: NotRequired[SSEType]

Reserved for future use.

start_time instance-attribute

start_time: NotRequired[DateTime]

The time stamp when the snapshot was initiated.

state instance-attribute

state: NotRequired[SnapshotState]

The snapshot state.

state_message instance-attribute

state_message: NotRequired[String]

Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper KMS permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by DescribeSnapshots.

storage_tier instance-attribute

storage_tier: NotRequired[StorageTier]

The storage tier in which the snapshot is stored. standard indicates that the snapshot is stored in the standard snapshot storage tier and that it is ready for use. archive indicates that the snapshot is currently archived and that it must be restored before it can be used.

tags instance-attribute

tags: NotRequired[TagList]

Any tags assigned to the snapshot.

transfer_type instance-attribute

transfer_type: NotRequired[TransferType]

Only for snapshot copies.

Indicates whether the snapshot copy was created with a standard or time-based snapshot copy operation. Time-based snapshot copy operations complete within the completion duration specified in the request. Standard snapshot copy operations are completed on a best-effort basis.

  • standard - The snapshot copy was created with a standard snapshot copy operation.

  • time-based - The snapshot copy was created with a time-based snapshot copy operation.

volume_id instance-attribute

volume_id: NotRequired[String]

The ID of the volume that was used to create the snapshot. Snapshots created by a copy snapshot operation have an arbitrary volume ID that you should not use for any purpose.

volume_size instance-attribute

volume_size: NotRequired[Integer]

The size of the volume, in GiB.