Commit 79a73261 authored by huangzhen's avatar huangzhen
Browse files

Update 10 files 

- /TS29520_Nnwdaf_EventsSubscription.yaml
- /TS29520_Nnwdaf_AnalyticsInfo.yaml
- /TS29520_Nnwdaf_DataManagement.yaml
- /TS29520_Nnwdaf_MLModelProvision.yaml
- /TS29520_Nnwdaf_MLModelTraining.yaml
- /TS29520_Nnwdaf_RoamingData.yaml
- /TS29520_Nnwdaf_MLModelMonitor.yaml
- /TS29520_Nnwdaf_RoamingAnalytics.yaml
- /TS29520_Nnwdaf_VFLTraining.yaml
- /TS29520_Nnwdaf_VFLInference.yaml
parent 7f845ff9

TS29520_Nnwdaf_AnalyticsInfo.yaml

+8 −3
Original line number Diff line number Diff line 
openapi: 3.0.0



info:

  version: 1.4.1

  version: 1.5.0-alpha.1

  title: Nnwdaf_AnalyticsInfo

  description: |

    Nnwdaf_AnalyticsInfo Service API.
@@ -9,7 +9,7 @@ info: 
    All rights reserved.



externalDocs:

  description: 3GPP TS 29.520 V19.6.0; 5G System; Network Data Analytics Services.

  description: 3GPP TS 29.520 V20.0.0; 5G System; Network Data Analytics Services.

  url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/'



security:
@@ -343,7 +343,7 @@ components: 
          items:

            $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/QosPolicyAssistInfo'

          minItems: 1

        trafficPatterns:

        trafficPatternInfos:

          type: array

          items:

            $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/TrafficPattern'
@@ -593,6 +593,11 @@ components: 
          description: >

            Represents the abnormal user plane traffic analytics requirements.

            Shall only be present when the requested event is "ABNORMAL_UP_TRAFFIC".

        trafficPatternReqs:

          type: array

          items:

            $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/TrafficPatternReq'

          minItems: 1

      not:

        required: [anySlice, snssais]

TS29520_Nnwdaf_DataManagement.yaml

+2 −2
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0 


info:

  title: Nnwdaf_DataManagement

  version: 1.2.1

  version: 1.3.0-alpha.1

  description: |

    Nnwdaf_DataManagement API Service.  

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

    All rights reserved.



externalDocs:

  description: 3GPP TS 29.520 V19.6.0; 5G System; Network Data Analytics Services.

  description: 3GPP TS 29.520 V20.0.0; 5G System; Network Data Analytics Services.

  url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/'



servers:

TS29520_Nnwdaf_EventsSubscription.yaml

+150 −21
Original line number Diff line number Diff line 
openapi: 3.0.0



info:

  version: 1.4.1

  version: 1.5.0-alpha.1

  title: Nnwdaf_EventsSubscription

  description: |

    Nnwdaf_EventsSubscription Service API.
@@ -9,7 +9,7 @@ info: 
    All rights reserved.



externalDocs:

  description: 3GPP TS 29.520 V19.6.0; 5G System; Network Data Analytics Services.

  description: 3GPP TS 29.520 V20.0.0; 5G System; Network Data Analytics Services.

  url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/'



security:
@@ -749,6 +749,12 @@ components: 
            $ref: '#/components/schemas/AbnormalUpTrafficReq'

          minItems: 1

          description: Represents the Abnormal User Plane Traffic analytics requirements.

        trafficPatternReqs:

          type: array

          items:

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

          minItems: 1

          description: Represents the traffic pattern analytics requirements.

      required:

        - event

      not:
@@ -950,7 +956,7 @@ components: 
            $ref: '#/components/schemas/AbnormalUpTrafficInfo'

          minItems: 1

          description: The abnormal user plane traffic information.

        trafficPatterns:

        trafficPatternInfos:

          type: array

          items:

            $ref: '#/components/schemas/TrafficPattern'
@@ -1168,6 +1174,8 @@ components: 
          items:

            $ref: 'TS29571_CommonData.yaml#/components/schemas/GroupId'

          minItems: 1

        ueIpAddrs:

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



    UeMobility:

      description: Represents UE mobility information.
@@ -1485,6 +1493,26 @@ components: 
          $ref: 'TS29571_CommonData.yaml#/components/schemas/Float'

        speed:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Float'

        maxDataBurstVol:

          $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MaxDataBurstVol'

        mbrUl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate'

        mbrDl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate'

        gbrUl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate'

        gbrDl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate'

        delayUl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketDelBudget'

        delayDl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketDelBudget'

        perUl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketErrRate'

        perDl:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketErrRate'

        periodicity:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'



    NfLoadLevelInformation:

      description: Represents load level information of a given NF instance.
@@ -2169,6 +2197,8 @@ components: 
          $ref: 'TS29554_Npcf_BDTPolicyControl.yaml#/components/schemas/NetworkAreaInfo'

        dnn:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn'

        snssai:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai'

        redTransExps:

          type: array

          items:
@@ -2910,6 +2940,10 @@ components: 
          $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/PositioningMethod'

        locAcc:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

        locAccMin:

          $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LocationQoS'

        locAccMax:

          $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LocationQoS'

        losNlosPct:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

        losNlosInd:
@@ -3561,6 +3595,16 @@ components: 
        extMaxDataBurstVol:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/ExtMaxDataBurstVol'



    TrafficPatternReq:

      description: The traffic pattern requirements.

      type: object

      properties:

        reportThresholds:

          type: array

          items:

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

          minItems: 1



    TrafficPattern:

      description: The traffic pattern information.

      type: object
@@ -3582,15 +3626,8 @@ components: 
          items:

            $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi'

          minItems: 1

        gpsis:

          type: array

          items:

            $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi'

          minItems: 1

        ueIpAddrs:

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

        avgWin:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/AverWindow'

        maxDataBurstVol:

          $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MaxDataBurstVol'

        mbrUl:
@@ -3618,41 +3655,83 @@ components: 
      description: The Abnormal User Plane Traffic requirement information.

      type: object

      properties:

        abnorTraPatId:

        abnorTraPatIds:

          type: array

          items:

            $ref: 'TS29571_CommonData.yaml#/components/schemas/AbnormalTrafficPatternId'

          minItems: 1

        upfIds:

          type: array

          items:

            type: string

          minItems: 1

        networkIns:

          type: array

          items:

            type: string

          minItems: 1

        reducedInd:

          type: boolean

          description: Reduced output request indication.

      required:

        - abnorTraPatId

        - abnorTraPatIds



    AbnormalUpTrafficInfo:

      description: The Abnormal User Plane Traffic information.

      type: object

      properties:

        abnorTraPatId:

          type: string

        abnorTrafficType:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/AbnormalTrafficPatternId'

        fDescs:

          type: array

          items:

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

          minItems: 1

        anomalyType:

          type: string

        trafficPara:

          type: string

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

        severity:

          type: string

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

        upfId:

          type: string

        ueIpAddrs:

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

        appInfo:

          type: string

          type: array

          items:

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

          minItems: 1

        validityPeriod:

          $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow'

        confidence:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

      required:

        - abnorTraPatId

        - abnorTrafficType



    ApplicationInformation:

      description: The application information of the Abnormal User Plane Traffic.

      type: object

      properties:

        appIds:

          type: array

          items:

            $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId'

          minItems: 1

        protocols:

          type: array

          items:

            $ref: 'TS29571_CommonData.yaml#/components/schemas/Protocol'

          minItems: 1



    AbnormalTraiffcParameters:

      description: The traffic parameters of the Abnormal User Plane Traffic.

      type: object

      properties:

        trafficInfo:

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

        incidentRate:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

        burstSize:

          $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MaxDataBurstVol'



#

# ENUMERATIONS DATA TYPES
@@ -4127,6 +4206,16 @@ components: 
          - MOV_UE_DIRECTION

          - IN_OUT_PERCENT

          - TIME_TO_COLLISION

          - MAX_BURST_SIZE

          - MBR_UL

          - MBR_DL

          - GBR_UL

          - GBR_DL

          - DELAY_UL

          - DELAY_DL

          - PER_UL

          - PER_DL

          - PERIODICITY

      - type: string

        description: >

          This string provides forward-compatibility with future
@@ -4275,6 +4364,26 @@ components: 
          The value is only applicable to the LOC_ACCURACY event.

        - TIME_TO_COLLISION: Indicates the time until for a collision with another UE happens.

          This value is only applicable to RELATIVE_PROXIMITY event prediction.

        - MAX_BURST_SIZE: Indicates uplink Max Burst Size. This value is only applicable to

          TRAFFIC_PATTERN event.

        - MBR_UL: Indicates uplink Maximum Bitrate. This value is only applicable to

          TRAFFIC_PATTERN event.

        - MBR_DL: Indicates downlink Maximum Bitrate. This value is only applicable to

          TRAFFIC_PATTERN event.

        - GBR_UL: Indicates uplink Guaranteed Bitrate. This value is only applicable to

          TRAFFIC_PATTERN event.

        - GBR_DL: Indicates downlink Guaranteed Bitrate. This value is only applicable to

          TRAFFIC_PATTERN event.

        - DELAY_UL: Indicates uplink 5GS delay. This value is only applicable to TRAFFIC_PATTERN

          event.

        - DELAY_DL: Indicates downlink 5GS delay. This value is only applicable to TRAFFIC_PATTERN

          event.

        - PER_UL: Indicates uplink Packet Error Rate. This value is only applicable to

          TRAFFIC_PATTERN event.

        - PER_DL: Indicates downlink Packet Error Rate. This value is only applicable to

          TRAFFIC_PATTERN event.

        - PERIODICITY: Indicates periodicity statistic of the traffic. This value is only applicable

          to TRAFFIC_PATTERN event.



    DispersionType:

      anyOf:
@@ -4702,6 +4811,25 @@ components: 
          - SIGNALLING_STORM_CAUSED_BY_UE: The signalling storm is caused by UEs.

          - SIGNALLING_STORM_CAUSED_BY_NF: The signalling storm is caused by NF.



    Severity:

      anyOf:

      - type: string

        enum:

          - LOW

          - MEDIUM

          - HIGH

          - CATASTROPHIC

      - type: string

        description: >

          This string provides forward-compatibility with future extensions to the enumeration but

          is not used to encode content defined in the present version of this API.

      description: |

        Represents the preferred level of accuracy of the analytics.  

        Possible values are:

        - LOW: Indicates the severity is low.

        - MEDIUM: Indicates the severity is medium.

        - HIGH: Indicates the severity is high.

        - CATASTROPHIC: Indicates the severity is catastrophic.

    QosPolOrderCriterion:

      anyOf:

      - type: string
@@ -4718,3 +4846,4 @@ components: 
          - QOE: Indicates the order is the QoE.

          - USAGE_DURATION: Indicates the order is the QoS Flow Usage Duration.

          - NUMBER_OF_USAGES: Indicates the order is the number of usages of the QoS Flow.

TS29520_Nnwdaf_MLModelMonitor.yaml

+4 −3
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0 


info:

  title: Nnwdaf_MLModelMonitor

  version: 1.1.0

  version: 1.2.0-alpha.1

  description: |

    Nnwdaf_MLModelMonitor API Service.  

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

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

    All rights reserved.



externalDocs:

  description: 3GPP TS 29.520 V19.5.0; 5G System; Network Data Analytics Services.

  description: 3GPP TS 29.520 V20.0.0; 5G System; Network Data Analytics Services.

  url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/



servers:
@@ -484,3 +484,4 @@ components: 
      required:

        - events

        - modelIds

TS29520_Nnwdaf_MLModelProvision.yaml

+28 −11
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0 


info:

  title: Nnwdaf_MLModelProvision

  version: 1.2.0

  version: 1.3.0-alpha.1

  description: |

    Nnwdaf_MLModelProvision API Service.  

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

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

    All rights reserved.



externalDocs:

  description: 3GPP TS 29.520 V19.5.0; 5G System; Network Data Analytics Services.

  description: 3GPP TS 29.520 V20.0.0; 5G System; Network Data Analytics Services.

  url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/



servers:
@@ -91,7 +91,7 @@ paths: 
                      minItems: 1

              responses:

                '204':

                  description: No Content, Notification was succesfull

                  description: No Content, Notification was successful

                '307':

                  $ref: 'TS29571_CommonData.yaml#/components/responses/307'

                '308':
@@ -272,7 +272,7 @@ components: 
    ModelProvisionParamsExt:

      description: >

        Extended parameters for ML model provisioning which can optionally be set by a service

        consuumer NF.

        consumer NF.

      type: object

      properties:

        modelInterInfo:
@@ -343,7 +343,7 @@ components: 
        posModelReqInd:

          type: boolean

          description: >

            Indicates that the NF service consumer requests a ML models for positioning if provided

            Indicates that the NF service consumer requests ML models for positioning if provided

            and set to "true". The default value is "false" if omitted.

        tgtUe:

          $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/TargetUeInformation'
@@ -443,6 +443,10 @@ components: 
            ML model is not updated. Default value is "false" if omitted.

        vflTrainStatus:

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

        vflNotifInfo:

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

        vflTermCause:

          $ref: 'TS29520_Nnwdaf_VFLInference.yaml#/components/schemas/VflTermCause'

      oneOf:

        - required: [mLFileAddr]

        - required: [mLModelAdrf]
@@ -487,7 +491,7 @@ components: 
        mlAccuracyThreshold:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

        mlLossThreshold:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Float'

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

        modelMetric:

          $ref: '#/components/schemas/MLModelMetric'
@@ -510,8 +514,8 @@ components: 
        mlDegradInd:

          type: boolean

          description: >

            Set to "true" to indicate support degration of an ML model. Set to "false" to indicate

            not support degration of an ML model. Default value is "false" if omitted.

            Set to "true" to indicate support degradation of an ML model. Set to "false" to indicate

            not support degradation of an ML model. Default value is "false" if omitted.

        trainInpInfos:

          type: array

          items:
@@ -524,7 +528,7 @@ components: 
        accMLModel:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

        lossMLModel:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Float'

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

        modelUpdateInd:

          type: boolean

          description: >
@@ -596,6 +600,19 @@ components: 
        vflCorrId:

          type: string



    MLLossThreshold:

      description: Represents the ML loss threshold value.

      type: object

      properties:

        lossFloatValue:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Float'

        lossPercentageValue:

          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

      oneOf:

        - required: [lossFloatValue]

        - required: [lossPercentageValue]





#

# ENUMERATIONS DATA TYPES

#