[RIC-434] Update Release version and Swagger

[ric-plt/e2mgr.git] / Swagger / E2Manager_API.yaml

diff --git a/Swagger/E2Manager_API.yaml b/Swagger/E2Manager_API.yaml
index 1ab3766..bb8b7fc 100644 (file)
--- a/Swagger/E2Manager_API.yaml
+++ b/Swagger/E2Manager_API.yaml
@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
   title: E2 Manager Service
   description: E2 Manager Service APIs
-  version: 5.2.2
+  version: 5.2.20
 servers:
   - url: 'http://{apiRoot}/v1'
     variables:
@@ -28,7 +28,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/GetNodebResponse'
+                $ref: '#/components/schemas/NodebResponse'
         '400':
           description: The specified RAN name is invalid
           content:
@@ -47,9 +47,116 @@ paths:
             application/problem+json:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
-  '/nodeb/{ranName}/update':
+  /nodeb/enb:
+    post:
+      summary: Add eNB
+      tags:
+        - nodeb
+      operationId: AddEnb
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AddEnbRequest'
+        required: true
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NodebResponse'
+        '400':
+          description: Invalid input
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: Internal error
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+
+  '/nodeb/enb/{ranName}':
+    delete:
+      tags:
+        - nodeb
+      summary: Delete eNB
+      operationId: DeleteEnb
+      parameters:
+        - name: ranName
+          in: path
+          required: true
+          description: Name of RAN to delete
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NodebResponse'
+        '400':
+          description: The specified RAN is not ENB
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: A RAN with the specified name was not found
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: Internal Error
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
     put:
-      summary: Update GNB
+      tags:
+        - nodeb
+      summary: Update eNB
+      operationId: UpdateEnb
+      parameters:
+        - name: ranName
+          in: path
+          required: true
+          description: Name of ENB ran to update
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateEnbRequest'
+        required: true
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NodebResponse'
+        '400':
+          description: Invalid input
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: Internal error
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+  '/nodeb/gnb/{ranName}':
+    put:
+      summary: Update gNB Cells
       tags:
         - nodeb
       operationId: UpdateGnb
@@ -72,7 +179,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UpdateGnbResponse'
+                $ref: '#/components/schemas/NodebResponse'
         '400':
           description: Invalid input
           content:
@@ -105,7 +212,7 @@ paths:
             application/problem+json:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
-  /nodeb/ids:
+  /nodeb/states:
     get:
       tags:
         - nodeb
@@ -195,40 +302,14 @@ components:
         servedNrCells:
           $ref: '#/components/schemas/ServedNrCells'
       additionalProperties: false
-    UpdateGnbResponse:
+    UpdateEnbRequest:
+      type: object
+      required:
+        - enb
       properties:
-        connectionStatus:
-          oneOf:
-            - type: string
-            - type: integer
-        failureType:
-          oneOf:
-            - type: string
-            - type: integer
-        globalNbId:
-          properties:
-            nbId:
-              type: string
-            plmnId:
-              type: string
-          additionalProperties: false
-          type: object
-        gnb:
-          $ref: '#/components/schemas/Gnb'
-        ip:
-          type: string
-        nodeType:
-          oneOf:
-            - type: string
-            - type: integer
-        port:
-          type: integer
-        ranName:
-          type: string
-        setupFailure:
-          $ref: '#/components/schemas/SetupFailure'
+        enb:
+          $ref: '#/components/schemas/Enb'
       additionalProperties: false
-      type: object
     SetConfiguration:
       type: object
       required:
@@ -249,41 +330,6 @@ components:
         inventoryName:
           type: string
       type: object
-    GetNodebResponse:
-      properties:
-        connectionStatus:
-          oneOf:
-            - type: string
-            - type: integer
-        enb:
-          $ref: '#/components/schemas/Enb'
-        failureType:
-          oneOf:
-            - type: string
-            - type: integer
-        globalNbId:
-          properties:
-            nbId:
-              type: string
-            plmnId:
-              type: string
-          type: object
-        gnb:
-          $ref: '#/components/schemas/Gnb'
-        ip:
-          type: string
-        nodeType:
-          oneOf:
-            - type: string
-            - type: integer
-        port:
-          type: integer
-        ranName:
-          type: string
-        setupFailure:
-          $ref: '#/components/schemas/SetupFailure'
-      additionalProperties: false
-      type: object
     ErrorResponse:
       type: object
       required:
@@ -504,6 +550,8 @@ components:
                 type: object
               tac:
                 type: string
+              additionalCellInformation:
+                $ref: '#/components/schemas/AdditionalCellInformation'
             type: object
           type: array
       type: object
@@ -856,6 +904,8 @@ components:
                 type: array
               stac5g:
                 type: string
+              additionalCellInformation:
+                $ref: '#/components/schemas/AdditionalCellInformation'
             additionalProperties: false
             type: object
         additionalProperties: false
@@ -915,3 +965,79 @@ components:
             - type: integer
       additionalProperties: false
       type: object
+    AddEnbRequest:
+      type: object
+      required:
+        - ranName
+        - globalNbId
+        - enb
+      properties:
+        ranName:
+          type: string
+        globalNbId:
+          properties:
+            nbId:
+              type: string
+            plmnId:
+              type: string
+        ip:
+          type: string
+        port:
+          type: integer
+        enb:
+          $ref: '#/components/schemas/Enb'
+      additionalProperties: false
+    AdditionalCellInformation:
+      properties:
+        cellLatitude:
+          type: number
+        cellLongitude:
+          type: number
+        antennaHeight:
+          type: number
+        antennaAzimuthDirection:
+          type: number
+        antennaTiltAngle:
+          type: number
+        antennaMaxTransmit:
+          type: number
+        antennaMaxGain:
+          type: number
+        sectorId:
+          type: integer
+      type: object
+    NodebResponse:
+      properties:
+        connectionStatus:
+          oneOf:
+            - type: string
+            - type: integer
+        enb:
+          $ref: '#/components/schemas/Enb'
+        failureType:
+          oneOf:
+            - type: string
+            - type: integer
+        globalNbId:
+          properties:
+            nbId:
+              type: string
+            plmnId:
+              type: string
+          type: object
+        gnb:
+          $ref: '#/components/schemas/Gnb'
+        ip:
+          type: string
+        nodeType:
+          oneOf:
+            - type: string
+            - type: integer
+        port:
+          type: integer
+        ranName:
+          type: string
+        setupFailure:
+          $ref: '#/components/schemas/SetupFailure'
+      additionalProperties: false
+      type: object