DocDB / Client / delete_db_cluster_snapshot
delete_db_cluster_snapshot#
- DocDB.Client.delete_db_cluster_snapshot(**kwargs)#
Deletes a cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
Note
The cluster snapshot must be in the
available
state to be deleted.See also: AWS API Documentation
Request Syntax
response = client.delete_db_cluster_snapshot( DBClusterSnapshotIdentifier='string' )
- Parameters:
DBClusterSnapshotIdentifier (string) –
[REQUIRED]
The identifier of the cluster snapshot to delete.
Constraints: Must be the name of an existing 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', 'Status': 'string', 'Port': 123, 'VpcId': 'string', 'ClusterCreateTime': datetime(2015, 1, 1), 'MasterUsername': 'string', 'EngineVersion': 'string', 'SnapshotType': 'string', 'PercentProgress': 123, 'StorageEncrypted': True|False, 'KmsKeyId': 'string', 'DBClusterSnapshotArn': 'string', 'SourceDBClusterSnapshotArn': 'string', 'StorageType': 'string' } }
Response Structure
(dict) –
DBClusterSnapshot (dict) –
Detailed information about a cluster snapshot.
AvailabilityZones (list) –
Provides the list of Amazon EC2 Availability Zones that instances in the cluster snapshot can be restored in.
(string) –
DBClusterSnapshotIdentifier (string) –
Specifies the identifier for the cluster snapshot.
DBClusterIdentifier (string) –
Specifies the cluster identifier of the cluster that this cluster snapshot was created from.
SnapshotCreateTime (datetime) –
Provides the time when the snapshot was taken, in UTC.
Engine (string) –
Specifies the name of the database engine.
Status (string) –
Specifies the status of this cluster snapshot.
Port (integer) –
Specifies the port that the cluster was listening on at the time of the snapshot.
VpcId (string) –
Provides the virtual private cloud (VPC) ID that is associated with the cluster snapshot.
ClusterCreateTime (datetime) –
Specifies the time when the cluster was created, in Universal Coordinated Time (UTC).
MasterUsername (string) –
Provides the master user name for the cluster snapshot.
EngineVersion (string) –
Provides the version of the database engine for this cluster snapshot.
SnapshotType (string) –
Provides the type of the cluster snapshot.
PercentProgress (integer) –
Specifies the percentage of the estimated data that has been transferred.
StorageEncrypted (boolean) –
Specifies whether the cluster snapshot is encrypted.
KmsKeyId (string) –
If
StorageEncrypted
istrue
, the KMS key identifier for the encrypted cluster snapshot.DBClusterSnapshotArn (string) –
The Amazon Resource Name (ARN) for the cluster snapshot.
SourceDBClusterSnapshotArn (string) –
If the cluster snapshot was copied from a source cluster snapshot, the ARN for the source cluster snapshot; otherwise, a null value.
StorageType (string) –
Storage type associated with your cluster snapshot
For information on storage types for Amazon DocumentDB clusters, see Cluster storage configurations in the Amazon DocumentDB Developer Guide.
Valid values for storage type -
standard | iopt1
Default value is
standard
Exceptions
DocDB.Client.exceptions.InvalidDBClusterSnapshotStateFault
DocDB.Client.exceptions.DBClusterSnapshotNotFoundFault