Merge "Documenting parent property."

api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl

@@ -21,6 +21,7 @@ be used for future calls to preview and/or create a stack.</para>'>
 ]>
 <application xmlns="http://wadl.dev.java.net/2009/02"
     xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     xmlns:wadl="http://wadl.dev.java.net/2009/02">
     <resources base="https://heat.example.com/"
         xml:id="orchestration-api-v1.0">
@@ -483,6 +484,16 @@ be used for future calls to preview and/or create a stack.</para>'>
             </representation>
         </request>
         <response status="200">
+            <param name="parent" style="plain" type="xsd:string"
+                required="true">
+                <wadl:doc xmlns="http://docbook.org/ns/docbook"
+                    xml:lang="EN">
+                    <para>
+                        The Stack ID of the parent stack, if this is
+                        a nested stack.
+                    </para>
+                </wadl:doc>
+            </param>
             <representation mediaType="application/json">
                 <wadl:doc xmlns="http://docbook.org/ns/docbook"
                     xml:lang="EN">

api-ref/src/wadls/orchestration-api/src/v1/samples/stack_preview.json

@@ -1,6 +1,7 @@
 {
     "stack": {
         "id": "None",
+        "parent": null,
         "stack_name": "sample_stack",
         "description": "Sample template description.",
         "template_description": "Sample template description.",
@@ -86,4 +87,4 @@
             }
         ]
     }
-}
+}