update

openapi: 3.0.1

info:

  title: Scenario specific Intent Expectations - RadioServiceExpectation

  version: 20.0.0

  description: >-

    OAS 3.0.1 definition of scenario specific Intent Expectations - RadioServiceExpectation

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

    All rights reserved.

externalDocs:

  description: 3GPP TS 28.312; Intent driven management services for mobile networks

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

paths: {}

components:

  schemas:

      #-------Definition of the Scenario specific IntentExpectation dataType ----------#    

    RadioServiceExpectation:

      description: >-

        This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio service delivering   

      type: object

      properties:

        expectationId:

          type: string

        expectationVerb:

           $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb'

        expectationObject:

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

        expectationTargets:

          type: array

          uniqueItems: true

          items:

            type: object

            oneOf:

              - $ref: '#/components/schemas/DLLatencyTarget'

              - $ref: '#/components/schemas/ULLatencyTarget'

              - $ref: '#/components/schemas/DLThptPerUETarget'

              - $ref: '#/components/schemas/ULThptPerUETarget'

              - $ref: '#/components/schemas/NumberofUEsTarget'

              - $ref: '#/components/schemas/ServiceAvailabilityTarget'              

              - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget'

        expectationContexts:

          type: array

          uniqueItems: true

          items:

            type: object

            oneOf:

              - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/SchedulingTimeContext'

              - $ref: '#/components/schemas/AssuranceDurationContext'

              - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/DecompositionAssistingContext'              

              - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context'

      required:

        - expectationId

        - expectationObject

        - expectationTargets

   #-------Definition of the IntentExpectation dataType ----------#    

  #-------Definition of the scenario specific ExpectationObject dataType ----------# 

    RadioServiceExpectationObject:

      description: >-

        This data type is the "ExpectationObject" data type with specialisations for RadioServicekExpectation

      type: object

      properties:

        objectType:

          type: string

          enum:

            - RADIO_SERVICE

        objectInstance:

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

        objectContexts:

          type: array

          uniqueItems: true

          items:

            type: object

            oneOf:

              - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/CoverageAreaPolygonContext'

              - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/DlFrequencyContext'

              - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/UlFrequencyContext'

              - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/CellContext'

              - $ref: '#/components/schemas/GeoCoordinateContext'

              - $ref: '#/components/schemas/CivicAreaContext'

              - $ref: '#/components/schemas/ServiceTypeContext'

              - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/UEGroupContext'

              - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context'

  #-------Definition of the scenario specific ExpectationObject dataType ----------# 

  #-------Definition of the Scenario specific ExpectationTarget dataType----------#     

    NumberofUEsTarget:

      description: >-

        This data type is the "ExpectationTarget" data type with specialisations for NumberofUEsTarget.It describes 

        the number of UEs target for the Radio Service that the intent expectation is applied.

      type: object

      properties:

        targetName:

          type: string

          enum:

            - NumberofUEs

        targetCondition:

          type: string

          enum:

            - IS_LESS_THAN

        targetValueRange:

          type: integer

    ServiceAvailabilityTarget:

      description: >-

        describes the service availability target for the Radio Service that the intent expectation is applied. 

        The detailed definition for service availability sees communication service availability defined in clause 3.1 of TS 22.261

      type: object

      properties:

        targetName:

          type: string

          enum:

            - ServiceAvailability

        targetCondition:

          type: string

          enum:

            - IS_GREATER_THAN

        targetValueRange:

          type: number          

    DLThptPerUETarget:

      description: >-

        This data type is the "ExpectationTarget" data type with specialisations for DLThptPerUETarget. It describes the DL throughput target by the per UE for the 

        edge service supporting or radio servicde that the intent expectation is applied. For details see dlThptPerUE defined in clause 6.3.1 of TS 28.541 [5].     

      type: object

      properties:

        targetName:

          type: string

          enum:

            - DlThptPerUE

        targetCondition:

          type: string

          enum:

            - IS_GREATER_THAN

        targetValueRange:

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

    ULThptPerUETarget:

      description: >-

        This data type is the "ExpectationTarget" data type with specialisations for ULThptPerUETarget.It describes the UL throughput target by the per UE for the edge

        service supporting or radio service that the intent expectation is applied. For details see ulThptPerUE defined in clause 6.3.1 of TS 28.541 [5].       

      type: object

      properties:

        targetName:

          type: string

          enum:

            - UlThptPerUE

        targetCondition:

          type: string

          enum:

            - IS_GREATER_THAN

        targetValueRange:

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

    DLLatencyTarget:

      description: >-

        This data type is the "ExpectationTarget" data type with specialisations for DLLatencyTarget.It describes the DL latency target for the edge service supporting or radio service

        that the intent expectation is applied       

      type: object

      properties:

        targetName:

          type: string

          enum:

            - DlLatency

        targetCondition:

          type: string

          enum:

            - IS_LESS_THAN

        targetValueRange:

          type: integer

    ULLatencyTarget:

      description: >-

        This data type is the "ExpectationTarget" data type with specialisations for ULLatencyTarget. It describes the UL latency target for the edge service supporting or radioService

        that the intent expectation is applied. For details see attribute ulLatency defined in clause 6.3.1 of TS 28.541 [5]     

      type: object

      properties:

        targetName:

          type: string

          enum:

            - UlLatency

        targetCondition:

          type: string

          enum:

            - IS_LESS_THAN

        targetValueRange:

          type: integer

  #-------Definition of the Scenario specific ExpectationTarget dataType----------#     

  #-------Definition of the concrete ObjectContext dataType----------------#

    GeoCoordinateContext:

      description: >-

        This data type is the "ObjectContext" data type with specialisations for GeoCoordinateContext.

        It describes the location (i.e. geocoordinate) that radio service intent is applied.

      type: object

      properties:

        contextAttribute:

          type: string

          enum:

            - GeoCoordinate

        contextCondition:

          type: string

          enum:

             - IS_EQUAL_TO

        contextValueRange:

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

    ServiceTypeContext:

      description: >-

        This data type is the "ExpectationContext" data type with specialisations for ServiceTypeContext.It describes

        the service type for the Radio Service that the intent expectation is applied. For details see sST in clause 6.4.1 in TS 28.541 [5]       

      type: object

      properties:

        contextAttribute:

          type: string

          enum:

            - ServiceType

        contextCondition:

          type: string

          enum:

            - IS_EQUAL_TO

        contextValueRange:

          type: string

  #-------Definition of the concrete ObjectContext dataType----------------#

  #-------Definition of the concrete ExpectationContext dataType----------------#

    AssuranceDurationContext:

      description: >-

        It describes the time duration at which the radio service instance should be scheduled to be delivered and available.

      type: object

      properties:

        contextAttribute:

          type: string

          enum:

            - AssuranceDuration

        contextCondition:

          type: string

          enum:

            - S_EQUAL_TO

        contextValueRange:

          type: integer  

   #-------Definition of the concrete ExpectationContext dataType----------------#          

 No newline at end of file