DescribeVolumes

Description

Describes the specified volumes.

Request Parameters

  • VolumeId.n - One or more volume IDs
    • Type: String
    • Required: No
  • Filter.n.Name - The name of the filter
    • Type: String
    • Default: None
    • Required: No
  • Filter.n.Value.n - One or more filter values. Filter values are case-sensitive
    • Type: String
    • Default: None
    • Required: No

Supported filters

  • attachment.instance-id - The ID of the instance the volume is attached to.
  • attachment.device - The device name that is exposed to the instance (for example, disk1).
  • attachment.status - The attachment state (attaching | attached | detaching | detached).
  • availability-zone - The Availability Zone in which the volume was created (ru-msk-comp1p | ru-msk-vol51).
  • create-time - The timestamp when the volume was created.
  • size - The size of the volume, in GiB.
  • snapshot-id - The snapshot from which the volume was created.
  • status - The status of the volume (creating | available | in-use | running | deleting | deleted | error).
  • tag:<key> - Key/value pair of the Tag. Tag key is passed in the name of a filter, Tag value – in the value of the filter
  • tag-key - Tag key. This filter is used to get VPCs with Tag with the specified key and any value
  • volume-id - The ID of the volume.
  • volume-type - The type of the volume (st2 | io1).

Response Elements

  • requestId - The ID of the request
  • volumeSet - Information about the volumes

Examples

c2-ec2 DescribeVolumes

c2-ec2 DescribeVolumes VolumeId.1 <volume_id>

c2-ec2 DescribeVolumes Filter.1.Name availability-zone Filter.1.Value.1 ru-msk-vol51

c2-ec2 DescribeVolumes Filter.1.Name tag:<tag-key> Filter.1.Value.1 <tag-value>