From 6b87e43900b61956ab23d965827fb1306f8db617 Mon Sep 17 00:00:00 2001 From: elinuxhenrik Date: Mon, 16 Nov 2020 09:31:07 +0100 Subject: Add documentation Change-Id: Ie27c53fcb38ae75b9771a42dc7dec39f4a1fd672 Issue-ID: CCSDK-2966 Signed-off-by: elinuxhenrik --- docs/offeredapis/offeredapis.rst | 83 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 docs/offeredapis/offeredapis.rst (limited to 'docs/offeredapis/offeredapis.rst') diff --git a/docs/offeredapis/offeredapis.rst b/docs/offeredapis/offeredapis.rst new file mode 100644 index 00000000..14fb881a --- /dev/null +++ b/docs/offeredapis/offeredapis.rst @@ -0,0 +1,83 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 + International License. +.. http://creativecommons.org/licenses/by/4.0 +.. Copyright 2020 Nordix Foundation + +.. _offered_apis: + + +Offered APIs +============ + +Introduction +************ + +The north bound REST API of the Policy Management Service provides convenient methods to handle policies. + + +Global ORAN architecture +************************ + +Following illustration provides a global view about **ORAN** architecture, +integration with other ONAP components and API resource/operation provided. + +.. image:: ../media/oran_architecture.png + :width: 500pt + + +API Table +********* + +.. |swagger-icon| image:: ../media/swagger.png + :width: 40px + +.. csv-table:: + :header: "API name", "|swagger-icon|" + :widths: 10,5 + + "PMS API", ":download:`link <./swagger/pms-api.json>`" + "A1 ADAPTER API (Internal)", ":download:`link <./swagger/a1-adapter-api.json>`" + + +.. _pms_api: + +PMS API +....... +`PMS API <./pms-api.html>`_ + +.. _a1_adapter_api: + +A1 ADAPTER API +.............. +`A1 ADAPTER API (Internal) <./a1-adapter-api.html>`_ + + +API Version +*********** + +APIs are described with a state version with "v" following the API Name, +e.g.: ``v2/policy``. +The schema associated with a REST API must have its version number aligned +with that of the REST API. + +The version number has major, minor and revision numbers. E.g. v1.0.0 +The version number (without the revision number) is held in the URI. + +The major version number is incremented for an incompatible change. +The minor version number is incremented for a compatible change. +For minor modifications of the API, version numbering must not be updated, +provided the following backward compatibility rules are respected: + +- New elements in a data type must be optional (``minOccurs=0``) +- Changes in the cardinality of an attribute in a data type must be from + mandatory to optional or from lower to greater +- New attributes defined in an element must be optional (absence of + ``use="required"``). +- If new enumerated values are included, the former ones and its meaning must + be kept. +- If new operations are added, the existing operations must be kept +- New parameters added to existing operations must be optional and existing + parameters must be kept + +For major modifications of the API, not backward compatible and forcing client +implementations to be changed, the version number must be updated. -- cgit 1.2.3-korg