02b57822b3feb3704371662bebb9c1eb724b9a6c
[externalapi/nbi.git] / docs / consumedapis / consumedapis.rst
1 .. SPDX-License-Identifier: CC-BY-4.0
2 .. Copyright 2018 ORANGE
3
4
5 Consumed APIs
6 =============
7
8
9 NBI application is interacting with 3 ONAP APIs
10
11 *******
12 SDC API
13 *******
14
15 This API is used to provide Service Catalog information
16 Information are retrieved in SDC (and in TOSCA "service template" file)
17 - Only GET operation is provided - this API DID NOT UPDATE SDC
18
19 ::
20
21     SDC_ROOT_URL = "/sdc/v1/catalog/services/"
22
23     SDC_GET_PATH = "/metadata"
24
25     SDC_TOSCA_PATH = "/toscaModel"
26
27
28 *******
29 AAI API
30 *******
31
32 This API is used to provide Service Inventory information
33 This API retrieves service(s) in the AAI inventory. Only following attributes
34 will be retrieve in service inventory: id, name and type
35 (no state or startDate available )
36
37 ::
38
39     AAI_GET_TENANTS_PATH = "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/$onap.cloudOwner/$onap.lcpCloudRegionId/tenants"
40
41     AAI_GET_CUSTOMER_PATH = "/aai/v11/business/customers/customer/"
42
43     AAI_GET_SERVICES_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions"
44
45     AAI_PUT_SERVICE_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/
46
47     AAI_GET_SERVICE_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/service-instance/$serviceId"
48
49     AAI_GET_SERVICE_INSTANCES_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/"
50
51
52
53 ******
54 SO API
55 ******
56
57 This API is used to perform Service Order and thus instantiate a service.
58 Distinct SO APIs are used for serviceInstance creation request depending on the
59 serviceSpecification category (set in SDC). If service could be delivered
60 end-to-end from one request category is set to 'E2E Service'.
61 In this case NBI uses
62
63 ::
64
65     MSO_CREATE_E2ESERVICE_INSTANCE_PATH = "/ecomp/mso/infra/e2eServiceInstances/v3"
66
67     MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v6/"
68
69     MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/v6/"
70
71
72 else following API are used:
73
74 ::
75
76     MSO_CREATE_SERVICE_INSTANCE_PATH = "/ecomp/mso/infra/serviceInstance/v6"
77
78     MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v6/"
79
80     MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/v6/"