summaryrefslogtreecommitdiffstats
path: root/docs/design.rst
diff options
context:
space:
mode:
authorshivasubedi <shiva.subedi@est.tech>2021-09-13 16:43:20 +0100
committershivasubedi <shiva.subedi@est.tech>2021-09-14 13:00:15 +0100
commit3d1579cb8cfe7fe924181bc3e02c570dca6ae081 (patch)
tree83c6113b7a180c1376174ec3fae4b90b7619d2a6 /docs/design.rst
parentf5de1ae2fe4b092d76c39a995d187cc509722c12 (diff)
Create preliminary documentation for ONAP DMI-Plugin
Create Preliminary documentation for Istanbul release of the DMI Plugin. Added new plugins in POM to generate swagger doc for design page. Added icons from Cps-Core, along with latest conf.py file from http://gerrit.onap.org/r/doc Issue-ID: CPS-625 Change-Id: I30582de9b07e93c1c2ecc18003ee6882994690d8 Signed-off-by: DylanB95EST <dylan.byrne@est.tech> Signed-off-by: shivasubedi <shiva.subedi@est.tech>
Diffstat (limited to 'docs/design.rst')
-rw-r--r--docs/design.rst40
1 files changed, 40 insertions, 0 deletions
diff --git a/docs/design.rst b/docs/design.rst
new file mode 100644
index 00000000..e65c5aed
--- /dev/null
+++ b/docs/design.rst
@@ -0,0 +1,40 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2021 Nordix Foundation
+
+.. DO NOT CHANGE THIS LABEL FOR RELEASE NOTES - EVEN THOUGH IT GIVES A WARNING
+.. _design:
+
+
+DMI Plugin Design
+#################
+
+.. warning:: draft
+
+.. toctree::
+ :maxdepth: 1
+
+Offered APIs
+============
+
+The DMI Plugin supports the public APIs listed in the link below:
+
+:download:`DMI Rest OpenApi Specification <openapi/openapi.yml>`
+
+Exposed API
+-----------
+
+The standard for API definition in the RESTful API world is the OpenAPI Specification (OAS).
+The OAS 3, which is based on the original "Swagger Specification", is being widely used in API developments.
+
+Specification can be accessed using following URI:
+
+.. code-block:: bash
+
+ “http://<hostname>:<port>/v3/api-docs?group=dmi-plugin-docket”
+
+DMI Plugin CM Handles
+=====================
+
+Several DMI Plugin APIs use the cm-handle parameter.
+The DMI Plugin CM Handles are described in detail in :doc:`dmi-plugin-cm-handle`.