summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoraosull01 <adrian.osullivan@huawei.com>2020-01-07 12:28:11 +0000
committeraosull01 <adrian.osullivan@huawei.com>2020-01-07 12:28:11 +0000
commitdf23184a2288013d954392d3f5e59787aeca41bc (patch)
treee52939d1d428de53f87b1f5c36d197f5dda6e679
parentc1ae66b947edefe90ffb9c788db1ee75779b0624 (diff)
Update other swaggers as per guidelines
Issue-ID: EXTAPI-357 Signed-off-by: aosull01 <adrian.osullivan@huawei.com> Change-Id: I906f81722074c9a679ac6048e544e884646ed760
-rw-r--r--docs/offeredapis/api_hub/swagger.json25
-rw-r--r--docs/offeredapis/api_hub/swagger.yaml23
-rw-r--r--docs/offeredapis/api_serviceInventory/swagger.json21
-rw-r--r--docs/offeredapis/api_serviceInventory/swagger.yaml19
-rw-r--r--docs/offeredapis/api_serviceOrder/swagger.json25
-rw-r--r--docs/offeredapis/api_serviceOrder/swagger.yaml27
-rw-r--r--docs/offeredapis/api_status/swagger.json19
-rw-r--r--docs/offeredapis/api_status/swagger.yaml15
8 files changed, 127 insertions, 47 deletions
diff --git a/docs/offeredapis/api_hub/swagger.json b/docs/offeredapis/api_hub/swagger.json
index 2b5e61c..66d18a4 100644
--- a/docs/offeredapis/api_hub/swagger.json
+++ b/docs/offeredapis/api_hub/swagger.json
@@ -4,15 +4,26 @@
"info": {
"description": "Provides the ability to subscribe to and unsubscribe from External API notifications.\n\n**Main operation**\n\n```\nPOST /hub\n```\n\nrequest sample 1\n\n```\n{\n \"callback\": \"http://mydomain/notification\",\n \"query\": \"eventType = ServiceOrderCreationNotification\"\n}\n```\n\nrequest sample 2\n\n```\n{\n \"callback\": \"http://mydomain/notification\",\n \"query\": \"eventType=ServiceOrderCreationNotification,ServiceOrderStateChangeNotification\"\n}\n```\n\n**EventType for serviceOrdering**\n\n- ServiceOrderCreationNotification\n- ServiceOrderStateChangeNotification\n- ServiceOrderItemStateChangeNotification\n\n**EventType for serviceInventory**\n\n- ServiceCreationNotification\n- ServiceAttributeValueChangeNotification\n- ServiceRemoveNotification\n\n",
"version": "4.0.1",
- "title": "API Hub",
+ "title": "Hub API",
+ "contact": {
+ "name": "ONAP",
+ "url": "https://onap.readthedocs.io",
+ "email": "onap-discuss@lists.onap.org"
+ },
+ "license": {
+ "name": "Apache 2.0",
+ "url": "http://www.apache.org/licenses/LICENSE-2.0"
+ },
+ "x-planned-retirement-date": "205001",
+ "x-component": "NBI",
"x-logo": {
"url": "/redoc/logo.png",
"backgroundColor": "#FFFFFF"
}
},
- "host": "api.orange.com",
- "basePath": "/",
+ "host": "serverRoot:30274",
+ "basePath": "/nbi/api/v4",
"schemes": [
"http"
],
@@ -38,7 +49,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "hubCreate",
+ "operationId": "hub_Create",
"summary": "create hub",
"description": "",
"deprecated": false,
@@ -72,7 +83,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "hubFind",
+ "operationId": "hub_Find",
"summary": "find hub",
"description": "",
"deprecated": false,
@@ -99,7 +110,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "hubGet",
+ "operationId": "hub_Get",
"summary": "get hub",
"description": "",
"deprecated": false,
@@ -127,7 +138,7 @@
"tags": [
"Hub"
],
- "operationId": "hubDelete",
+ "operationId": "hub_Delete",
"summary": "delete hub",
"description": "",
"deprecated": false,
diff --git a/docs/offeredapis/api_hub/swagger.yaml b/docs/offeredapis/api_hub/swagger.yaml
index dc8e16b..5ddb5d8 100644
--- a/docs/offeredapis/api_hub/swagger.yaml
+++ b/docs/offeredapis/api_hub/swagger.yaml
@@ -23,12 +23,21 @@ info:
\n**EventType for serviceInventory**\n\n- ServiceCreationNotification\n- ServiceAttributeValueChangeNotification\n\
- ServiceRemoveNotification\n\n"
version: "4.0.1"
- title: "API Hub"
+ title: "Hub API"
+ contact:
+ name: "ONAP"
+ url: "https://onap.readthedocs.io"
+ email: "onap-discuss@lists.onap.org"
+ license:
+ name: "Apache 2.0"
+ url: "http://www.apache.org/licenses/LICENSE-2.0"
+ x-planned-retirement-date: "205001"
+ x-component: "NBI"
x-logo:
url: "/redoc/logo.png"
backgroundColor: "#FFFFFF"
-host: "api.orange.com"
-basePath: "/"
+host: "serverRoot:30274"
+basePath: "/nbi/api/v4"
schemes:
- "http"
produces:
@@ -45,7 +54,7 @@ paths:
- "application/json;charset=utf-8"
produces:
- "application/json;charset=utf-8"
- operationId: "hubCreate"
+ operationId: "hub_Create"
summary: "create hub"
description: ""
deprecated: false
@@ -66,7 +75,7 @@ paths:
- "Hub"
produces:
- "application/json;charset=utf-8"
- operationId: "hubFind"
+ operationId: "hub_Find"
summary: "find hub"
description: ""
deprecated: false
@@ -83,7 +92,7 @@ paths:
- "Hub"
produces:
- "application/json;charset=utf-8"
- operationId: "hubGet"
+ operationId: "hub_Get"
summary: "get hub"
description: ""
deprecated: false
@@ -100,7 +109,7 @@ paths:
delete:
tags:
- "Hub"
- operationId: "hubDelete"
+ operationId: "hub_Delete"
summary: "delete hub"
description: ""
deprecated: false
diff --git a/docs/offeredapis/api_serviceInventory/swagger.json b/docs/offeredapis/api_serviceInventory/swagger.json
index f67e1b6..47e7610 100644
--- a/docs/offeredapis/api_serviceInventory/swagger.json
+++ b/docs/offeredapis/api_serviceInventory/swagger.json
@@ -4,14 +4,25 @@
"info": {
"description": "Query information about instantiated services\n\nList of available subscription for serviceInventory notifications, see /hub resources for more information:\n\n- ServiceCreationNotification\n- ServiceAttributeValueChangeNotification\n- ServiceRemoveNotification\n\n",
"version": "4.0.1",
- "title": "API ServiceInventory",
+ "title": "ServiceInventory API",
+ "contact": {
+ "name": "ONAP",
+ "url": "https://onap.readthedocs.io",
+ "email": "onap-discuss@lists.onap.org"
+ },
+ "license": {
+ "name": "Apache 2.0",
+ "url": "http://www.apache.org/licenses/LICENSE-2.0"
+ },
+ "x-planned-retirement-date": "205001",
+ "x-component": "NBI",
"x-logo": {
"url": "/redoc/logo.png",
"backgroundColor": "#FFFFFF"
}
},
- "host": "localhost:8080",
+ "host": "serverRoot:30274",
"basePath": "/nbi/api/v4",
"schemes": [
"http"
@@ -39,7 +50,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "serviceFind",
+ "operationId": "service_Find",
"summary": "List services",
"description": "This operation list service entities. \nAttribute selection is restricted. \nfields attribute may be used to filter retrieved attribute(s) for each service",
"deprecated": false,
@@ -109,7 +120,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "serviceGet",
+ "operationId": "service_Get",
"summary": "Retrieve a service",
"description": "This operation retrieves a service entity. \nAttribute selection is enabled for all first level attributes.",
"deprecated": false,
@@ -145,7 +156,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "notificationCreate",
+ "operationId": "notification_Create",
"summary": "NBI will send notification to this operation provided by subscribers",
"description": "",
"deprecated": false,
diff --git a/docs/offeredapis/api_serviceInventory/swagger.yaml b/docs/offeredapis/api_serviceInventory/swagger.yaml
index 8f2ebee..f783679 100644
--- a/docs/offeredapis/api_serviceInventory/swagger.yaml
+++ b/docs/offeredapis/api_serviceInventory/swagger.yaml
@@ -18,11 +18,20 @@ info:
\ information:\n\n- ServiceCreationNotification\n- ServiceAttributeValueChangeNotification\n\
- ServiceRemoveNotification\n\n"
version: "4.0.1"
- title: "API ServiceInventory"
+ title: "ServiceInventory API"
+ contact:
+ name: "ONAP"
+ url: "https://onap.readthedocs.io"
+ email: "onap-discuss@lists.onap.org"
+ license:
+ name: "Apache 2.0"
+ url: "http://www.apache.org/licenses/LICENSE-2.0"
+ x-planned-retirement-date: "205001"
+ x-component: "NBI"
x-logo:
url: "/redoc/logo.png"
backgroundColor: "#FFFFFF"
-host: "localhost:8080"
+host: "serverRoot:30274"
basePath: "/nbi/api/v4"
schemes:
- "http"
@@ -41,7 +50,7 @@ paths:
- "Service"
produces:
- "application/json;charset=utf-8"
- operationId: "serviceFind"
+ operationId: "service_Find"
summary: "List services"
description: "This operation list service entities. \nAttribute selection is\
\ restricted. \nfields attribute may be used to filter retrieved attribute(s)\
@@ -86,7 +95,7 @@ paths:
- "Service"
produces:
- "application/json;charset=utf-8"
- operationId: "serviceGet"
+ operationId: "service_Get"
summary: "Retrieve a service"
description: "This operation retrieves a service entity. \nAttribute selection\
\ is enabled for all first level attributes."
@@ -109,7 +118,7 @@ paths:
- "application/json;charset=utf-8"
produces:
- "application/json;charset=utf-8"
- operationId: "notificationCreate"
+ operationId: "notification_Create"
summary: "NBI will send notification to this operation provided by subscribers"
description: ""
deprecated: false
diff --git a/docs/offeredapis/api_serviceOrder/swagger.json b/docs/offeredapis/api_serviceOrder/swagger.json
index 947cfe0..6c01155 100644
--- a/docs/offeredapis/api_serviceOrder/swagger.json
+++ b/docs/offeredapis/api_serviceOrder/swagger.json
@@ -1,15 +1,26 @@
{
"swagger": "2.0",
"info": {
- "description": "Request the instantiation of a service\n\nA Service Order is a type of order which can be used to describe a group of operations on service – one service order item per service. An action at the level of the service order item describe the operation to be done on a service (add, terminate for example). The service order is triggered from the BSS system in charge of the product order management to ONAP that will manage the service fulfillment.\n\nList of available subscription for serviceOrdering notifications, see /hub resources for more information:\n\n- ServiceOrderCreationNotification\n- ServiceOrderStateChangeNotification\n- ServiceOrderItemStateChangeNotification\n\n",
+ "description": "Request the instantiation, deletion or modification of a service\n\nA Service Order is a type of order which can be used to describe a group of operations on service – one service order item per service. An action at the level of the service order item describes the operation to be completed on a service (add, delete for example). The service order is triggered from external system such as the BSS system in charge of the product order management to ONAP that will manage the service fulfillment.\n\nList of available subscription for serviceOrdering notifications, see /hub resources for more information:\n\n- ServiceOrderCreationNotification\n- ServiceOrderStateChangeNotification\n- ServiceOrderItemStateChangeNotification\n\n",
"version": "4.0.1",
- "title": "API ServiceOrder",
+ "title": "ServiceOrder API",
+ "contact": {
+ "name": "ONAP",
+ "url": "https://onap.readthedocs.io",
+ "email": "onap-discuss@lists.onap.org"
+ },
+ "license": {
+ "name": "Apache 2.0",
+ "url": "http://www.apache.org/licenses/LICENSE-2.0"
+ },
+ "x-planned-retirement-date": "205001",
+ "x-component": "NBI",
"x-logo": {
"url": "/redoc/logo.png",
"backgroundColor": "#FFFFFF"
}
},
- "host": "localhost:8080",
+ "host": "serverRoot:30274",
"basePath": "/nbi/api/v4",
"schemes": [
"http"
@@ -39,7 +50,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "serviceOrderCreate",
+ "operationId": "serviceOrder_Create",
"summary": "Create a service order",
"description": "This operation creates a service order entity.\nThe TMF Open API specification document provides the list of mandatory and non mandatory attributes when creating a ServiceOrder, including any possible rule conditions and applicable default values.\nPOST should be used without specifying the id and the href, the Service Order Management system is in charge of generating the id + href for the ServiceOrder.\n\nIn Beijing Release, NBI will use only POST {{url}}/ecomp/mso/infra/serviceInstances/v4 SO API. This mean that only the 'service-instance' level will be created in AAI. Additional resource like VNF and/OR VF are not created.\n\nIn Casablanca release, NBI has been improved to also be able to use POST {{url}}/e2eServiceInstances/v3 SO API. This API is able to instantiate in ONAP E2E service; This is useful for CCVPN and VoLTE UC.\nDepending on the service category defined in SDC, NBI will use one or the other SO API. If category starts with e2e, NBI will use {url}}/e2eServiceInstances/v3 SO API - else it will use {{url}}/ecomp/mso/infra/serviceInstances/v4 SO API.",
"deprecated": false,
@@ -77,7 +88,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "serviceOrderFind",
+ "operationId": "serviceOrder_Find",
"summary": "List service orders",
"description": "Retrieve and list service order entities according to given criteria.\nOnly a predefined set of attribute is proposed.\nAttribute selection could be described in the fields attribute.",
"deprecated": false,
@@ -174,7 +185,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "serviceOrderGet",
+ "operationId": "serviceOrder_Get",
"summary": "Retrieve a service order",
"description": "This operation retrieves a service order entity. \nAttribute selection is enabled for all first level attributes.",
"deprecated": false,
@@ -222,7 +233,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "notificationCreate",
+ "operationId": "notification_Create",
"summary": "NBI will send notification to this operation provided by subscribers",
"description": "Notification structure depends of the eventType:\n\n- ServiceOrderCreationNotification\n- ServiceOrderStateChangeNotification\n\n```\n{\n \"eventId\": \"string\",\n \"eventDate\": \"2019-03-12T16:21:27.530Z\",\n \"eventType\": \"string\",\n \"event\": {\n \"id\": \"string\",\n \"href\": \"string\",\n \"externalId\": \"string\",\n \"state\": \"acknowledged\",\n \"orderDate\": \"2019-03-12T16:21:27.530Z\",\n \"completionDateTime\": \"2019-03-12T16:21:27.530Z\"\n }\n}\n```\n\n- ServiceOrderItemStateChangeNotification\n\n```\n{\n \"eventId\": \"string\",\n \"eventDate\": \"2019-03-12T16:21:44.066Z\",\n \"eventType\": \"string\",\n \"event\": {\n \"id\": \"string\",\n \"href\": \"string\",\n \"externalId\": \"string\",\n \"state\": \"acknowledged\",\n \"orderDate\": \"2019-03-12T16:21:44.066Z\",\n \"completionDateTime\": \"2019-03-12T16:21:44.066Z\",\n \"orderItem\": [\n {\n \"id\": \"string\",\n \"action\": \"add\",\n \"state\": \"acknowledged\",\n \"service\": {\n \"id\": \"string\",\n \"href\": \"string\",\n \"name\": \"string\",\n \"serviceState\": \"string\",\n \"serviceCharacteristic\": [\n {\n \"name\": \"string\",\n \"valueType\": \"string\",\n \"value\": {\n \"serviceCharacteristicValue\": \"string\"\n }\n }\n ],\n \"serviceRelationship\": [\n {\n \"type\": \"reliesOn\"\n }\n ],\n \"relatedParty\": [\n {\n \"id\": \"string\",\n \"href\": \"string\",\n \"role\": \"string\",\n \"name\": \"string\",\n \"@referredType\": \"string\"\n }\n ],\n \"serviceSpecification\": {\n \"id\": \"string\",\n \"href\": \"string\",\n \"name\": \"string\",\n \"version\": \"string\",\n }\n }\n }\n ]\n }\n}\n```",
"deprecated": false,
diff --git a/docs/offeredapis/api_serviceOrder/swagger.yaml b/docs/offeredapis/api_serviceOrder/swagger.yaml
index 2108fc3..0ab06bc 100644
--- a/docs/offeredapis/api_serviceOrder/swagger.yaml
+++ b/docs/offeredapis/api_serviceOrder/swagger.yaml
@@ -13,21 +13,30 @@
# limitations under the License.swagger: "2.0"
swagger: "2.0"
info:
- description: "Request the instantiation of a service\n\nA Service Order is a type\
+ description: "Request the instantiation, deletion or modification of a service\n\nA Service Order is a type\
\ of order which can be used to describe a group of operations on service – one\
\ service order item per service. An action at the level of the service order\
- \ item describe the operation to be done on a service (add, terminate for example).\
- \ The service order is triggered from the BSS system in charge of the product\
+ \ item describe the operation to be done on a service (add, delete for example).\
+ \ The service order is triggered from external system such as the BSS system in charge of the product\
\ order management to ONAP that will manage the service fulfillment.\n\nList of\
\ available subscription for serviceOrdering notifications, see /hub resources\
\ for more information:\n\n- ServiceOrderCreationNotification\n- ServiceOrderStateChangeNotification\n\
- ServiceOrderItemStateChangeNotification\n\n"
version: "4.0.1"
- title: "API ServiceOrder"
+ title: "ServiceOrder API"
+ contact:
+ name: "ONAP"
+ url: "https://onap.readthedocs.io"
+ email: "onap-discuss@lists.onap.org"
+ license:
+ name: "Apache 2.0"
+ url: "http://www.apache.org/licenses/LICENSE-2.0"
+ x-planned-retirement-date: "205001"
+ x-component: "NBI"
x-logo:
url: "/redoc/logo.png"
backgroundColor: "#FFFFFF"
-host: "localhost:8080"
+host: "serverRoot:30274"
basePath: "/nbi/api/v4"
schemes:
- "http"
@@ -47,7 +56,7 @@ paths:
- "application/json;charset=utf-8"
produces:
- "application/json;charset=utf-8"
- operationId: "serviceOrderCreate"
+ operationId: "serviceOrder_Create"
summary: "Create a service order"
description: "This operation creates a service order entity.\nThe TMF Open API\
\ specification document provides the list of mandatory and non mandatory\
@@ -87,7 +96,7 @@ paths:
- "ServiceOrder"
produces:
- "application/json;charset=utf-8"
- operationId: "serviceOrderFind"
+ operationId: "serviceOrder_Find"
summary: "List service orders"
description: "Retrieve and list service order entities according to given criteria.\n\
Only a predefined set of attribute is proposed.\nAttribute selection could\
@@ -161,7 +170,7 @@ paths:
- "ServiceOrder"
produces:
- "application/json;charset=utf-8"
- operationId: "serviceOrderGet"
+ operationId: "serviceOrder_Get"
summary: "Retrieve a service order"
description: "This operation retrieves a service order entity. \nAttribute selection\
\ is enabled for all first level attributes."
@@ -195,7 +204,7 @@ paths:
- "application/json;charset=utf-8"
produces:
- "application/json;charset=utf-8"
- operationId: "notificationCreate"
+ operationId: "notification_Create"
summary: "NBI will send notification to this operation provided by subscribers"
description: "Notification structure depends of the eventType:\n\n- ServiceOrderCreationNotification\n\
- ServiceOrderStateChangeNotification\n\n```\n{\n \"eventId\": \"string\"\
diff --git a/docs/offeredapis/api_status/swagger.json b/docs/offeredapis/api_status/swagger.json
index aaeeeb5..344b684 100644
--- a/docs/offeredapis/api_status/swagger.json
+++ b/docs/offeredapis/api_status/swagger.json
@@ -4,15 +4,26 @@
"info": {
"description": "Provides a healthcheck to verify that the NBI component is running fine as a standalone application or can also communicate with other onap modules.\n\n",
"version": "4.0.1",
- "title": "API Status",
+ "title": "Status API",
+ "contact": {
+ "name": "ONAP",
+ "url": "https://onap.readthedocs.io",
+ "email": "onap-discuss@lists.onap.org"
+ },
+ "license": {
+ "name": "Apache 2.0",
+ "url": "http://www.apache.org/licenses/LICENSE-2.0"
+ },
+ "x-planned-retirement-date": "205001",
+ "x-component": "NBI",
"x-logo": {
"url": "/redoc/logo.png",
"backgroundColor": "#FFFFFF"
}
},
- "host": "localhost:8080",
- "basePath": "/nbi/api/v4",
+ "host": "serverRoot:30274",
+ "basePath":"/nbi/api/v4",
"schemes": [
"http"
],
@@ -35,7 +46,7 @@
"produces": [
"application/json;charset=utf-8"
],
- "operationId": "statusFind",
+ "operationId": "status_Find",
"summary": "retrieve application status",
"description": "* Default\n\n```\n{\n \"name\": \"nbi\",\n \"status\": \"ok\",\n \"version\": \"v3\"\n}\n```\n\n* Optional\n\n```\n?fullStatus=true\n```\n\n```\n{\n \"name\": \"nbi\",\n \"status\": \"ok\",\n \"version\": \"v3\",\n \"components\": [\n {\n \"name\": \"sdc connectivity\",\n \"status\": \"ko\"\n },\n {\n \"name\": \"so connectivity\",\n \"status\": \"ok\"\n },\n {\n \"name\": \"aai connectivity\",\n \"status\": \"ok\"\n },\n {\n \"name\": \"dmaap connectivity\",\n \"status\": \"ok\"\n }\n ]\n}\n```",
"deprecated": false,
diff --git a/docs/offeredapis/api_status/swagger.yaml b/docs/offeredapis/api_status/swagger.yaml
index 7f74c26..6d21240 100644
--- a/docs/offeredapis/api_status/swagger.yaml
+++ b/docs/offeredapis/api_status/swagger.yaml
@@ -17,11 +17,20 @@ info:
\ fine as a standalone application or can also communicate with other onap modules.\n\
\n"
version: "4.0.1"
- title: "API Status"
+ title: "Status API"
+ contact:
+ name: "ONAP"
+ url: "https://onap.readthedocs.io"
+ email: "onap-discuss@lists.onap.org"
+ license:
+ name: "Apache 2.0"
+ url: "http://www.apache.org/licenses/LICENSE-2.0"
+ x-planned-retirement-date: "205001"
+ x-component: "NBI"
x-logo:
url: "/redoc/logo.png"
backgroundColor: "#FFFFFF"
-host: "localhost:8080"
+host: "serverRoot:30274"
basePath: "/nbi/api/v4"
schemes:
- "http"
@@ -37,7 +46,7 @@ paths:
- "Status"
produces:
- "application/json;charset=utf-8"
- operationId: "statusFind"
+ operationId: "status_Find"
summary: "retrieve application status"
description: "* Default\n\n```\n{\n \"name\": \"nbi\",\n \"status\": \"\
ok\",\n \"version\": \"v3\"\n}\n```\n\n* Optional\n\n```\n?fullStatus=true\n\