Adding docker_volume_facts module proposal

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