Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languageyml
titleopenapi.yaml
linenumberstrue
collapsetrue
openapi: 3.0.3
info:
  description: Adds subjob capabilities for DCM
  title: NCMP Data Subjob API
  version: 1.0.0
servers:
  - url: /dmi
tags:
  - description: DMI plugin rest apis
    name: dmi-datajob
paths:
  /v1/dataJob/{requestId}:
    post:
      description: Create a read request
      operationId: createReadRequest
      parameters:
        - $ref: '#/components/parameters/requestIdInPath'
      requestBody:
        description: Operation body
        content:
          application/3gpp-json-patch+json:
            schema:
              $ref: '#/components/schemas/SubjobRequest'
      tags:
      - dmi-datajob
      responses:
        "200":
          description: Response for subjob
          content: 
            application/json:
              schema:
                type: object
                properties:
                  dataProducerJobId:
                    type: string
                    description: The data job ID.
components:
  parameters:
   requestIdInPath:
     description: requestId
     in: path
     name: requestId
     required: true
     schema:
       example: requestId
       type: string
  schemas:
    SubjobRequest:
      type: array
      items:
        type: object
        required:
          - dataProducerId
          - data
        properties:
          dataAcceptType:
            type: string
          dataContentCype:
            type: string
          dataProducerId:
            type: string
          data:
            oneOf:
              - $ref: '#/components/schemas/ReadOperation'
              - $ref: '#/components/schemas/WriteOperation'
    ReadOperation:
      type: array
      items:
        type: object
        required:
          - path
          - op
        properties:
          path:
            type: string
          op:
            type: string
          operationId:
            type: string
          attributes:
            type: array
            items:
              type: string
          fields:
            type: array
            items:
              type: string
          filter:
            type: array
            items:
              type: string
          scopeType:
            type: string
          scopeLevel:
            type: integer
          moduleSetTag:
            type: string
          cmHandleProperties:
            $ref: '#/components/schemas/CmHandleProperties'
    WriteOperation:
      type: array
      items:
        type: object
        required:
          - path
          - op
        properties:
          path:
            type: string
          op:
            type: string
          operationId:
            type: string
          value:
            type: object
            oneOf:
              - $ref: '#/components/schemas/Resource'
              - $ref: '#/components/schemas/ActionParameters'
              - $ref: '#/components/schemas/Object'
    CmHandleProperties:
      type: object
    Resource:
      type: object
      properties:
        id:
          type: string
        attributes:
          type: object
          additionalProperties: 
            type: string
    ActionParameters:
      type: object
      additionalProperties:
        type: string
    Object:
      type: object
          

 




IssueNotesDecision
1


2


3


4


5


Datajob read request

...

Table 1: Registered Cm Handles and their Alternate IDs

CmHandleIdAlternateIdNote
ch-1/SubNetwork=Europe/SubNetwork=IrelandRepresents a group of radio nodes
ch-2/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=WestMeathRepresents a group of radio nodes
ch-3/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=WestMeath/ManagedElement=Athlone01Single radio node 
ch-4/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=WestMeath/ManagedElement=Athlone02Single radio node 
ch-5/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=LongFordRepresent a group of radio nodes
ch-6/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=LongFord/ManagedElement=Ballymahon01Single radio node 
ch-7/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=LongFord/ManagedElement=Ballymahon02Single radio node 

The algorithm knows (3GPP) Path element are separated by / . Pseudo code:

...

Table 2: Sample match results

Operation path (matching part in bold)matching cm handle(DMI) resource identifierlookup attemptsNote
/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=WestMeath/ManagedElement=Athlone01/Function=X/Cell=A123ch-3/Function=X/Cell=A1233
/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=WestMeathch-2/1This is an operation on a group of radio nodes 
/SubNetwork=Europe/SubNetwork=Ireland/SubNetwork=WestMeath/ManagedElement=Mullingar01/Function=X/Cell=A123ch-2/ManagedElement=Mullingar01/Function=X/Cell=A1234This is probably unintended but the system wil try to execute it anyhow but in the southbound system no matches wil be found

/SubNetwork=Europe/SubNetwork=Belgium

No Match
2

/SubNetwork=Europe/SubNetwork=Belgium/SubNetwork=Brabant/ManagedElement=Antwerpen01/Function=X/Cell-A123

No Match
7


Performance Considerations

...

Assumptions: (based on : https://www.etsi.org/deliver/etsi_ts/132300_132399/132300/11.02.00_60/ts_132300v110200p.pdf→ Section : 7.4 Maximum size of DN string)

QuestionAnswer

Real example of FDN to 5g cell

/SubNetwork=Europe/ManagedElement=NRgNode001/GNBDUFunction=1/NRCellDU=1

How many parent objects does a 'radiocell' typically have

Identifier for the overall Datajob

Proposed JIRAs

Priority

Component 

Description

JIRA

1NCMPCreate implementation proposal for NCMP to provide support for Data jobs qualifier during registration

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2096

2NCMPNCMP to provide support for data producer identifier during registration

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2105

3NCMPSupport of Datajobs qualifier during registration

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2084

4NCMPModify the get cmHandle api to return dataProducerIdentifier, moduleSetTag, and alternateId

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2113

5NCMPModify lcm events to include dataProducerIdentifier and moduleSetTag

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2114

6NCMPCreate implementation proposal for NCMP to provide Java interface that can support Data jobs request

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2097

7NCMPDefine a java based datastructure for DataJob

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2155

8NCMPHandle Datajob request in java interface

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2142

9NCMPHandle async datajob response in java interface

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2143

10
Define DMI REST interface for Datajobs

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2141

11DMIDefine a java based datastructure dmi request for dmi endpoint

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2163

12DMIResponse schema for DMI dataJob response

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2154

13NCMPForward dataJob response from DMI to client topic in header as destination 

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2098

14DMIStub should be modified to use generated code from OpenAPI

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2145

15
E2E demo for internal team and stakeholder 

Jira
serverONAP Jira
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-2144

...