RDS / Client / delete_db_cluster_snapshot

delete_db_cluster_snapshot

RDS.Client.delete_db_cluster_snapshot(**kwargs)

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

Note

The DB cluster snapshot must be in the available state to be deleted.

For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.

See also: AWS API Documentation

Request Syntax

response = client.delete_db_cluster_snapshot(
    DBClusterSnapshotIdentifier='string'
)

Parameters:

DBClusterSnapshotIdentifier (string) –

[REQUIRED]

The identifier of the DB cluster snapshot to delete.

Constraints: Must be the name of an existing DB cluster snapshot in the available state.

Return type:

dict

Returns:

Response Syntax

{
    'DBClusterSnapshot': {
        'AvailabilityZones': [
            'string',
        ],
        'DBClusterSnapshotIdentifier': 'string',
        'DBClusterIdentifier': 'string',
        'SnapshotCreateTime': datetime(2015, 1, 1),
        'Engine': 'string',
        'EngineMode': 'string',
        'AllocatedStorage': 123,
        'Status': 'string',
        'Port': 123,
        'VpcId': 'string',
        'ClusterCreateTime': datetime(2015, 1, 1),
        'MasterUsername': 'string',
        'EngineVersion': 'string',
        'LicenseModel': 'string',
        'SnapshotType': 'string',
        'PercentProgress': 123,
        'StorageEncrypted': True|False,
        'KmsKeyId': 'string',
        'DBClusterSnapshotArn': 'string',
        'SourceDBClusterSnapshotArn': 'string',
        'IAMDatabaseAuthenticationEnabled': True|False,
        'TagList': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ],
        'DBSystemId': 'string',
        'StorageType': 'string',
        'DbClusterResourceId': 'string',
        'StorageThroughput': 123
    }
}

Response Structure

• (dict) –

  • DBClusterSnapshot (dict) –

    Contains the details for an Amazon RDS DB cluster snapshot

    This data type is used as a response element in the DescribeDBClusterSnapshots action.

    • AvailabilityZones (list) –

      The list of Availability Zones (AZs) where instances in the DB cluster snapshot can be restored.

      • (string) –

    • DBClusterSnapshotIdentifier (string) –

      The identifier for the DB cluster snapshot.

    • DBClusterIdentifier (string) –

      The DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.

    • SnapshotCreateTime (datetime) –

      The time when the snapshot was taken, in Universal Coordinated Time (UTC).

    • Engine (string) –

      The name of the database engine for this DB cluster snapshot.

    • EngineMode (string) –

      The engine mode of the database engine for this DB cluster snapshot.

    • AllocatedStorage (integer) –

      The allocated storage size of the DB cluster snapshot in gibibytes (GiB).

    • Status (string) –

      The status of this DB cluster snapshot. Valid statuses are the following:

      • available

      • copying

      • creating

    • Port (integer) –

      The port that the DB cluster was listening on at the time of the snapshot.

    • VpcId (string) –

      The VPC ID associated with the DB cluster snapshot.

    • ClusterCreateTime (datetime) –

      The time when the DB cluster was created, in Universal Coordinated Time (UTC).

    • MasterUsername (string) –

      The master username for this DB cluster snapshot.

    • EngineVersion (string) –

      The version of the database engine for this DB cluster snapshot.

    • LicenseModel (string) –

      The license model information for this DB cluster snapshot.

    • SnapshotType (string) –

      The type of the DB cluster snapshot.

    • PercentProgress (integer) –

      The percentage of the estimated data that has been transferred.

    • StorageEncrypted (boolean) –

      Indicates whether the DB cluster snapshot is encrypted.

    • KmsKeyId (string) –

      If StorageEncrypted is true, the Amazon Web Services KMS key identifier for the encrypted DB cluster snapshot.

      The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

    • DBClusterSnapshotArn (string) –

      The Amazon Resource Name (ARN) for the DB cluster snapshot.

    • SourceDBClusterSnapshotArn (string) –

      If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.

    • IAMDatabaseAuthenticationEnabled (boolean) –

      Indicates whether mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts is enabled.

    • TagList (list) –

      A list of tags. For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide.

      • (dict) –

        Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

        For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide.

        • Key (string) –

          A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can’t be prefixed with aws: or rds:. The string can only contain only the set of Unicode letters, digits, white-space, ‘_’, ‘.’, ‘:’, ‘/’, ‘=’, ‘+’, ‘-’, ‘@’ (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

        • Value (string) –

          A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can’t be prefixed with aws: or rds:. The string can only contain only the set of Unicode letters, digits, white-space, ‘_’, ‘.’, ‘:’, ‘/’, ‘=’, ‘+’, ‘-’, ‘@’ (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

    • DBSystemId (string) –

      Reserved for future use.

    • StorageType (string) –

      The storage type associated with the DB cluster snapshot.

      This setting is only for Aurora DB clusters.

    • DbClusterResourceId (string) –

      The resource ID of the DB cluster that this DB cluster snapshot was created from.

    • StorageThroughput (integer) –

      The storage throughput for the DB cluster snapshot. The throughput is automatically set based on the IOPS that you provision, and is not configurable.

      This setting is only for non-Aurora Multi-AZ DB clusters.

Exceptions

• RDS.Client.exceptions.InvalidDBClusterSnapshotStateFault

• RDS.Client.exceptions.DBClusterSnapshotNotFoundFault

Examples

This example deletes the specified DB cluster snapshot.

response = client.delete_db_cluster_snapshot(
    DBClusterSnapshotIdentifier='mydbclustersnapshot',
)

print(response)

Expected Output:

{
    'DBClusterSnapshot': {
    },
    'ResponseMetadata': {
        '...': '...',
    },
}