Merge "Add "/" to API-Ref Docs"

api-ref/source/dns-api-v2-version.inc

@@ -0,0 +1,37 @@
+============
+API Versions
+============
+
+Show all enabled API versions
+
+List all API versions
+=====================
+
+.. rest_method::  GET /
+
+
+Normal response codes: 200
+
+Error response codes:405,404,403,401,400,503,
+
+
+Request
+-------
+
+No parameters needed
+
+Response Parameters
+-------------------
+
+.. rest_parameters:: parameters.yaml
+
+   - x-openstack-request-id: x-openstack-request-id
+
+
+Response Example
+----------------
+
+.. literalinclude:: samples/versions/get-versions-response.json
+   :language: javascript
+
+

api-ref/source/index.rst

@@ -6,6 +6,7 @@
 
 .. rest_expand_all::
 
+.. include:: dns-api-v2-version.inc
 .. include:: dns-api-v2-zone.inc
 .. include:: dns-api-v2-zone-import.inc
 .. include:: dns-api-v2-zone-export.inc

api-ref/source/samples/versions/get-versions-response.json

@@ -0,0 +1,26 @@
+{
+    "versions": {
+        "values": [
+            {
+                "id": "v1",
+                "links": [
+                    {
+                        "href": "http://127.0.0.1:9001/v1",
+                        "rel": "self"
+                    }
+                ],
+                "status": "DEPRECATED"
+            },
+            {
+                "id": "v2",
+                "links": [
+                    {
+                        "href": "http://127.0.0.1:9001/v2",
+                        "rel": "self"
+                    }
+                ],
+                "status": "CURRENT"
+            }
+        ]
+    }
+}