:doc:`DocDB <../../docdb>` / Client / delete_db_cluster_snapshot

**************************
delete_db_cluster_snapshot
**************************



.. py:method:: 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 <https://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DeleteDBClusterSnapshot>`_  


  **Request Syntax**
  ::

    response = client.delete_db_cluster_snapshot(
        DBClusterSnapshotIdentifier='string'
    )
    
  :type DBClusterSnapshotIdentifier: string
  :param DBClusterSnapshotIdentifier: **[REQUIRED]** 

    The identifier of the cluster snapshot to delete.

     

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

    

  
  
  :rtype: 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`` is ``true``, 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**
  
  *   :py:class:`DocDB.Client.exceptions.InvalidDBClusterSnapshotStateFault`

  
  *   :py:class:`DocDB.Client.exceptions.DBClusterSnapshotNotFoundFault`

  