From b0e3e8a6a47ab0c6ca86356d147c593fb654092e Mon Sep 17 00:00:00 2001
From: Anne Gentle <agentle@cisco.com>
Date: Mon, 30 Jan 2017 15:49:59 -0600
Subject: [PATCH] Fix missing role_id

Error was "No path parameter ``role_id`` found in rest_parameter stanza.:

Basically it means that the parameter role_id is used, but not defined in a corresponding yaml file.

Mailing list post on openstack-dev:
http://lists.openstack.org/pipermail/openstack-dev/2017-January/110606.html for reference.

Change-Id: Id5863a70f2432a2ae22164aa66e29ae739ab3e11
---
 api-ref/source/image.inc       |  5 ++++-
 api-ref/source/parameters.yaml | 13 +++++++++++++
 api-ref/source/service.inc     |  4 +++-
 3 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/api-ref/source/image.inc b/api-ref/source/image.inc
index 90cc8617..549541ab 100644
--- a/api-ref/source/image.inc
+++ b/api-ref/source/image.inc
@@ -16,7 +16,7 @@ server password.
 List the Images
 ===============
 
-.. rest_method:: GET /v3/images/{role_id}/role/{another_id}/role/{some_id}<br>/b/a/x/{image_id.x}
+.. rest_method:: GET /v3/images/{role_id}/role/{id}/role/{image_id}
 
 Short explanation about this GET method.
 
@@ -39,7 +39,10 @@ Response
 .. rest_parameters:: parameters.yaml
 
    - host: host
+   - id: id
+   - image_id: image_id
    - name: name
+   - role_id: role_id
 
 Create an Image
 ===============
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 86e96a6a..4d173e94 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -4,6 +4,12 @@ id:
   type: string
   description: |
     The id of the service.
+image_id:
+  in: path
+  required: true
+  type: string
+  description: |
+    The id for the image.
 host:
   in: body
   required: true
@@ -16,6 +22,13 @@ name:
   type: string
   description: |
     The name of the service.
+role_id:
+  in: body
+  required: true
+  type: string
+  description: |
+    The unique identifier for the role, which enables defining role assignments
+    for multiple users in multiple projects.
 server.obj:
   in: body
   required: true
diff --git a/api-ref/source/service.inc b/api-ref/source/service.inc
index d6174b14..028346c2 100644
--- a/api-ref/source/service.inc
+++ b/api-ref/source/service.inc
@@ -51,7 +51,7 @@ root group as the group owner, and allow only user and group read access
 List the Servers
 ================
 
-.. rest_method:: GET /v3/servers/{role_id}/role/{another_id}/role/{some_id}
+.. rest_method:: GET /v3/servers/{role_id}/role
 
 Short explanation about this GET method.
 
@@ -75,6 +75,7 @@ Response
 
    - host: host
    - name: name
+   - role_id: role_id
 
 
 Copy the Server
@@ -92,6 +93,7 @@ Response
 
    - host: host
    - name: name
+   - role_id: role_id
 
 
 Change or Update the Servers