Add new file

openapi: 3.0.1

info:

  title: CCL NRM

  version: 19.3.0

  description: >-

    OAS 3.0.1 definition of the CCL NRM

    © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).

    All rights reserved.

externalDocs:

  description: 3GPP TS 28.567; management aspect of closed control loops

  url: http://www.3gpp.org/ftp/Specs/archive/28_series/28.567/

paths: {}

components:

  schemas:

  #-------- Definition of types for name-containments ------

    SubNetwork-ncO-CCLNrm:

      type: object

      properties:

        ClosedControlLoop:

          $ref: '#/components/schemas/ClosedControlLoop-Multiple'

   #-------Definition of generic IOCs ----------#  

    ClosedControlLoop-Single:

      description: >-

        This IOC represents the properties of an CCL management information between MnS consumer and MnS producer.  

      allOf:

      - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top'    

      - type: object

        properties:

          cCLComponentsInfo:

            type: array

            items:

              $ref: '#/components/schemas/CCLComponentsInfo'

            description: >-

              It indicates information on the constituent components of a CCL. 

          administrativeState:

            $ref: 'TS28623_ComDefs.yaml#/components/schemas/AdministrativeState'

          operationalState:

            $ref: 'TS28623_ComDefs.yaml#/components/schemas/AdministrativeState'

          cCLPriority:

            type: integer

            minimum: 1

            maximum: 10

            description: This provides the priority of the CCL. This will be the numerical value between 1 to 10, with 1 being the least priority.   

          cCLComponentList:

            type: array

            items:

              $ref: '#/components/schemas/CCLComponent'

            description: >-

              It indicates the list of components ating as steps of the CCL. 

          cCLType:

            type: string

              enum:

                - ENERGYOPTIMIZATION

                - SLICEASSURANCE

          cCLActionTrigger:

            type: array

            items:

              $ref: '#/components/schemas/CCLTrigger'

            description: >-

              This defines the criteria/conditions under which the CCL is allowed to take actions..           

           desiredBehavior:

            type: string

              enum:

                - DECISION_ACTIVATION

                - NOTIFY_RCOMMENDATION

                - DO_NOTHING 

          cCLPurposeRefList:

            $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'

    CCLScope-Single:

      description: It indicates a scope of a CCL. 

      allOf:

      - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top'    

      - type: object

        properties:

          cCLPurposeRefList:

            $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'      

    CCLReport-Single:

      description: This class represents the reported outcomes on a CCL instance. 

      allOf:

      - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top'    

      - type: object

        properties:

          scopeType:

           type: string

           enum:

             - CCL_MEASUREMENT_SCOPE

             - CCL_TARGET_SCOPE

             - CCL_CONTROL_SCOPE

             - CCL_IMPACT_SCOPE

    ConflictManagementAndCoordinationEntity-Single:

      description: This defines the conflict management functionality. 

      allOf:

      - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top'    

      - type: object

        properties:

          coordinationCapability:

            type: array

            items:

              $ref: '#/components/schemas/CoordinationCapability'

            description: >-

              It indicates a capability of a coordination entity to coordinate CCL conflicts.

          coordinatedCCLsScopes

            type: string

          cCLActionConflictsHandling:

            $ref: '#/components/schemas/CCLActionConflictsHandling'

     FaultManagement:

      description: This IOC represents the Fault Management CCL purpose. 

      allOf:

      - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top'    

      - type: object

        properties:

          FaultManagementAlarmIdList:

            type: string

          FaultManagementBackUpObjectRequirement

            type: boolean

          FaultManagementIsolateObjectRequirement

            type: boolean

          FaultManagementTimeWindow:

            $ref: '#/components/schemas/TimeWindow'

          clearUserId:

            type: string           

   #-------Definition of the generic dataType --------------#    

   #-------Definition of the generic dataType --------------#    

   #------Definition of JSON arrays for name-contained IOCs ---------------#

    resources-CCLNrm:

      oneOf:

       - $ref: '#/components/schemas/ClosedControlLoop-Single'       

       - $ref: '#/components/schemas/CCLScope-Single'

       - $ref: '#/components/schemas/CCLReport-Single'

 No newline at end of file