From b337097739ba195b5d7a8cbb71c2f0e7f0e74d30 Mon Sep 17 00:00:00 2001 From: renrak15 Date: Wed, 26 Aug 2020 18:49:14 +0530 Subject: Transformation of request/response payloads for SDC Integration for POST /serviceSpecification Swagger changes and model classes Issue-ID: EXTAPI-487 Change-Id: I1ae29c643fe9c84856e3e0ec08e0776e724924d0 Signed-off-by: renrak15 --- docs/offeredapis/api_serviceCatalog/swagger.json | 97 +++++++++++++++++++++++- docs/offeredapis/api_serviceCatalog/swagger.yaml | 80 ++++++++++++++++++- 2 files changed, 173 insertions(+), 4 deletions(-) (limited to 'docs/offeredapis/api_serviceCatalog') diff --git a/docs/offeredapis/api_serviceCatalog/swagger.json b/docs/offeredapis/api_serviceCatalog/swagger.json index c35c5fd..04d4d85 100644 --- a/docs/offeredapis/api_serviceCatalog/swagger.json +++ b/docs/offeredapis/api_serviceCatalog/swagger.json @@ -165,7 +165,7 @@ "201": { "description": "Created", "schema": { - "$ref": "#/definitions/ServiceSpecificationRequest" + "$ref": "#/definitions/ServiceSpecificationResponse" } }, "400": { @@ -567,6 +567,12 @@ "ServiceSpecificationRequest": { "description": "ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instantiated. By sharing the same specification, these services would therefore share the same set of characteristics.", "type": "object", + "required": [ + "name", + "description", + "category", + "relatedParty" + ], "properties": { "name": { "description": "Name of the service specification", @@ -641,8 +647,93 @@ } } }, + "ServiceSpecificationResponse": { + "description": "ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instantiated. By sharing the same specification, these services would therefore share the same set of characteristics.", + "type": "object", + "properties": { + "name": { + "description": "Name of the service specification", + "type": "string" + }, + "id": { + "description": "id of the created service specification", + "type": "string" + }, + "href": { + "description": "reference to the created service specification", + "type": "string" + }, + "description": { + "description": "", + "type": "string" + }, + "@type": { + "description": "This attribute allows to dynamically extends TMF class. Valued with 'ONAPservice'. We use this feature to add following attributes:\ntoscaModelURL\ntoscaResourceName\ncategory (1)\nsubcategory (1)\ndistributionStatus", + "type": "string", + "default": "ONAPservice" + }, + "@schemaLocation": { + "description": "Not used", + "type": "string" + }, + "@baseType": { + "description": "Not used", + "type": "string" + }, + "toscaModelURL": { + "description": "Additional attribute (not in the TMF API) - extended through @type - toscaModelURL", + "type": "string" + }, + "toscaResourceName": { + "description": "Additional attribute (not in the TMF API) - extended through @type - toscaResourceName", + "type": "string" + }, + "category": { + "description": "Additional attribute - extended through @type - category\nPlease note that this attribute is managed in TMF - in future release we'll introduce category resource", + "type": "string" + }, + "subcategory": { + "description": "Additional attribute - extended through @type - category\nPlease note that this attribute is managed in TMF - in future release we'll introduce category resource", + "type": "string" + }, + "version": { + "description": "Service specification version", + "type": "string" + }, + "lifecycleStatus": { + "$ref": "#/definitions/LifecycleStatusValues" + }, + "targetServiceSchema": { + "$ref": "#/definitions/TargetServiceSchemaRef" + }, + "attachment": { + "type": "array", + "items": { + "$ref": "#/definitions/Attachment" + } + }, + "relatedParty": { + "type": "array", + "items": { + "$ref": "#/definitions/RelatedPartyRef" + } + }, + "resourceSpecification": { + "type": "array", + "items": { + "$ref": "#/definitions/ResourceSpecificationRef" + } + }, + "serviceSpecCharacteristic": { + "type": "array", + "items": { + "$ref": "#/definitions/ServiceSpecCharacteristicRequest" + } + } + } + }, "ServiceSpecCharacteristic": { - "description": "A characteristic quality or distinctive feature of a ServiceSpecification. \nServiceSpecCharacteristic are retrieved in the serviceTosca file in the topology_template section in the inputs section.", + "description": "A characteristic quality or distinctive feature of a ServiceSpecification. \nServiceSpecCharacteristics are retrieved in the serviceTosca file in the topology_template section in the inputs section.", "type": "object", "properties": { "name": { @@ -691,7 +782,7 @@ "type": "string" }, "isDefault": { - "description": "To describe whether the attribute is to be included by default or not", + "description": "To describe whether the attribute is to be included by default", "type": "boolean" }, "value": { diff --git a/docs/offeredapis/api_serviceCatalog/swagger.yaml b/docs/offeredapis/api_serviceCatalog/swagger.yaml index b246471..a6fd9d3 100644 --- a/docs/offeredapis/api_serviceCatalog/swagger.yaml +++ b/docs/offeredapis/api_serviceCatalog/swagger.yaml @@ -146,7 +146,7 @@ paths: "201": description: "Created" schema: - $ref: "#/definitions/ServiceSpecificationRequest" + $ref: "#/definitions/ServiceSpecificationResponse" "400": description: "Bad Request\n\nList of supported error codes:\n- 20: Invalid\ \ URL parameter value\n- 21: Missing body\n- 22: Invalid body\n- 23: Missing\ @@ -485,6 +485,11 @@ definitions: \ be instantiated. By sharing the same specification, these services would therefore\ \ share the same set of characteristics." type: "object" + required: + - name + - description + - category + - relatedParty properties: name: description: "Name of the service specification" @@ -546,6 +551,79 @@ definitions: type: "array" items: $ref: "#/definitions/ServiceSpecCharacteristicRequest" + ServiceSpecificationResponse: + description: "ServiceSpecification is a class that offers characteristics to describe\ + \ a type of service. Functionally, it acts as a template by which Services may\ + \ be instantiated. By sharing the same specification, these services would therefore\ + \ share the same set of characteristics." + type: "object" + properties: + name: + description: "Name of the service specification" + type: "string" + id: + description: "id of the created service specification" + type: "string" + href: + description: "reference to the created service specification" + type: "string" + description: + description: "" + type: "string" + '@type': + description: "This attribute allows to dynamically extends TMF class. Valued\ + \ with 'ONAPservice'. We use this feature to add following attributes:\n\ + toscaModelURL\ntoscaResourceName\ncategory (1)\nsubcategory\ + \ (1)\ndistributionStatus" + type: "string" + default: "ONAPservice" + '@schemaLocation': + description: "Not used" + type: "string" + '@baseType': + description: "Not used" + type: "string" + toscaModelURL: + description: "Additional attribute (not in the TMF API) - extended through\ + \ @type - toscaModelURL" + type: "string" + toscaResourceName: + description: "Additional attribute (not in the TMF API) - extended through\ + \ @type - toscaResourceName" + type: "string" + category: + description: "Additional attribute - extended through @type - category\nPlease\ + \ note that this attribute is managed in TMF - in future release we'll introduce\ + \ category resource" + type: "string" + subcategory: + description: "Additional attribute - extended through @type - category\nPlease\ + \ note that this attribute is managed in TMF - in future release we'll introduce\ + \ category resource" + type: "string" + version: + description: "Service specification version" + type: "string" + lifecycleStatus: + $ref: "#/definitions/LifecycleStatusValues" + targetServiceSchema: + $ref: "#/definitions/TargetServiceSchemaRef" + attachment: + type: "array" + items: + $ref: "#/definitions/Attachment" + relatedParty: + type: "array" + items: + $ref: "#/definitions/RelatedPartyRef" + resourceSpecification: + type: "array" + items: + $ref: "#/definitions/ResourceSpecificationRef" + serviceSpecCharacteristic: + type: "array" + items: + $ref: "#/definitions/ServiceSpecCharacteristicRequest" ServiceSpecCharacteristic: description: "A characteristic quality or distinctive feature of a ServiceSpecification.\ \ \nServiceSpecCharacteristics are retrieved in the serviceTosca file in the\ -- cgit 1.2.3-korg