aboutsummaryrefslogtreecommitdiffstats
path: root/docs/api-reference/media/cds-bp-processor-api-swagger.yaml
diff options
context:
space:
mode:
authorJakobKrieg <jakob.krieg@bcmsolutions.de>2020-12-08 19:15:36 +0100
committerJakobKrieg <jakob.krieg@bcmsolutions.de>2020-12-08 19:15:40 +0100
commiteaa1ac9e51c6c87cd1f4dd1cf7ba2d070ed75979 (patch)
tree1bd95cf78ee9093b171b569080d6e5b2b4a9b359 /docs/api-reference/media/cds-bp-processor-api-swagger.yaml
parenta4b721c3e9c4aa7c5342304a061dc5634935acd0 (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/media/cds-bp-processor-api-swagger.yaml')
-rw-r--r--docs/api-reference/media/cds-bp-processor-api-swagger.yaml714
1 files changed, 714 insertions, 0 deletions
diff --git a/docs/api-reference/media/cds-bp-processor-api-swagger.yaml b/docs/api-reference/media/cds-bp-processor-api-swagger.yaml
new file mode 100644
index 000000000..e16e22cad
--- /dev/null
+++ b/docs/api-reference/media/cds-bp-processor-api-swagger.yaml
@@ -0,0 +1,714 @@
+---
+swagger: "2.0"
+info:
+ description: "Shows all resources and endpoints which CDS BP processor currently\
+ \ provides with sample requests/responses, parameter description and other information."
+ version: "v1"
+ title: "CDS Blueprint Processor API Reference"
+ termsOfService: "https://www.onap.org/"
+ contact:
+ name: "ONAP Community"
+ url: "https://www.onap.org/"
+ email: "onap-discuss@lists.onap.org"
+ license:
+ name: "Apache 2.0"
+ url: "http://www.apache.org/licenses/LICENSE-2.0.html"
+host: "localhost:8080"
+tags:
+- name: "Blueprint Model Catalog API"
+ description: "Manages all blueprint models which are available in CDS"
+schemes:
+- "http"
+paths:
+ /api/v1/blueprint-model:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "List all Blueprint Models"
+ description: "Lists all meta-data of blueprint models which are saved in CDS."
+ operationId: "BlueprintModelController_allBlueprintModel_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters: []
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "array"
+ items:
+ $ref: "#/definitions/BlueprintModelSearch"
+ 500:
+ description: "Internal Server Error"
+ post:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Save a Blueprint Model"
+ description: "Saves a blueprint model by the given CBA zip file input. There\
+ \ is no validation of the attached CBA happening when this API is called."
+ operationId: "BlueprintModelController_saveBlueprint_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ consumes:
+ - "multipart/form-data"
+ produces:
+ - "application/json"
+ parameters:
+ - in: "body"
+ name: "file"
+ description: "CBA file to be uploaded (example: cba.zip)"
+ required: true
+ schema:
+ $ref: "#/definitions/FilePart"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 500:
+ description: "Internal Server Error"
+ /api/v1/blueprint-model/bootstrap:
+ post:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Bootstrap CDS"
+ description: "Loads all Model Types, Resource Dictionaries and Blueprint Models\
+ \ which are included in CDS by default. 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 Dictionaries but this is not recommended."
+ operationId: "BlueprintModelController_bootstrap_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ consumes:
+ - "application/json"
+ produces:
+ - "application/json"
+ parameters:
+ - in: "body"
+ name: "body"
+ description: "Specifies which elements to load"
+ required: true
+ schema:
+ $ref: "#/definitions/BootstrapRequest"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 500:
+ description: "Internal Server Error"
+ /api/v1/blueprint-model/by-name/{name}/version/{version}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Get a Blueprint Model by Name and Version"
+ description: "Get Meta-Data of a Blueprint Model by its name and version."
+ operationId: "BlueprintModelController_getBlueprintByNameAndVersion_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "name"
+ in: "path"
+ description: "Name of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "pnf_netconf"
+ - name: "version"
+ in: "path"
+ description: "Version of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "1.0.0"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 404:
+ description: "Not Found"
+ /api/v1/blueprint-model/download/by-name/{name}/version/{version}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Download a Blueprint Model"
+ description: "Gets the CBA of a blueprint model by its name and version. Response\
+ \ can be saved to a file to download the CBA."
+ operationId: "BlueprintModelController_downloadBlueprintByNameAndVersion_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "name"
+ in: "path"
+ description: "Name of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "pnf_netconf"
+ - name: "version"
+ in: "path"
+ description: "Version of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "1.0.0"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 404:
+ description: "Not Found"
+ /api/v1/blueprint-model/download/{id}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Download a Blueprint Model by ID"
+ description: "Gets the CBA of a blueprint model by its ID. Response can be saved\
+ \ to a file to download the CBA."
+ operationId: "BlueprintModelController_downloadBluePrint_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "id"
+ in: "path"
+ description: "ID of the blueprint model to download"
+ required: true
+ type: "string"
+ x-example: "67ec1f96-ab55-4b81-aff9-23ee0ed1d7a4"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 404:
+ description: "Not Found"
+ /api/v1/blueprint-model/enrich:
+ post:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Enrich a Blueprint Model"
+ description: "Enriches the attached CBA and returns the enriched CBA zip file\
+ \ in the response. The enrichment process will complete the package by providing\
+ \ all the definition of types used."
+ operationId: "BlueprintModelController_enrichBlueprint_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ consumes:
+ - "multipart/form-data"
+ produces:
+ - "application/json"
+ parameters:
+ - in: "body"
+ name: "file"
+ description: "CBA zip file to be uploaded (example: cba_unenriched.zip)"
+ required: true
+ schema:
+ $ref: "#/definitions/FilePart"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/enrichandpublish:
+ post:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Enrich and publish a Blueprint Model"
+ description: "Enriches the attached CBA, validates it and saves it in CDS if\
+ \ validation was successful."
+ operationId: "BlueprintModelController_enrichAndPubishlueprint_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ consumes:
+ - "multipart/form-data"
+ produces:
+ - "application/json"
+ parameters:
+ - in: "body"
+ name: "file"
+ description: "Unenriched CBA zip file to be uploaded (example: cba_unenriched.zip)"
+ required: true
+ schema:
+ $ref: "#/definitions/FilePart"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 503:
+ description: "Service Unavailable"
+ /api/v1/blueprint-model/meta-data/{keyword}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Search for Blueprints by a Keyword"
+ description: "Lists all blueprint models by a matching keyword in any of the\
+ \ meta-data of the blueprint models. Blueprint models are just returned if\
+ \ a whole keyword is matching, not just parts of it. Not case-sensitive. Used\
+ \ by CDS UI."
+ operationId: "BlueprintModelController_allBlueprintModelMetaData_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "keyword"
+ in: "path"
+ description: "Keyword to search for in blueprint model meta-data"
+ required: true
+ type: "string"
+ x-example: "pnf_netconf"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/name/{name}/version/{version}:
+ delete:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Delete a Blueprint Model by Name"
+ description: "Deletes a blueprint model identified by its name and version from\
+ \ CDS."
+ operationId: "BlueprintModelController_deleteBlueprintByName_DELETE.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ parameters:
+ - name: "name"
+ in: "path"
+ description: "Name of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "pnf_netconf"
+ - name: "version"
+ in: "path"
+ description: "Version of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "1.0.0"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/paged:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Get Blueprints ordered"
+ description: "Lists all blueprint models which are saved in CDS in an ordered\
+ \ mode."
+ operationId: "BlueprintModelController_allBlueprintModelPaged_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "limit"
+ in: "query"
+ description: "Maximum number of returned blueprint models"
+ required: false
+ type: "integer"
+ default: 20
+ format: "int32"
+ - name: "offset"
+ in: "query"
+ description: "Offset"
+ required: false
+ type: "integer"
+ default: 0
+ format: "int32"
+ - name: "sort"
+ in: "query"
+ description: "Order of returned blueprint models"
+ required: false
+ type: "string"
+ default: "DATE"
+ enum:
+ - "DATE"
+ - "NAME"
+ - "VERSION"
+ - name: "sortType"
+ in: "query"
+ description: "Ascend or descend ordering"
+ required: false
+ type: "string"
+ default: "ASC"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ $ref: "#/definitions/PageBlueprintModelSearch"
+ /api/v1/blueprint-model/paged/meta-data/{keyword}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Search for Blueprints by a Keyword in an ordered mode"
+ description: "Lists all blueprint models by a matching keyword in any of the\
+ \ meta-data of the blueprint models in an ordered mode. Blueprint models are\
+ \ just returned if a whole keyword is matching, not just parts of it. Not\
+ \ case-sensitive. Used by CDS UI."
+ operationId: "BlueprintModelController_allBlueprintModelMetaDataPaged_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "keyword"
+ in: "path"
+ description: "Keyword to search for in blueprint model meta-data"
+ required: true
+ type: "string"
+ x-example: "pnf_netconf"
+ - name: "limit"
+ in: "query"
+ description: "Maximum number of returned blueprint models"
+ required: false
+ type: "integer"
+ default: 20
+ format: "int32"
+ - name: "offset"
+ in: "query"
+ description: "Offset"
+ required: false
+ type: "integer"
+ default: 0
+ format: "int32"
+ - name: "sort"
+ in: "query"
+ description: "Order of returned blueprint models"
+ required: false
+ type: "string"
+ default: "DATE"
+ enum:
+ - "DATE"
+ - "NAME"
+ - "VERSION"
+ - name: "sortType"
+ in: "query"
+ description: "Ascend or descend ordering"
+ required: false
+ type: "string"
+ default: "ASC"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ $ref: "#/definitions/PageBlueprintModelSearch"
+ /api/v1/blueprint-model/publish:
+ post:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Publish a Blueprint Model"
+ description: "Validates the attached CBA file and saves it in CDS if validation\
+ \ was successful. CBA needs to be already enriched."
+ operationId: "BlueprintModelController_publishBlueprint_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ consumes:
+ - "multipart/form-data"
+ produces:
+ - "application/json"
+ parameters:
+ - in: "body"
+ name: "file"
+ description: "Enriched CBA zip file to be uploaded (example: cba_enriched.zip)"
+ required: true
+ schema:
+ $ref: "#/definitions/FilePart"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/search/{tags}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Search for a Blueprint by Tag"
+ description: "Searches for all blueprint models which contain the specified\
+ \ input parameter in their tags. Blueprint models which contain just parts\
+ \ of the searched word in their tags are also returned."
+ operationId: "BlueprintModelController_searchBlueprintModels_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "tags"
+ in: "path"
+ description: "Tag to search for"
+ required: true
+ type: "string"
+ x-example: "test"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/workflow-spec:
+ post:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Get Workflow Specification"
+ description: "Get the workflow of a blueprint identified by Blueprint and workflow\
+ \ name. Inputs, outputs and data types of workflow is returned."
+ operationId: "BlueprintModelController_workflowSpec_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ consumes:
+ - "application/json"
+ produces:
+ - "application/json"
+ parameters:
+ - in: "body"
+ name: "body"
+ required: false
+ schema:
+ $ref: "#/definitions/WorkFlowSpecRequest"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/workflows/blueprint-name/{name}/version/{version}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Get Workflows of a Blueprint"
+ description: "Get all available workflows of a Blueprint identified by its name\
+ \ and version."
+ operationId: "BlueprintModelController_getWorkflowList_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "name"
+ in: "path"
+ description: "Name of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "pnf_netconf"
+ - name: "version"
+ in: "path"
+ description: "Version of the blueprint model"
+ required: true
+ type: "string"
+ x-example: "1.0.0"
+ responses:
+ 200:
+ description: "successful operation"
+ schema:
+ type: "object"
+ /api/v1/blueprint-model/{id}:
+ get:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Get a Blueprint Model by ID"
+ description: "Get meta-data of a blueprint model by its internally created ID."
+ operationId: "BlueprintModelController_getBlueprintModel_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ produces:
+ - "application/json"
+ parameters:
+ - name: "id"
+ in: "path"
+ description: "ID of the blueprint model to search for"
+ required: true
+ type: "string"
+ x-example: "67ec1f96-ab55-4b81-aff9-23ee0ed1d7a4"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 404:
+ description: "Not Found"
+ delete:
+ tags:
+ - "Blueprint Model Catalog API"
+ summary: "Delete a Blueprint Model by ID"
+ description: "Delete a blueprint model by its ID. ID is the internally created\
+ \ ID of blueprint, not the name of blueprint."
+ operationId: "BlueprintModelController_deleteBlueprint_DELETE.org.onap.ccsdk.cds.blueprintsprocessor.designer.api"
+ parameters:
+ - name: "id"
+ in: "path"
+ description: "ID of the blueprint model to delete"
+ required: true
+ type: "string"
+ x-example: "67ec1f96-ab55-4b81-aff9-23ee0ed1d7a4"
+ responses:
+ 200:
+ description: "OK"
+ schema:
+ type: "object"
+ 404:
+ description: "RESOURCE_NOT_FOUND"
+securityDefinitions:
+ Basic Auth:
+ type: "basic"
+definitions:
+ BlueprintModelSearch:
+ type: "object"
+ required:
+ - "artifactName"
+ - "artifactVersion"
+ - "createdDate"
+ - "id"
+ - "published"
+ - "tags"
+ - "updatedBy"
+ properties:
+ id:
+ type: "string"
+ example: "\"658f9a48-7f54-41ba-ae18-c69f26f3dc94\""
+ description: "ID of Blueprint model, is automatically created by CDS"
+ artifactUUId:
+ type: "string"
+ example: "null"
+ description: "Artifact UUID, usually null"
+ artifactType:
+ type: "string"
+ example: "\"SDNC_MODEL\""
+ description: "Artifact Type, usually null"
+ artifactVersion:
+ type: "string"
+ example: "\"1.0.0\""
+ description: "Artifact Version, usually 1.0.0"
+ artifactDescription:
+ type: "string"
+ example: "\"\""
+ description: "Artifact Description, usually empty"
+ internalVersion:
+ type: "integer"
+ format: "int32"
+ example: "null"
+ description: "Internal Version of CBA, usually null"
+ createdDate:
+ type: "string"
+ format: "date-time"
+ example: "\"2020-11-19T10:34:56.000Z\""
+ description: "Datetime of the creation of CBA in CDS"
+ artifactName:
+ type: "string"
+ example: "\"pnf_netconf\""
+ description: "Artifact Name, defined in Metadata"
+ published:
+ type: "string"
+ example: "\"pnf_netconf\""
+ description: "Artifact Name, defined in Metadata"
+ updatedBy:
+ type: "string"
+ example: "\"Deutsche Telekom AG\""
+ description: "Name of publisher, defined in Metadata"
+ tags:
+ type: "string"
+ example: "\"test\""
+ description: "Tags to identify the CBA, defined in Metadata"
+ BootstrapRequest:
+ type: "object"
+ required:
+ - "loadCBA"
+ - "loadModelType"
+ - "loadResourceDictionary"
+ properties:
+ loadModelType:
+ type: "boolean"
+ example: true
+ description: "Specifies if default model types should be loaded"
+ loadResourceDictionary:
+ type: "boolean"
+ example: true
+ description: "Specifies if default data dictionaries should be loaded"
+ loadCBA:
+ type: "boolean"
+ example: true
+ description: "Specifies if default blueprint models should be loaded"
+ FilePart:
+ type: "object"
+ Page:
+ type: "object"
+ properties:
+ totalPages:
+ type: "integer"
+ format: "int32"
+ totalElements:
+ type: "integer"
+ format: "int64"
+ size:
+ type: "integer"
+ format: "int32"
+ content:
+ type: "array"
+ items:
+ type: "object"
+ number:
+ type: "integer"
+ format: "int32"
+ sort:
+ $ref: "#/definitions/Sort"
+ last:
+ type: "boolean"
+ numberOfElements:
+ type: "integer"
+ format: "int32"
+ pageable:
+ $ref: "#/definitions/Pageable"
+ first:
+ type: "boolean"
+ empty:
+ type: "boolean"
+ PageBlueprintModelSearch:
+ type: "object"
+ properties:
+ totalPages:
+ type: "integer"
+ format: "int32"
+ totalElements:
+ type: "integer"
+ format: "int64"
+ size:
+ type: "integer"
+ format: "int32"
+ content:
+ type: "array"
+ items:
+ $ref: "#/definitions/BlueprintModelSearch"
+ number:
+ type: "integer"
+ format: "int32"
+ sort:
+ $ref: "#/definitions/Sort"
+ last:
+ type: "boolean"
+ numberOfElements:
+ type: "integer"
+ format: "int32"
+ pageable:
+ $ref: "#/definitions/Pageable"
+ first:
+ type: "boolean"
+ empty:
+ type: "boolean"
+ Pageable:
+ type: "object"
+ properties:
+ offset:
+ type: "integer"
+ format: "int64"
+ sort:
+ $ref: "#/definitions/Sort"
+ paged:
+ type: "boolean"
+ unpaged:
+ type: "boolean"
+ pageNumber:
+ type: "integer"
+ format: "int32"
+ pageSize:
+ type: "integer"
+ format: "int32"
+ Sort:
+ type: "object"
+ properties:
+ unsorted:
+ type: "boolean"
+ sorted:
+ type: "boolean"
+ empty:
+ type: "boolean"
+ WorkFlowSpecRequest:
+ type: "object"
+ required:
+ - "blueprintName"
+ - "workflowName"
+ properties:
+ blueprintName:
+ type: "string"
+ example: "\"pnf_netconf\""
+ description: "Name of the BLueprint"
+ version:
+ type: "string"
+ returnContent:
+ type: "string"
+ workflowName:
+ type: "string"
+ example: "\"config-assign\""
+ description: "Name of the Workflow"
+ specType:
+ type: "string"