api: clarify "v" option behavior in the container remove endpoint

Current description of the "v" option doesn't explain what happens to
the volumes that are still in use by other containers. Turns out that
the only volumes that are removed are unnamed ones[1].

Perhaps a good way of clarifying this behavior would be adapting the
description from "docker rm --help".

As for the docs/api/v1.*.yaml changes — they seem to be applicable,
since the origin of this behavior dates way back to the 2016 or v1.11[2].

[1]: a24a71c50f/daemon/mounts.go (L34-L38)
[2]: dd7d1c8a02

Signed-off-by: Nikolay Edigaryev <edigaryev@gmail.com>
This commit is contained in:
Nikolay Edigaryev 2020-09-23 12:22:10 +03:00
parent a24a71c50f
commit 7afef854ed
17 changed files with 17 additions and 17 deletions

View file

@ -6923,7 +6923,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4021,7 +4021,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4026,7 +4026,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4101,7 +4101,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4193,7 +4193,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4227,7 +4227,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4450,7 +4450,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -4520,7 +4520,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5757,7 +5757,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5762,7 +5762,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5798,7 +5798,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5785,7 +5785,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5809,7 +5809,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5836,7 +5836,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -5897,7 +5897,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -6617,7 +6617,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"

View file

@ -6755,7 +6755,7 @@ paths:
type: "string" type: "string"
- name: "v" - name: "v"
in: "query" in: "query"
description: "Remove the volumes associated with the container." description: "Remove anonymous volumes associated with the container."
type: "boolean" type: "boolean"
default: false default: false
- name: "force" - name: "force"