diff options
author | 2020-12-08 19:15:36 +0100 | |
---|---|---|
committer | 2020-12-08 19:15:40 +0100 | |
commit | eaa1ac9e51c6c87cd1f4dd1cf7ba2d070ed75979 (patch) | |
tree | 1bd95cf78ee9093b171b569080d6e5b2b4a9b359 /docs/api-reference/bp-processor.rst | |
parent | a4b721c3e9c4aa7c5342304a061dc5634935acd0 (diff) |
CDS add API reference documentation
Issue-ID: CCSDK-3014
Change-Id: Id31270c287bdf23de5feb6666ca859d6cd5732c2
Signed-off-by: JakobKrieg <jakob.krieg@bcmsolutions.de>
Diffstat (limited to 'docs/api-reference/bp-processor.rst')
-rw-r--r-- | docs/api-reference/bp-processor.rst | 185 |
1 files changed, 18 insertions, 167 deletions
diff --git a/docs/api-reference/bp-processor.rst b/docs/api-reference/bp-processor.rst index 2789825e0..31efc40fd 100644 --- a/docs/api-reference/bp-processor.rst +++ b/docs/api-reference/bp-processor.rst @@ -8,9 +8,10 @@ Blueprint Processor API Reference Introduction -------------- -This section shows all resources and endpoints which CDS BP processor currently provides with sample requests/responses, -parameter description and other information. If there is a new API and you want do document it, you can use this template -:download:`rst <api-doc-template.rst>`. +This section shows all resources and endpoints which CDS BP processor currently provides through a swagger file +which is automatically created during CDS build process by Swagger Maven Plugin. A corresponding Postman collection is +also included. Endpoints can also be described using this template +:download:`api-doc-template.rst <api-doc-template.rst>` but this is not the prefered way to describe the CDS API. Authentification ----------------- @@ -20,7 +21,13 @@ Use Basic athentification with `ccsdkapps` as a username and password, in Header Download ------------ -You can find a postman collection including sample requests here: :download:`JSON <media/bp-processor.postman_collection.json>` +Here is the automatically created swagger file for CDS Blueprint Processor API: +:download:`cds-bp-processor-api-swagger.json <media/cds-bp-processor-api-swagger.json>` +:download:`cds-bp-processor-api-swagger.yaml <media/cds-bp-processor-api-swagger.yaml>` + +You can find a postman collection including sample requests for all endpoints here: +:download:`bp-processor.postman_collection.json <media/bp-processor.postman_collection.json>`. +Please keep the Postman Collection up-to-date for new endpoints. General Setup -------------- @@ -136,169 +143,13 @@ HTTP Status 202 OK } } -Blueprint Model Catalog API ----------------------------- - -Blueprint-model resource contains all Controller Blueprints Archive (CBA) packages which are available in CDS. -With blueprint-model API you can manage your CBAs. - -Bootstrap -~~~~~~~~~~~ - -POST ``/blueprint-model/bootstrap`` -.................................... - -Loads all Model Types, Resource Dictionaries and CBAs which are included in CDS by default. - - -Request -........... - -.. code-block:: curl - :caption: **sample request** - - curl --location --request POST 'http://localhost:8081/api/v1/blueprint-model/bootstrap' \ - --header 'Authorization: Basic Y2NzZGthcHBzOmNjc2RrYXBwcw==' \ - --header 'Content-Type: application/json' \ - --data-raw '{ - "loadModelType" : true, - "loadResourceDictionary" : true, - "loadCBA" : true - }' - -**Request Body Parameters:** - -.. list-table:: - :widths: 20 20 20 40 - :header-rows: 1 - - * - Parameter - - Type - - Required - - Description - * - loadModelType - - Boolean - - yes - - Specifies if default model types should be loaded - * - loadResourceDictionary - - Boolean - - Yes - - Specifies if default data dictionaries should be loaded - * - loadCBA - - Boolean - - Yes - - Specifies if default CBAs should be loaded - -Success Response -...................... - -HTTP Status 202 OK - - -Consumes -............ - -``application/json`` - - -Functional Description -.............................. - -Before starting to work with CDS, bootstrap should be called to load all the basic models that each orginization might support. -Parameter values can be set as `false` to skip loading e.g. the Resource Dictioniaries but this is not recommended. -The loaded CBAs are already enriched, that's why CBAs can be loaded even without Data Dictionaries or Model Types. If -validation of a CBA fails the CBA is skipped and the call is still executed successfully. You can find the error logs e.g. -in the console of an IDE. - - -Technical Description -........................... - -All Model Types which are loaded by bootstrap are in folder `/components/model-catalog/definition-type/starter-type`, -all Resource Dictionaries in `components/model-catalog/resource-dictionary/starter-dictionary`, all CBAs in -`model-catalog/blueprint-model/service-blueprint`. -**Called class/method:** ``org.onap.ccsdk.cds.blueprintsprocessor.designer.api.BlueprintModelController#bootstrap``. - -Related topics -.................. - -.. toctree:: - :maxdepth: 1 - - ../modelingconcepts/cba - ../modelingconcepts/data-dictionary - ../modelingconcepts/data-type - - -List all blueprint models -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -GET ``/blueprint-model`` -.............................. - -Lists all blueprint models which are saved in CDS. - -Request -........... - -.. code-block:: curl - :caption: **request** - - curl --location --request GET 'http://{{ip_adress}}:{{port}}/api/v1/blueprint-model' \ - --header 'Authorization: Basic Y2NzZGthcHBzOmNjc2RrYXBwcw==' - -Produces -........... - -``application/json`` - - -Success Response -...................... +API Reference +-------------- -HTTP Status 200 OK +.. warning:: + In the used Sphinx plugin `sphinxcontrib-swaggerdoc` some information of the swagger file is not + rendered completely, e.g. the request body. Use your favorite Swagger Editor and paste the swagger file + to get a complete view of the API reference, e.g. on https://editor.swagger.io/. -.. code-block:: json - :caption: **example response** - - [ - { - "blueprintModel": { - "id": "109e725d-5145-4f70-a2e7-ee6640e2fb5f", - "artifactUUId": null, - "artifactType": "SDNC_MODEL", - "artifactVersion": "1.0.0", - "artifactDescription": "", - "internalVersion": null, - "createdDate": "2020-11-09T19:00:20.000Z", - "artifactName": "vLB_CDS_RESTCONF", - "published": "Y", - "updatedBy": "DanielEmmarts>", - "tags": "vLB-CDS" - } - }, - { - "blueprintModel": { - "id": "5cce3804-09eb-473d-b513-81f8547a7240", - "artifactUUId": null, - "artifactType": "SDNC_MODEL", - "artifactVersion": "1.0.0", - "artifactDescription": "", - "internalVersion": null, - "createdDate": "2020-11-09T19:00:20.000Z", - "artifactName": "vLB_CDS", - "published": "Y", - "updatedBy": "TomKennedy>", - "tags": "vLB_CDS" - } - } - ] - -Technical Description -........................... - -Loads all Blueprint Models which are saved in the CDS database in table `BLUEPRINT_MODEL`. Unpublished and unproceeded -Blueprint Models are also included. -**Called class/method:** ``org.onap.ccsdk.cds.blueprintsprocessor.designer.api.BlueprintModelController#allBlueprintModel()``. +.. swaggerv2doc:: media/cds-bp-processor-api-swagger.json
\ No newline at end of file |