Skip to content
MEC029_FAI.yaml 82.7 KiB
Newer Older
Elian Kraja's avatar
Elian Kraja committed
info:
  title: "ETSI GS MEC 029 Fixed Access Information API"
  version: 2.1.1
  description: "ETSI GS MEC 029 Fixed Access Information API described using OpenAPI."
  license:
    name: BSD-3-Clause
    url: 'https://forge.etsi.org/legal-matters'
  contact:
Elian Kraja's avatar
Elian Kraja committed
    name: ETSI Forge
    email: cti_support@etsi.org
Elian Kraja's avatar
Elian Kraja committed
    url: https://forge.etsi.org/rep/mec/gs029-fai-api 
externalDocs:
  description: "ETSI GS MEC 029 Fixed Access Information API, v2.1.1"
  url: 'https://www.etsi.org/deliver/etsi_gs/MEC/001_099/029/02.01.01_60/gs_mec029v020101p.pdf' 
openapi: 3.0.0
servers:
  - url: 'https://localhost/fai/v1'
tags:
  - name: Queries
  - name: Subscription  
Elian Kraja's avatar
Elian Kraja committed

paths:
 /queries/fa_info:
  get:
   tags:
Elian Kraja's avatar
Elian Kraja committed
   summary: 'Retrieve information on the available fixed access networks.'
   description: 'Retrieve information on the available fixed access networks.'
   operationId: fa_infoGET  
   parameters:
        - in: query
          name: customerPremisesInfo
          schema:
           type: array
           items:
            $ref: '#/components/schemas/CpInfo'
          required: false
          description: 'Comma separated list of customer premises information'
        - in: query
          name: lastMileTech
          schema:
            type: array
            items:
             type: integer
          required: false
          description: 'Comma separated list of last mile technologies.'
        - in: query
          name: interfaceType
          schema:
            type: array
            items:
             type: integer
          description: 'Comma separated list of interface types.'
        - in: query
          name: dsbw
          schema:
            type: array
            items:
             type: integer
          required: false
          description: 'Comma separated list of the bandwidth (in Mbps) from the network towards the customer site.'    
        - in: query
          name: usbw
          schema:
            type: array
            items:
             type: integer
          required: false
          description: 'Comma separated list of the bandwidth (in Mbps) from the customer site towards the network.' 
        - in: query
          name: latency
          schema:
            type: array
            items:
             type: integer
          required: false
          description: 'Comma separated list of the maximum baseline latency (in ms) between customer site and service edge node.'   
   responses:
        '200':
          description: 'A response body containing the FAI is returned. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FaInfo'        
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '429':
          $ref: '#/components/responses/429'          
          
 /queries/device_info:
  get:
   tags:
Elian Kraja's avatar
Elian Kraja committed
   summary: 'retrieve information on the devices that are connected to a fixed access network.'
   description: 'retrieve information on the devices that are connected to a fixed access network.'
   operationId: device_infoGET  
   parameters:
        - in: query
          name: gwId
          schema:
           type: array
           items:
            type: string
          required: false
          description: 'Comma separated list of gateway identifier'
        - in: query
          name: deviceId
          schema:
            type: array
            items:
             type: string
          required: false
          description: 'Comma separated list of device identifier.'
        - in: query
          name: deviceStatus
          schema:
            type: array
            items:
             type: integer
          description: 'Comma separated list of device status.'
    
 
   responses:
        '200':
          description: 'A response body containing the device information is returned'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeviceInfo'        
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '429':
          $ref: '#/components/responses/429'          
          
 /queries/cable_line_info:
  get:
   tags:
    - 'Cable line info'
   summary: 'It Queries information about the cable line of a fixed access network.'
   description: 'It Queries information about the cable line of a fixed access network.'
   operationId: cable_line_infoGET  
   parameters:
        - in: query
          name: customerPremisesInfo
          schema:
           type: array
           items:
            $ref: '#/components/schemas/CpInfo'
          required: false
          description: 'Comma separated list of customer premises information'
        - in: query
          name: cmId
          schema:
            type: array
            items:
             type: string
          required: false
          description: 'Comma separated list of Cable Modem identifiers.'
    
 
   responses:
        '200':
          description: 'A response body containing the cable line information is returned.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CableLineInfo'        
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '429':
          $ref: '#/components/responses/429'  
 /queries/optical_network_info: 
  get:
   tags:
    - 'Optical network info'
   summary: 'used to query information about the optical network.'
Loading
Loading full blame…