3 description: "serviceCatalog API designed for ONAP Beijing Release.\nThis API is\
4 \ build from TMF open API17.5. \nOnly operation GET (by id & byList) for resource\
5 \ serviceSpecification is available\n\n"
7 title: "API ServiceCatalog"
10 backgroundColor: "#FFFFFF"
12 basePath: "/nbi/api/v1"
16 - "application/json;charset=utf-8"
18 - name: "ServiceSpecification"
21 /serviceSpecification:
24 - "ServiceSpecification"
26 - "application/json;charset=utf-8"
27 operationId: "serviceSpecificationFind"
28 summary: "List service specifications"
29 description: "This operation returns service specifications from a catalog.\n\
30 Only a predefined set of attribute is proposed : Based on SDC limitations,\
31 \ only attributes category and distributionStatus are available for serviceSpecification\
32 \ filtering\nFields attribute could be used to filter attributes retrieved"
38 description: "Field selection - used to filtering the attributes to be retreived"
43 description: "Service Category (filter)"
45 - name: "distributionStatus"
48 description: "Service distribution status (filter)"
56 $ref: "#/definitions/ServiceSpecification"
58 description: "Bad Request\n\nList of supported error codes:\n- 20: Invalid\
59 \ URL parameter value\n- 21: Missing body\n- 22: Invalid body\n- 23: Missing\
60 \ body field\n- 24: Invalid body field\n- 25: Missing header\n- 26: Invalid\
61 \ header value\n- 27: Missing query-string parameter\n- 28: Invalid query-string\
64 $ref: "#/definitions/ErrorRepresentation"
66 description: "Unauthorized\n\nList of supported error codes:\n- 40: Missing\
67 \ credentials\n- 41: Invalid credentials\n- 42: Expired credentials"
69 $ref: "#/definitions/ErrorRepresentation"
71 description: "Forbidden\n\nList of supported error codes:\n- 50: Access\
72 \ denied\n- 51: Forbidden requester\n- 52: Forbidden user\n- 53: Too many\
75 $ref: "#/definitions/ErrorRepresentation"
77 description: "Not Found\n\nList of supported error codes:\n- 60: Resource\
80 $ref: "#/definitions/ErrorRepresentation"
82 description: "Unprocessable entity\n\nFunctional error"
84 $ref: "#/definitions/ErrorRepresentation"
86 description: "Internal Server Error\n\nList of supported error codes:\n\
89 $ref: "#/definitions/ErrorRepresentation"
91 description: "Service Unavailable\n\nList of supported error codes:\n- 5:\
92 \ The service is temporarily unavailable\n- 6: Orange API is over capacity,\
95 $ref: "#/definitions/ErrorRepresentation"
96 /serviceSpecification/{id}:
99 - "ServiceSpecification"
101 - "application/json;charset=utf-8"
102 operationId: "serviceSpecificationGet"
103 summary: "Retrieve a service specification"
104 description: "This operation returns a service specification by its id from\
105 \ a catalog. Attribute selection is enabled using the fields attribute."
115 description: "Attribute selection"
121 $ref: "#/definitions/ServiceSpecification"
123 description: "Bad Request\n\nList of supported error codes:\n- 20: Invalid\
124 \ URL parameter value\n- 21: Missing body\n- 22: Invalid body\n- 23: Missing\
125 \ body field\n- 24: Invalid body field\n- 25: Missing header\n- 26: Invalid\
126 \ header value\n- 27: Missing query-string parameter\n- 28: Invalid query-string\
129 $ref: "#/definitions/ErrorRepresentation"
131 description: "Unauthorized\n\nList of supported error codes:\n- 40: Missing\
132 \ credentials\n- 41: Invalid credentials\n- 42: Expired credentials"
134 $ref: "#/definitions/ErrorRepresentation"
136 description: "Forbidden\n\nList of supported error codes:\n- 50: Access\
137 \ denied\n- 51: Forbidden requester\n- 52: Forbidden user\n- 53: Too many\
140 $ref: "#/definitions/ErrorRepresentation"
142 description: "Not Found\n\nList of supported error codes:\n- 60: Resource\
145 $ref: "#/definitions/ErrorRepresentation"
147 description: "Unprocessable entity\n\nFunctional error"
149 $ref: "#/definitions/ErrorRepresentation"
151 description: "Internal Server Error\n\nList of supported error codes:\n\
154 $ref: "#/definitions/ErrorRepresentation"
156 description: "Service Unavailable\n\nList of supported error codes:\n- 5:\
157 \ The service is temporarily unavailable\n- 6: Orange API is over capacity,\
160 $ref: "#/definitions/ErrorRepresentation"
162 LifecycleStatusValues:
163 description: "Service lifecycle value from ONAP SDC"
166 - "NOT_CERTIFIED_CHECKOUT"
167 - "NOT_CERTIFIED_CHECKIN"
168 - "READY_FOR_CERTIFICATION"
169 - "CERTIFICATION_IN_PROGRESS"
172 description: "Service distribution status from ONAP."
175 - "DISTRIBUTION_NOT_APPROVED"
176 - "DISTRIBUTION_APPROVED"
178 - "DISTRIBUTION_REJECTED"
180 description: "This class is used to describe error.\nfor nbi Beijing release we\
181 \ do not manage additional error for serviceCatalog"
188 description: "Application related code (as defined in the API or from a common\
193 description: "Text that explains the reason for error. This can be shown to\
197 description: "Text that provide more details and corrective actions related\
198 \ to the error. This can be shown to a client user"
201 description: "http error code extension like 400-2"
204 description: "url pointing to documentation describing the error"
207 description: "The class type of a REST resource."
210 description: "it provides a link to the schema describing a REST resource."
213 description: "A time period"
217 description: "Start date and time of the period"
221 description: "End date and time of the period"
225 description: "Party linked to the service catalog.\nin nbi we retrieve information\
226 \ about last updater of the service in SDC"
230 description: "Unique identifier of the related party. Filled with lastUpdaterUserId"
233 description: "Role payed by the related party\nOnly role 'lastUpdater' is\
234 \ retrieved in Beijing release"
237 description: "Name of the related party - Filled with lastUpdatedFullName"
239 ServiceSpecification:
240 description: "ServiceSpecification is a class that offers characteristics to describe\
241 \ a type of service. Functionally, it acts as a template by which Services may\
242 \ be instantiated. By sharing the same specification, these services would therefore\
243 \ share the same set of characteristics.\nthe service information are retrieved\
250 description: "Unique identifier of the service specification. Filled with\
254 description: "Reference of the service specification- not mapped in Beijing"
257 description: "Name of the service specification- Filled with SDC Service name"
260 description: "A narrative that explains in detail what the service specification\
261 \ is - Filled with SDC Service description"
264 description: "This attribute allows to dynamically extends TMF class. Valued\
265 \ with 'ONAPservice'. We used this features to add following attributes:\n\
266 invariantUUID\ntoscaModelURL\ntoscaResourceName\ncategory (1)\nsubcategory\
267 \ (1)\ndistributionStatus"
269 default: "ONAPservice"
271 description: "Not used for Beijing release"
274 description: "Not used for Beijing release"
277 description: "Additional attribute (not in the TMF API) - extended through\
278 \ @type - invariantUUID"
281 description: "Additional attribute (not in the TMF API) - extended through\
282 \ @type - toscaModelURL"
285 description: "Additional attribute (not in the TMF API) - extended through\
286 \ @type - toscaResourceName"
289 description: "Additional attribute - extended through @type - category\nPlease\
290 \ note that this attribute is managed in TMF - in future release we'll introduce\
294 description: "Additional attribute - extended through @type - category\nPlease\
295 \ note that this attribute is managed in TMF - in future release we'll introduce\
299 $ref: "#/definitions/DistributionStatus"
301 description: "Service specification version - Filled with SDC Service version"
304 $ref: "#/definitions/LifecycleStatusValues"
306 $ref: "#/definitions/TargetServiceSchemaRef"
310 $ref: "#/definitions/Attachment"
314 $ref: "#/definitions/RelatedPartyRef"
315 resourceSpecification:
318 $ref: "#/definitions/ResourceSpecificationRef"
319 serviceSpecCharacteristic:
322 $ref: "#/definitions/ServiceSpecCharacteristic"
323 ServiceSpecCharacteristic:
324 description: "A characteristic quality or distinctive feature of a ServiceSpecification.\
325 \ \nServiceSpecCharacteristic are retrieved in the serviceTosca file in the\
326 \ topology_template section in the inputs section."
330 description: "Name of the characteristic - Filled with parameter_name"
333 description: "A narrative that explains in detail what the characteristic\
334 \ is - Filled with parameter_description"
337 description: "A kind of value that the characteristic can take on, such as\
338 \ numeric, text and so forth - Filled with parameter_type"
341 description: "This attribute allows to dynamically extends TMF class. Valued\
342 \ with: 'ONAPserviceCharacteristic'. We do not used this features in nbi\
346 description: "An url pointing to type description - we do not use it in nbi\
350 description: "A parameter to define if the characteristic is mandatory - Filled\
351 \ from parameter_required – if not fielded by default ‘true’"
355 description: "Status of the characteristic - filled with status_value"
357 serviceSpecCharacteristicValue:
360 $ref: "#/definitions/ServiceSpecCharacteristicValue"
362 description: "An attachment is a file uses to describe the service.\nIn nbi we\
363 \ use attachment to retrieve ONAP artifacts."
367 description: "Unique identifier of the attachment - filled with artifactUUID."
370 description: "Name of the attachment - filled with artifactName"
373 description: "Description of the attachment - filled with artifactDescription"
376 description: "This attribute allows to dynamically extends TMF class. Valued\
377 \ with 'ONAPartifact'. We used this features to add following attributes:\
378 \ \nartifactLabel\nartifactGroupType\nartifactTimeout\nartifactChecksum\n\
379 artifactVersion\ngeneratedFromUUID"
381 default: "ONAPartifact"
383 description: "Additional attribute (not in the TMF API) - extended through\
384 \ @type - artifactLabel"
387 description: "Additional attribute (not in the TMF API) - extended through\
388 \ @type - artifactGroupType"
391 description: "Additional attribute (not in the TMF API) - extended through\
392 \ @type - artifactTimeout"
395 description: "Additional attribute (not in the TMF API) - extended through\
396 \ @type - artifactChecksum"
399 description: "Additional attribute (not in the TMF API) - extended through\
400 \ @type - artifactVersion"
403 description: "Additional attribute (not in the TMF API) - extended through\
404 \ @type - generatedFromUUID"
407 description: "Uniform Resource Locator, is a web page address - filled with\
411 description: "Filled with artifactType"
413 ServiceSpecCharacteristicValue:
414 description: "A number or text that can be assigned to a service specification\
415 \ characteristic.\nServiceSpecCharacteristicValue are retrieved in the service\
420 description: "A kind of value that the characteristic can take on, such as\
421 \ numeric, text, and so forth\nRetrieved in the Tosca in the topology_template\
422 \ section in the inputs section - parameter_type. \nWe do not manage parameter_type=\
423 \ list or map for Beijing release"
426 description: "Information calculated from parameter default in the Tosca file"
429 description: "A discrete value that the characteristic can take on"
431 ResourceSpecificationRef:
432 description: "A list of resourceSpec identified to deliver the service.\nfor nbi\
433 \ we retrieve resource information available in service description (through\
434 \ SDC api) bu as well information retrieved in the TOSCA file."
438 description: "Unique identifier of the resource specification - filled with\
442 description: "Version for this resource specification - filled with resourceVersion"
445 description: "Name of the resource specification - filled with resourceName"
448 description: "This attribute allows to dynamically extends TMF class. Valued\
449 \ with: 'ONAPresource'. We used this features to add following attributes:\n\
450 resourceInstanceName\nresourceInvariantUUID\nresourceType\nmodelCustomizationName\n\
451 modelCustomizationId"
453 default: "ONAPresource"
454 resourceInstanceName:
455 description: "Additional attribute (not in the TMF API) - extended through\
456 \ @type - resourceInstanceName"
458 resourceInvariantUUID:
459 description: "Additional attribute (not in the TMF API) - extended through\
460 \ @type - resourceInvariantUUID"
463 description: "Additional attribute (not in the TMF API) - extended through\
464 \ @type - resoucreType"
466 modelCustomizationName:
467 description: "Additional attribute (not in the TMF API) - extended through\
468 \ @type - Retrieved in the TOSCA file : attribute name in topology_template/node_template\
471 modelCustomizationId:
472 description: "Additional attribute (not in the TMF API) - extended through\
473 \ @type - Retrieved in the TOSCA file : attribute customizationUUID in topology_template/node_template\
476 TargetServiceSchemaRef: