diff options
author | tengqm <tengqim@cn.ibm.com> | 2016-08-19 05:01:19 -0400 |
---|---|---|
committer | tengqm <tengqim@cn.ibm.com> | 2016-08-22 02:45:02 -0400 |
commit | 5a43527d8ef1f2abab03a24c5112a54ec5ba032a (patch) | |
tree | 8ecb9e3c1ae3d1cd235192af4e962ba2c5ea20c3 /api-ref/source/v1 | |
parent | 84b1d89a80285210a6396da957fbe92751b11ef2 (diff) | |
download | heat-5a43527d8ef1f2abab03a24c5112a54ec5ba032a.tar.gz |
api-ref - stack identity usage in find calls
The Heat API for find-stack accepts either the stack name or the stack
UUID when retrieving the canonical URL for a stack resource. The
current documentation is inaccurate because it is described as only
accepting stack names.
Change-Id: Ic2dba4314d5fc7e8bef460e92d94b92f87635d71
Diffstat (limited to 'api-ref/source/v1')
-rw-r--r-- | api-ref/source/v1/parameters.yaml | 8 | ||||
-rw-r--r-- | api-ref/source/v1/stacks.inc | 8 |
2 files changed, 11 insertions, 5 deletions
diff --git a/api-ref/source/v1/parameters.yaml b/api-ref/source/v1/parameters.yaml index 080e3016a..380edbc23 100644 --- a/api-ref/source/v1/parameters.yaml +++ b/api-ref/source/v1/parameters.yaml @@ -64,7 +64,13 @@ stack_id_url: description: | The UUID of the stack. in: path - required: false + required: true + type: string +stack_identity: + description: | + The UUID or the name of a stack. + in: path + required: true type: string stack_name_url: description: | diff --git a/api-ref/source/v1/stacks.inc b/api-ref/source/v1/stacks.inc index 14c0fdddb..65ffe49dc 100644 --- a/api-ref/source/v1/stacks.inc +++ b/api-ref/source/v1/stacks.inc @@ -217,7 +217,7 @@ Response Example Find stack ========== -.. rest_method:: GET /v1/{tenant_id}/stacks/{stack_name} +.. rest_method:: GET /v1/{tenant_id}/stacks/{stack_identity} Finds the canonical URL for a stack. @@ -248,7 +248,7 @@ Request Parameters .. rest_parameters:: parameters.yaml - tenant_id: tenant_id - - stack_name: stack_name_url + - stack_identity: stack_identity Response Parameters ------------------- @@ -469,7 +469,7 @@ Response Example Find stack for deletion ======================= -.. rest_method:: DELETE /v1/{tenant_id}/stacks/{stack_name} +.. rest_method:: DELETE /v1/{tenant_id}/stacks/{stack_identity} Find the canonical URL for a stack for deletion. This request returns a status code of ``302`` pointing to the location where a DELETE request can be sent to @@ -495,7 +495,7 @@ Request Parameters .. rest_parameters:: parameters.yaml - tenant_id: tenant_id - - stack_name: stack_name_url + - stack_identity: stack_identity Reponse Parameters ------------------ |