diff options
author | Brian Coca <bcoca@ansible.com> | 2016-03-02 10:21:46 -0500 |
---|---|---|
committer | Brian Coca <bcoca@ansible.com> | 2016-03-02 10:21:46 -0500 |
commit | 15c938f2a25972b38a775680b440df592495de7c (patch) | |
tree | 1d14edef98be7201aa6b97e831d9b43318fd842f /docs | |
parent | 4b5bb5dd896e468d6626f724f82047d50c2a2f55 (diff) | |
parent | d0137abf9848f4653bd4b52123a59d163cf25ef4 (diff) | |
download | ansible-15c938f2a25972b38a775680b440df592495de7c.tar.gz |
Merge pull request #14740 from chouseknecht/docker_volume_facts_proposal
Adding docker_volume_facts module proposal
Diffstat (limited to 'docs')
-rw-r--r-- | docs/proposals/docker/docker_volume_facts.md | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/docs/proposals/docker/docker_volume_facts.md b/docs/proposals/docker/docker_volume_facts.md new file mode 100644 index 0000000000..119df27e33 --- /dev/null +++ b/docs/proposals/docker/docker_volume_facts.md @@ -0,0 +1,48 @@ + +# Docker_Volume_Facts Module Proposal + +## Purpose and Scope + +Docker_volume_facts will inspect volumes. + +Docker_volume_facts will use docker-py to communicate with either a local or remote API. It will +support API versions >= 1.14. API connection details will be handled externally in a shared utility module similar +to how other cloud modules operate. + +## Parameters + +Docker_volume_facts will accept the parameters listed below. API connection parameters will be part of a shared +utility module as mentioned above. + + +``` +name: + description: + - Volume name or list of volume names. + default: null +``` + + +## Examples + +``` +- name: Inspect all volumes + docker_volume_facts + register: volume_facts + +- name: Inspect a specific volume + docker_volume_facts: + name: data + register: data_vol_facts +``` + +# Returns + +``` +{ + changed: False + failed: False + rc: 0 + results: [ < output from volume inspection > ] +} +```
\ No newline at end of file |