Merge "[placement] Add 'Location' parameters in API ref"

placement-api-ref/source/parameters.yaml

@@ -1,3 +1,12 @@
+# variables in header
+location:
+  description: |
+    The location URL of the resource created,
+    HTTP header "Location: <Location URL>" will be returned.
+  in: header
+  required: true
+  type: string
+
 # variables in path
 consumer_uuid: &consumer_uuid
   type: string

placement-api-ref/source/resource_class.inc

@@ -69,6 +69,10 @@ Request
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - Location: location
+
 No body content is returned on a successful PUT.
 
 Update resource class (microversions 1.2 - 1.6)

placement-api-ref/source/resource_classes.inc

@@ -68,4 +68,8 @@ Request example
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - Location: location
+
 No body content is returned on a successful POST.

placement-api-ref/source/resource_providers.inc

@@ -82,4 +82,8 @@ Request example
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - Location: location
+
 No body content is returned on a successful POST.

placement-api-ref/source/traits.inc

@@ -99,6 +99,10 @@ Request
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - Location: location
+
 No body content is returned on a successful PUT.
 
 Delete traits