2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "volume inspect"
|
|
|
|
description: "The volume inspect command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "volume, inspect"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2016-10-19 13:25:45 -04:00
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
|
|
repository at https://github.com/docker/docker/. Make all
|
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
will be rejected.
|
|
|
|
-->
|
|
|
|
|
2015-06-12 09:25:32 -04:00
|
|
|
# volume inspect
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
|
|
|
Usage: docker volume inspect [OPTIONS] VOLUME [VOLUME...]
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Display detailed information on one or more volumes
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Options:
|
2016-10-18 06:50:11 -04:00
|
|
|
-f, --format string Format the output using the given Go template
|
2016-07-07 14:43:18 -04:00
|
|
|
--help Print usage
|
|
|
|
```
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Description
|
|
|
|
|
2015-06-12 09:25:32 -04:00
|
|
|
Returns information about a volume. By default, this command renders all results
|
2015-11-18 10:02:24 -05:00
|
|
|
in a JSON array. You can specify an alternate format to execute a
|
|
|
|
given template for each result. Go's
|
2015-06-12 09:25:32 -04:00
|
|
|
[text/template](http://golang.org/pkg/text/template/) package describes all the
|
|
|
|
details of the format.
|
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker volume create
|
|
|
|
85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d
|
|
|
|
$ docker volume inspect 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d
|
|
|
|
[
|
|
|
|
{
|
|
|
|
"Name": "85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d",
|
|
|
|
"Driver": "local",
|
|
|
|
"Mountpoint": "/var/lib/docker/volumes/85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d/_data",
|
|
|
|
"Status": null
|
|
|
|
}
|
|
|
|
]
|
|
|
|
|
|
|
|
$ docker volume inspect --format '{{ .Mountpoint }}' 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d
|
|
|
|
/var/lib/docker/volumes/85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d/_data
|
|
|
|
```
|
|
|
|
|
|
|
|
## Related commands
|
2016-02-18 14:52:15 -05:00
|
|
|
|
|
|
|
* [volume create](volume_create.md)
|
|
|
|
* [volume ls](volume_ls.md)
|
|
|
|
* [volume rm](volume_rm.md)
|
2016-10-18 06:50:11 -04:00
|
|
|
* [volume prune](volume_prune.md)
|
2016-10-17 12:04:52 -04:00
|
|
|
* [Understand Data Volumes](https://docs.docker.com/engine/tutorials/dockervolumes/)
|