#==================================================================================
#   Copyright (c) 2019 AT&T Intellectual Property.
#   Copyright (c) 2019 Nokia
#
#   Licensed under the Apache License, Version 2.0 (the "License");
#   you may not use this file except in compliance with the License.
#   You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
#   Unless required by applicable law or agreed to in writing, software
#   distributed under the License is distributed on an "AS IS" BASIS,
#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#   See the License for the specific language governing permissions and
#   limitations under the License.
#==================================================================================
#
#
#   Abstract:   Routing Manager's RESTful API definition
#   Date:       28 August 2019
#
swagger: "2.0"
info:
  title: Routing Manager
  description: "This is the Swagger/OpenAPI 2.0 definition of Routing Manager's Northbound API."
  version: "0.4.0"
  license:
    name: "Apache 2.0"
    url: "http://www.apache.org/licenses/LICENSE-2.0.html"
host: "rtmgr"
basePath: "/ric/v1"
tags:
- name: "handle"
  description: "Available handles"
#  externalDocs:
#    description: "Find out more"
#    url: "http://127.0.0.1"
- name: "health"
  description: "Health of the system"
- name: "debug"
  description: "Debug Information"
schemes:
#- "https"
- "http"
paths:
  /health:
    get:
      tags:
      - "health"
      summary: "Retrive the health of Routing Manager"
      description: "By performing a GET method on the health resource, the API caller is able to retrieve the health of Routing Manager"
      operationId: "get_health"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      responses:
        200:
          description: "The health of the system"
          schema:
            "$ref": "#/definitions/health-status"
  /getdebuginfo:
    get:
      tags:
      - "debug"
      summary: "Get Information for debugging"
      description: "By performing a GET method, API caller is able to get the dump of routes tables, subcription list and E2T's"
      operationId: "get_debuginfo"
      consumes:
      - "application/json"
      produces:
      - "application/json"
      responses:
        200:
          description: "Debug Info from routing manager"
          schema:
            "$ref": "#/definitions/debuginfo"
        201:
          description: "Error while fetching Debug data"    
  /handles:
    get:
      tags:
      - "handle"
      summary: "Placeholder for further usage"
      description: "Placeholder for further usage."
      operationId: "get_handles"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      responses:
        200:
          description: "Dummy response"
  /handles/xapp-handle:
    post:
      tags:
      - "handle"
      summary: "Provide callback"
      description: "By performing a POST method on the xapp-handle resource, the API caller is able to perform a callback on Routing Manager."
      operationId: "provide_xapp_handle"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
      - in: "body"
        name: "xapp-callback-data"
        description: "xApp related callback data"
        required: true
        schema:
          $ref: "#/definitions/xapp-callback-data"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "Callback received"
  /handles/xapp-subscription-handle:
    post:
      tags:
      - "handle"
      summary: "API for updating about new xapp subscription"
      description: "By performing a POST method on the xapp-subscription-handle resource, the API caller is able to update the Routing manager about the creation of new subscription by an Xapp instance."
      operationId: "provide_xapp_subscription_handle"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
      - in: "body"
        name: "xapp-subscription-data"
        description: "xApp related subscription data"
        required: true
        schema:
          $ref: "#/definitions/xapp-subscription-data"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "Xapp Subscription data received"
    delete:
      tags:
      - "handle"
      summary: "API for deleting an xapp subscription"
      description: "By performing the delete operation on xapp-subscription-handle resource, the API caller will be able to update routing manager about the deletion of an xapp's subscription"
      operationId: "delete_xapp_subscription_handle"
      consumes:
      - "application/json"
      parameters:
      - in: "body"
        name: "xapp-subscription-data"
        description: "xApp related subscription data"
        required: true
        schema:
          $ref: "#/definitions/xapp-subscription-data"
      responses:
        204:
          description: "Content not found"
        200:
          description: "Xapp Subscription deleted"
  /handles/xapp-subscription-handle/{subscription_id}:
    put:
      tags:
      - "handle"
      summary: "API for updating the subscriber xApp list"
      description: "By performing a PUT method on a xapp-subscription-handle/{subscription_id} resource, the API caller is able to update the Routing manager about the list of subscriber xApps related to the subscription denoted by the {subsription_id}."
      operationId: "update_xapp_subscription_handle"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
        - in: path
          name: subscription_id
          required: true
          type: integer
          format: "uint16"
          description: "Subscription ID"
        - in: body
          name: xapp-list
          description: "xApp list"
          required: true
          schema:
           $ref: "#/definitions/xapp-list"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "Xapp list received"
  /handles/e2t:
    post:
      tags:
      - "handle"
      summary: "API for establishing platform routes when a new e2t instance gets added to platform"
      description: "E2T updates its FQDN to E2M  during its initialisation, hence after E2M informs routing manager about new E2T instances FQDN. At this point Routing Mgr would establish platform routes"
      operationId: "create_new_e2t_handle"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
        - in: body
          name: e2t-data
          description: "FQDN of the newly joined E2T instance"
          required: true
          schema:
           $ref: "#/definitions/e2t-data"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "new e2t instance is considered and platform routes are established"
    delete:
      tags:
      - "handle"
      summary: "API for clearing routes specific to a particular e2T instance"
      description: "E2M would monitor E2T instances using its keep alive based mechanism during this time if an E2T instance is detected to be dead, E2M would distribute already associated ran's to other available/healthy E2T instances. Here E2M would share E2T instance address to be removed OR which is unhealthy and list of RAN instances to be dissociated and an association list which contains E2T FQDN and associated RAN names"
      operationId: "delete_e2t_handle"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
        - in: body
          name: e2t-data
          description: "FQDN of the newly joined E2T instance"
          required: true
          schema:
           $ref: "#/definitions/e2t-delete-data"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "new e2t instance is considered and platform routes are established"
  /handles/associate-ran-to-e2t:
    post:
      tags:
      - "handle"
      summary: "API for associating a ran to e2t instance"
      description: "By performing a POST method on rane2tmapping, the API caller is able to update the Routing manager about the ran to e2t mapping which would be finally used to distribute routes to corresponding xApp and E2T instance"
      operationId: "associate_ran_to_e2t_handle"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
        - in: body
          name: ran-e2t-list
          description: "ran to e2t mapping"
          required: true
          schema:
           $ref: "#/definitions/ran-e2t-map"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "e2t ran mapping recieved, platform routes"
  /handles/dissociate-ran:
    post:
      tags:
      - "handle"
      summary: "API to dissociate ran from e2t"
      description: "By performing a POST method on rane2tmapping, routing manager will dissociate ran name from e2t instance by updating or clearing routes"
      operationId: "dissociate_ran"
      consumes:
      - "application/json"
#      - "application/yaml"
      produces:
      - "application/json"
#      - "application/yaml"
      parameters:
        - in: body
          name: dissociate-list
          description: "list of RAN to dissociate"
          required: true
          schema:
           $ref: "#/definitions/ran-e2t-map"
      responses:
        400:
          description: "Invalid data"
        201:
          description: "ran instances disociated"
definitions:
  health-status:
    type: "object"
    properties:
      status:
        type: string
        enum:
        - healthy
        - unhealthy
  xapp-callback-data:
    type: "object"
    properties:
      id:
        type: "string"
      event:
        type: "string"
      version:
        type: "integer"
        format: "int64"
      xApps:
        type: "string" #This should be a JSON object, array of xapps
  xapp-subscription-data:
    type: "object"
    required:
      - "address"
      - "port"
      - "subscription_id"
    properties:
      address:
        type: "string" #This is the xapp instance hostname or ip address
      port: #xapp instance port address
        type: "integer"
        format: "uint16"
        minimum: 0
        maximum: 65535
      subscription_id: #subscription sequence number
        type: "integer"
        format: "int32"
  xapp-list:
    type: "array"
    items:
      $ref: '#/definitions/xapp-element'
  xapp-element:
    type: "object"
    required:
      - "address"
      - "port"
    properties:
      address:
        type: "string" #This is the xapp instance hostname or ip address
      port: #xapp instance port address
        type: "integer"
        format: "uint16"
        minimum: 0
        maximum: 65535
  ran-e2t-map:
    type: "array"
    items:
      $ref: '#/definitions/ran-e2t-element'
  ran-e2t-element:
    type: "object"
    required:
      - "E2TAddress"
    properties:
      E2TAddress:
        type: "string" #This is the ideally E2T FQDN or IP:PORT
      ranNamelist: #list of RAN Names
        $ref: '#/definitions/ranNamelist'
  ranNamelist:
    type: "array"
    items:
      type: "string" #This could be FQDN or this needs to be an object?
  e2t-data:
    type: "object"
    required:
      - "E2TAddress"
    properties:
      E2TAddress:
        type: "string" #This is FQDN or IP of E2T instance
      ranNamelist:
        $ref: '#/definitions/ranNamelist'
  e2t-delete-data:
    type: "object"
    required:
      - "E2TAddress"
    properties:
      E2TAddress:
        type: "string" #This E2T instances FQDN or 
      ranNamelistTobeDissociated: #xapp instance port address
        $ref: '#/definitions/ranNamelist'
      ranAssocList:
        $ref: "#/definitions/ran-e2t-map"
  endpoint:
    type: "object"
    properties:
      EndPointName:
        type: "string"
      EndPointFqdn:
        type: "string"
      EndPointPort:
        type: "integer"
        format: "uint16"
        minimum: 0
        maximum: 65535
    
  debuginfo:
    type: "object"
    required:
      - "RouteTable"
    properties:
      RouteTable:
        type: "array"
        items:
          type: "string"
      RouteConfigs:
        type: "string"

externalDocs:
  description: "Routing Manager"
  url: "http://placeholder"