Skip to content

EC2  >  Operations  >  delete_volume

delete_volume

Operation

delete_volume async 

delete_volume(input: DeleteVolumeInput, plugins: list[Plugin] | None = None) -> DeleteVolumeOutput

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 in the Amazon EBS User Guide.

Parameters:

Name Type Description Default
input DeleteVolumeInput

An instance of DeleteVolumeInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
DeleteVolumeOutput

An instance of DeleteVolumeOutput.

Input

DeleteVolumeInput dataclass

Bases: _SerdeShape

Dataclass for DeleteVolumeInput structure.

Attributes

dry_run class-attribute instance-attribute 
dry_run: bool | None = ...

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.

volume_id class-attribute instance-attribute 
volume_id: str | None = ...

The ID of the volume.

Output

DeleteVolumeOutput dataclass

Bases: _SerdeShape

Dataclass for DeleteVolumeOutput structure.

Attributes

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.