From 95dca6d8d31cf85c2f766f8f856e786be33be91e Mon Sep 17 00:00:00 2001
From: Laurel Michaels <lmichaels@parelastic.com>
Date: Mon, 13 Jul 2015 13:49:00 -0400
Subject: [PATCH] Add doc for configuration-attach cmd

Added API doc for the trove configuration-attach
cmd.

Change-Id: I48921784044650fa66a274bc4e6f62fed9a707f8
Partial-Bug: #1376972
---
 api-ref/src/docbkx/ch_database-v1.xml         |  1 +
 .../src/wadls/databases-api/xsd/dbaas.wadl    | 40 +++++++++++++++++++
 ...db-attach-config-grp-request-json-http.txt |  7 ++++
 .../samples/db-attach-config-grp-request.json |  5 +++
 ...b-attach-config-grp-response-json-http.txt |  5 +++
 5 files changed, 58 insertions(+)
 create mode 100644 api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request-json-http.txt
 create mode 100644 api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request.json
 create mode 100644 api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-response-json-http.txt

diff --git a/api-ref/src/docbkx/ch_database-v1.xml b/api-ref/src/docbkx/ch_database-v1.xml
index 252110b55..0c74d9cb3 100644
--- a/api-ref/src/docbkx/ch_database-v1.xml
+++ b/api-ref/src/docbkx/ch_database-v1.xml
@@ -34,6 +34,7 @@
             href="../wadls/databases-api/xsd/dbaas.wadl#instanceId">
                 <wadl:method href="#getInstanceById"/>
                 <wadl:method href="#deleteInstance"/>
+                <wadl:method href="#attachConfigGroup"/>
                 <wadl:method href="#listConfigDefaults"/>
             </wadl:resource>
             <wadl:resource
diff --git a/api-ref/src/wadls/databases-api/xsd/dbaas.wadl b/api-ref/src/wadls/databases-api/xsd/dbaas.wadl
index 03049e6d0..cabf213db 100644
--- a/api-ref/src/wadls/databases-api/xsd/dbaas.wadl
+++ b/api-ref/src/wadls/databases-api/xsd/dbaas.wadl
@@ -62,6 +62,7 @@
                             </wadl:doc>
                         </param>
                         <method href="#getInstanceById"/>
+                        <method href="#attachConfigGroup"/>
                         <method href="#deleteInstance"/>
                         <method href="#listConfigDefaults"/>
                         <resource id="instanceAction" path="action">
@@ -1601,4 +1602,43 @@
             </representation>
         </response> &commonFaults; &getFaults;
     </method>
+    <method name="PUT" id="attachConfigGroup">
+        <wadl:doc xml:lang="EN" title="Attach configuration group"
+            xmlns="http://docbook.org/ns/docbook">
+            <para role="shortdesc">
+                Attaches a configuration group to
+                a specified instance.
+            </para>
+        </wadl:doc>
+        <request>
+            <representation mediaType="application/json">
+                <wadl:doc xmlns="http://docbook.org/ns/docbook"
+                    xml:lang="EN">
+                    <xsdxt:code
+                        href="samples/db-attach-config-grp-request-json-http.txt"/>
+                    <xsdxt:code
+                        href="samples/db-attach-config-grp-request.json"/>
+                </wadl:doc>
+                <param name="configuration" style="plain" type="xsd:string"
+                    required="true">
+                    <wadl:doc xmlns="http://docbook.org/ns/docbook"
+                        xml:lang="EN">
+                        <para>
+                            ID of the configuration group that you want to attach to the instance.
+                        </para>
+                    </wadl:doc>
+                </param>
+            </representation>
+        </request>
+        <response status="202">
+            <representation mediaType="application/json">
+                <wadl:doc xmlns="http://docbook.org/ns/docbook"
+                    xml:lang="EN">
+                    <xsdxt:code
+                        href="samples/db-attach-config-grp-response-json-http.txt"
+                    />
+                </wadl:doc>
+            </representation>
+        </response> &commonFaults; &getFaults; &postPutFaults;
+    </method>
 </application>
diff --git a/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request-json-http.txt b/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request-json-http.txt
new file mode 100644
index 000000000..478e04939
--- /dev/null
+++ b/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request-json-http.txt
@@ -0,0 +1,7 @@
+PUT /v1.0/1234/instances/4c93c73b-d6d0-47d7-b8c6-b699d19d7de9 HTTP/1.1
+User-Agent: python-example-client
+Host: openstack.example.com
+X-Auth-Token: 87c6033c-9ff6-405f-943e-2deb73f278b7
+Accept: application/json
+Content-Type: application/json
+
diff --git a/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request.json b/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request.json
new file mode 100644
index 000000000..d5708d910
--- /dev/null
+++ b/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-request.json
@@ -0,0 +1,5 @@
+{
+    "instance": {
+        "configuration": "2aa51628-5c42-4086-8682-137caffd2ba6"
+    }
+}
diff --git a/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-response-json-http.txt b/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-response-json-http.txt
new file mode 100644
index 000000000..c7fabb46f
--- /dev/null
+++ b/api-ref/src/wadls/databases-api/xsd/samples/db-attach-config-grp-response-json-http.txt
@@ -0,0 +1,5 @@
+HTTP/1.1 202 OK
+Content-Type: application/json
+Content-Length: 0
+Date: Mon, 13 Jul 2015 19:53:04 GMT
+