:doc:`EC2 <../../ec2>` / Client / delete_volume

*************
delete_volume
*************



.. py:method:: EC2.Client.delete_volume(**kwargs)

  

  Deletes the specified EBS volume. The volume must be in the ``available`` state (not attached to an instance).

   

  The volume can remain in the ``deleting`` state for several minutes.

   

  For more information, see `Delete an Amazon EBS volume <https://docs.aws.amazon.com/ebs/latest/userguide/ebs-deleting-volume.html>`__ in the *Amazon EBS User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DeleteVolume>`_  


  **Request Syntax**
  ::

    response = client.delete_volume(
        VolumeId='string',
        DryRun=True|False
    )
    
  :type VolumeId: string
  :param VolumeId: **[REQUIRED]** 

    The ID of the volume.

    

  
  :type DryRun: boolean
  :param DryRun: 

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ``DryRunOperation``. Otherwise, it is ``UnauthorizedOperation``.

    

  
  
  :returns: None

  **Examples**

  This example deletes an available volume with the volume ID of ``vol-049df61146c4d7901``. If the command succeeds, no output is returned.
  ::

    response = client.delete_volume(
        VolumeId='vol-049df61146c4d7901',
    )
    
    print(response)

  
  Expected Output:
  ::

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

  