Merge pull request #101 from thaJeztah/18.09_backport_document_service_version

[18.09 backport] Add more API doc details on service update version. Upstream-commit: 2822d49c10dd658dd8caf3f1933f28498e022cf9 Component: engine
2018-10-30 13:14:04 -07:00
parent 93dbc410da 5425e3a895
commit 25ad6f737d
1 changed files with 4 additions and 1 deletions
@@ -9345,7 +9345,10 @@ paths:

        - name: "version"
          in: "query"
-          description: "The version number of the service object being updated. This is required to avoid conflicting writes."
+          description: "The version number of the service object being updated.
+          This is required to avoid conflicting writes.
+          This version number should be the value as currently set on the service *before* the update.
+          You can find the current version by calling `GET /services/{id}`"
          required: true
          type: "integer"
        - name: "registryAuthFrom"