Listing volumes

GET /v3/{project_id}/volumes

List summary information for all block storage volumes that the project can access.

Source: https://docs.openstack.org/api-ref/block-storage/v3/index.html?expanded=list-accessible-volumes-detail#list-accessible-volumes

Request

Parameters

Name	In	Type	Description
`project_id`	path	string	The UUID of the project in a multi-tenancy cloud.
`created_at` (Optional)	query	string	Filters results by a time that resources are created at with time comparison operators: `gt`, `gte`, `eq`, `neq`, `lt`, `lte`. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In this example, the offset value is `-05:00`. New in version 3.60
`updated_at` (Optional)	query	string	Filters results by a time that resources are updated at with time comparison operators: `gt`, `gte`, `eq`, `neq`, `lt`, `lte`. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In this example, the offset value is `-05:00`. New in version 3.60
`all_tenants` (Optional)	query	string	Shows details for all projects. Admin only.
`sort` (Optional)	query	string	Comma-separated list of sort keys and optional sort directions in the form of `<key>[:<direction>]`. A valid direction is `asc` (ascending) or `desc` (descending).
`limit` (Optional)	query	integer	Requests a page size of items. Returns a number of items up to a limit value. Use the `limit` parameter to make an initial limited request and use the ID of the last-seen item from the response as the `marker` parameter value in a subsequent limited request.
`offset` (Optional)	query	integer	Used in conjunction with `limit` to return a slice of items. `offset` is where to start in the list.
`marker` (Optional)	query	string	The ID of the last-seen item. Use the `limit` parameter to make an initial limited request and use the ID of the last-seen item from the response as the `marker` parameter value in a subsequent limited request.
`with_count` (Optional)	query	boolean	Whether to show `count` in API response or not, default is `false`. New in version 3.45

Example

# curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:8776/v3/f5d834d636c642c7bfe8af86139c6f26/volumes

Response

Parameters

Name	In	Type	Description
`volumes`	body	array	A list of `volume` objects.
`id`	body	string	The UUID of the volume.
`links`	body	array	The volume links.
`name`	body	string	The volume name.
`volumes_links` (Optional)	body	array	The volume links.
`count` (Optional)	body	integer	The total count of requested resource before pagination is applied. New in version 3.45

Status codes

Success

Code	Reason
`200 - OK`	Request was successful.

Error

Code	Reason
`400 - Bad Request`	Some content in the request was invalid.

Example

{
  "volumes": [
    {
      "id": "cb623b3c-f14a-48d6-a339-d9fda95be662",
      "links": [
        {
          "href": "https://<node_IP_addr>:8776/v3/f5d834d636c642c7bfe8af86139c6f26/volumes/cb623b3c-f14a-48d6-a339-d9fda95be662",
          "rel": "self"
        },
        {
          "href": "https://<node_IP_addr>:8776/f5d834d636c642c7bfe8af86139c6f26/volumes/cb623b3c-f14a-48d6-a339-d9fda95be662",
          "rel": "bookmark"
        }
      ],
      "name": "vol1"
    },
    {
      "id": "76736e1a-ad97-4599-8ca8-476650459310",
      "links": [
        {
          "href": "https://<node_IP_addr>:8776/v3/f5d834d636c642c7bfe8af86139c6f26/volumes/76736e1a-ad97-4599-8ca8-476650459310",
          "rel": "self"
        },
        {
          "href": "https://<node_IP_addr>:8776/f5d834d636c642c7bfe8af86139c6f26/volumes/76736e1a-ad97-4599-8ca8-476650459310",
          "rel": "bookmark"
        }
      ],
      "name": "vm1/cirros/Boot volume"
    }
  ]
}