From efcc7f37bfe56abd83489fbfbd16be53199d85f1 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:41:27 +0000 Subject: [PATCH 01/13] Replace TS28104_MdaNrm.yaml --- OpenAPI/TS28104_MdaNrm.yaml | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/OpenAPI/TS28104_MdaNrm.yaml b/OpenAPI/TS28104_MdaNrm.yaml index 3a83c1ae..7f866691 100644 --- a/OpenAPI/TS28104_MdaNrm.yaml +++ b/OpenAPI/TS28104_MdaNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: MDA NRM - version: 19.3.0 + version: 20.0.0 description: >- OAS 3.0.1 specification of the MDA NRM © 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -19,6 +19,7 @@ components: enum: - COVERAGE_ANALYTICS_COVERAGE_PROBLEM_ANALYSIS - COVERAGE_ANALYTICS_PAGING_OPTIMIZATION + - COVERAGE_ANALYTICS_RET_TP_ANALYTICS - SLS_ANALYSIS_SERVICE_EXPERIENCE_ANALYSIS - SLS_ANALYSIS_NETWORK_SLICE_THROUGHPUT_ANALYSIS - SLS_ANALYSIS_NETWORK_SLICE_TRAFFIC_ANALYSIS @@ -145,6 +146,25 @@ components: format: float minimum: 0 + AnalysisRequirement: + oneOf: + - type: object + properties: + timeConstraint: + type: array + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + - type: object + properties: + resourceConstraint: + type: string + + MDADomain: + type: string + enum: + - CN + - RAN + - CROSS_DOMAIN #-------- Definition of types for name-containments ------ SubNetwork-ncO-MdaNrm: @@ -177,6 +197,8 @@ components: properties: supportedMDACapabilities: $ref: '#/components/schemas/MDATypes' + supportedMDADomain: + $ref: '#/components/schemas/MDADomain' mLModelRefList: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo' aIMLInferenceFunctionRefList: @@ -216,6 +238,10 @@ components: type: array items: $ref: 'TS28623_ThresholdMonitorNrm.yaml#/components/schemas/ThresholdInfo' + analysisRequirements: + type: object + items: + $ref: '#/components/schemas/AnalysisRequirement' thresholdMonitorRefList: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' MDAReport-Single: -- GitLab From 5ae3d28b7942d7a670336e87ed17bd44d4470c61 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:41:46 +0000 Subject: [PATCH 02/13] Replace TS28104_MdaReport.yaml --- OpenAPI/TS28104_MdaReport.yaml | 48 +++++++++++++++++++++++++++++----- 1 file changed, 41 insertions(+), 7 deletions(-) diff --git a/OpenAPI/TS28104_MdaReport.yaml b/OpenAPI/TS28104_MdaReport.yaml index 123a9954..7c78bb46 100644 --- a/OpenAPI/TS28104_MdaReport.yaml +++ b/OpenAPI/TS28104_MdaReport.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: MDA Report - version: 19.3.0 + version: 20.0.0 description: >- OAS 3.0.1 specification of the MDA Report © 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -53,7 +53,8 @@ components: - $ref: '#/components/schemas/PMDataOutput' - $ref: '#/components/schemas/FailurePredictionOutput' - $ref: '#/components/schemas/PagingOptimizationAnalysisOutput' - - $ref: '#/components/schemas/TrafficCongestionProblemAnalysisOutput' + - $ref: '#/components/schemas/TrafficCongestionProblemAnalysisOutput' + - $ref: '#/components/schemas/RETTPAnalyticsAnalysisOutput' - type: array uniqueItems: true items: @@ -152,16 +153,38 @@ components: properties: mobilityPerformanceIssueIdentifier: type: integer + mobilityPerformanceIssueType: + type: string + enum: + - NSA_ISSUE + - SA_ISSUE + mobilityPerformanceIssue: + type: string + enum: + - TOO-EARLY_HANDOVER + - TOO-LATE_HANDOVER + - PINGPONG_HANDOVER + - TOO-EARLY_PSCELL_CHANGE + - TOO-LATE_PSCELL_CHANGE + - TOO-EARLY_PSCELL_ CONDITIONAL_CHANGE + - TOO-LATE_PSCELL_CONDITIONAL_CHANGE mobilityPerformanceIssueRootCause: type: string enum: - - TooLongMobilityInterruptionTime - - PoorCoverageOfTheCelledge - - InappropriateHandoverParameters + - TOO_LONG_MOBILITY_INTERRUPTION_TIME + - POOR_COVERAGE_OF_THE_CELL_EDGE + - INAPPROPRIATE_HANDOVER_PARAMETERS + - HIGH_INTERFERENCE + - INSUFFICIENT TRANSPORT_RESOURCES + - CAPABILITY_ISSUE - Other mobilityPerformanceIssueLocation: $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' - + recommendedActions: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/RecommendedAction' #-------- Definition of specific CoverageProblemAnalysis MDAoutput ----------------------------- CoverageProblemAnalysisOutput: type: object @@ -422,5 +445,16 @@ components: - MODERATE_CONGESTION - SEVERE_CONGESTION - +#-------- Definition of specific RETTPAnalyticsAnalysisOutput MDAoutput ----------------------------- + RETTPAnalyticsAnalysisOutput: + type: object + properties: + isTiltChangeRequired: + type: boolean + RecommendedTilt: + $ref: '#/components/schemas/RecommendedAction' + isTPChangeRequired: + type: boolean + RecommendedTxPower: + $ref: '#/components/schemas/RecommendedAction' -- GitLab From 340515ffdbfb4f9cd23a3cfc86c08a3dee6f8e63 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:43:08 +0000 Subject: [PATCH 03/13] Upload New File --- OpenAPI/TS28312_5GCNetworkExpectation.yaml | 325 +++++++++++++++++++++ 1 file changed, 325 insertions(+) create mode 100644 OpenAPI/TS28312_5GCNetworkExpectation.yaml diff --git a/OpenAPI/TS28312_5GCNetworkExpectation.yaml b/OpenAPI/TS28312_5GCNetworkExpectation.yaml new file mode 100644 index 00000000..95ab5b82 --- /dev/null +++ b/OpenAPI/TS28312_5GCNetworkExpectation.yaml @@ -0,0 +1,325 @@ +openapi: 3.0.1 +info: + title: Scenario specific Intent Expectations - 5GCNetworkExpectation + version: 20.0.0 + description: >- + OAS 3.0.1 definition of scenario specific Intent Expectations - 5GCNetworkExpectation + © 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 ----------# + 5GCNetworkExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for 5GC network delivering + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' + expectationObject: + $ref: '#/components/schemas/5GCNetworkExpectationObject' + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/MaxNumberofPDUsessionsTarget' + - $ref: '#/components/schemas/MaxNumberofRegisteredsubscribersTarget' + - $ref: '#/components/schemas/IncomingDataTarget' + - $ref: '#/components/schemas/OutgoingDataTarget' + - $ref: '#/components/schemas/LatencyTarget' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' + expectationContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/StartTimeContext' + - $ref: '#/components/schemas/ResourceSharingLevelContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/DecompositionAssistingContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + required: + - expectationId + #-------Definition of the Scenario specific IntentExpectation dataType ----------# + + #-------Definition of the scenario specific ExpectationObject dataType ----------# + 5GCNetworkExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for 5GCNetworkExpectation + type: object + properties: + objectType: + type: string + enum: + - 5GC_SUBNETWORK #value for 5GC Network Expectation--# + objectInstance: + $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/NfTypeContext' + - $ref: '#/components/schemas/NfInstanceLocationContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/PLMNContext' + - $ref: '#/components/schemas/TaiContext' + - $ref: '#/components/schemas/ServingScopeContext' + - $ref: '#/components/schemas/DnnContext' + - $ref: '#/components/schemas/PreferredUPFContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + #-------Definition of the scenario specific ExpectationObject dataType ----------# + + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + MaxNumberofPDUsessionsTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofPDUsessionsTarget.It describes the maximum number of PDU sessions for 5GC + SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofPDUsessions in clause 5.3.1.2 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - MaxNumberofPDUsessions + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + targetContexts: + $ref: '#/components/schemas/5GSessionContext' + 5GSessionContext: + description: >- + This data type is the "TargetContext" data type with specialisations for 5GSessionContext.It describes the maximum supported 5G PDU session of the 5GC SubNetwork + related to the intent expectation. + type: object + properties: + contextAttribute: + type: string + enum: + - 5GSession + contextCondition: + type: string + enum: + - IS_less_THAN + contextValueRange: + type: integer + MaxNumberofRegisteredsubscribersTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofRegisteredsubscribersTarget.It describes the maximum number of Registered + subscribers for 5GC SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofRegisteredsubscribers in clause 5.6.2 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - MaxNumberofRegisteredsubscribers + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + IncomingDataTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for IncomingDataTarget.It describes the maximum incoming data packets for 5GC SubNetwork + related to the intent expectation. For details, see N6 incoming link usage measurement in clause 5.4.2.1 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - IncomingData + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + OutgoingDataTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for OutgoingDataTarget.It describes the maximum outgoing data packets for 5GC SubNetwork + related to the intent expectation. For details, see N6 outgoing link usage measurement in clause 5.4.2.2 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - OutgoingData + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + LatencyTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LatencyTarget. + It represents the latency target for the core network service (ending at the UPF) that the + intent expectation is applied. + type: object + properties: + targetName: + type: string + enum: + - Latency + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + #-------Definition of the concrete ObjectContext dataType----------------# + NfTypeContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for NfTypeContext + type: object + properties: + contextAttribute: + type: string + enum: + - NfType + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28541_5GcNrm.yaml#/components/schemas/NFType' + NfInstanceLocationContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for NfInstanceLocationContext + type: object + properties: + contextAttribute: + type: string + enum: + - NfInstanceLocation + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + TaiContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for TaiContext + type: object + properties: + contextAttribute: + type: string + enum: + - Tai + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tai' + ServingScopeContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for ServingScopeContext + type: object + properties: + contextAttribute: + type: string + enum: + - ServingScope + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + DnnContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for DnnContext + type: object + properties: + contextAttribute: + type: string + enum: + - Dnn + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + PreferredUPFContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for PreferredUPFContext + type: object + properties: + contextAttribute: + type: string + enum: + - PreferredUPF + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + #-------Definition of the concrete ObjectContext dataType----------------# + + #-------Definition of the concrete ExpectationContext dataType----------------# + StartTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for StartTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - StartTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + ResourceSharingLevelContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ResourceSharingLevelContext + type: object + properties: + contextAttribute: + type: string + enum: + - ResourceSharingLevel + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: "TS28541_SliceNrm.yaml#/components/schemas/SharingLevel" + #-------Definition of the concrete ExpectationContext dataType----------------# -- GitLab From 557345602d056089fbe33f07cccbc40119b1cf44 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:43:23 +0000 Subject: [PATCH 04/13] Upload New File --- ...TS28312_EdgeServiceSupportExpectation.yaml | 301 ++++++++++++++++++ 1 file changed, 301 insertions(+) create mode 100644 OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml diff --git a/OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml b/OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml new file mode 100644 index 00000000..1fb6a650 --- /dev/null +++ b/OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml @@ -0,0 +1,301 @@ +openapi: 3.0.1 +info: + title: Scenario specific Intent Expectations - EdgeServiceSupportExpectation + version: 20.0.0 + description: >- + OAS 3.0.1 definition of scenario specific Intent Expectations - EdgeServiceSupportExpectation + © 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 ----------# + EdgeServiceSupportExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for service deployment + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' + expectationObject: + $ref: '#/components/schemas/EdgeServiceSupportExpectationObject' + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/DLThptPerUETarget' + - $ref: '#/components/schemas/ULThptPerUETarget' + - $ref: '#/components/schemas/DLLatencyTarget' + - $ref: '#/components/schemas/ULLatencyTarget' + - $ref: '#/components/schemas/MaxNumberofUEsTarget' + - $ref: '#/components/schemas/ActivityFactorTarget' + - $ref: '#/components/schemas/UESpeedTarget' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' + expectationContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/ServiceStartTimeContext' + - $ref: '#/components/schemas/ServiceEndTimeContext' + - $ref: '#/components/schemas/UEMobilityLevelContext' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/ResourceSharingLevelContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/DecompositionAssistingContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + required: + - expectationId + - expectationObject + - expectationTargets + #-------Definition of the Scenario specific IntentExpectation dataType ----------# + + + #-------Definition of the scenario specific ExpectationObject dataType ----------# + EdgeServiceSupportExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for EdgeServiceSupportExpectation + type: object + properties: + objectType: + type: string + enum: + - EDGE_SERVICE_SUPPORT #value for Edge Service Support Expectation--# + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/EdgeIdentificationIdContext' + - $ref: '#/components/schemas/EdgeIdentificationLocContext' + - $ref: '#/components/schemas/CoverageAreaTAContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + #-------Definition of the scenario specific ExpectationObject dataType ----------# + + + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + 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 + MaxNumberofUEsTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofUEsTarget.It describes the the number of UEs for edge service supporting + that the intent expectation is applied. For details see attribute maxNumberofUE defined in clause 6.3.1 of of TS 28.541 [5] + type: object + properties: + targetName: + type: string + enum: + - maxNumberofUEs + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + ActivityFactorTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for ActivityFactorTarget.It describes the percentage value of the amount of simultaneous + active UEs to the total number of UEs where active means the UEs are exchanging data with the edge service supporting that the intent expectation is applied. + For details see activityFactor in clause 6.3.1 in TS 28.541 [5]. + type: object + properties: + targetName: + type: string + enum: + - activityFactor + targetCondition: + type: string + enum: + - IS_EQUAL_TO + targetValueRange: + type: integer + UESpeedTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for UESpeedTarget.It describes the speed (in km/hour) supported for edge service supporting + that the intent expectation is applied. For details see uESpeed in clause 6.3.1 in TS 28.541[5]. + type: object + properties: + targetName: + type: string + enum: + - uESpeed + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + + + #-------Definition of the concrete ObjectContext dataType----------------# + EdgeIdentificationIdContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationIdContext + type: object + properties: + contextAttribute: + type: string + enum: + - edgeIdentificationId + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + type: string + EdgeIdentificationLocContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationLocContext + type: object + properties: + contextAttribute: + type: string + enum: + - edgeIdentificationTarget + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoCoordinate' + CoverageAreaTAContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CoverageAreaTAContext + type: object + properties: + contextAttribute: + type: string + enum: + - coverageAreaTA + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Tac' + #-------Definition of the concrete ObjectContext dataType----------------# + + #-------Definition of the concrete ExpectationContext dataType----------------# + ServiceStartTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ServiceStartTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - ServiceStartTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + ServiceEndTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ServiceEndTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - ServiceEndTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + UEMobilityLevelContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for UEMobilityLevelContext + type: object + properties: + contextAttribute: + type: string + enum: + - UEMobilityLevel + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: "TS28541_SliceNrm.yaml#/components/schemas/MobilityLevel" + #-------Definition of the concrete ExpectationContext dataType----------------# \ No newline at end of file -- GitLab From 302d29eb08c134c06b5395bcef920b2b1c08053f Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:43:43 +0000 Subject: [PATCH 05/13] Upload New File --- ...TS28312_NetworkMaintenanceExpectation.yaml | 195 ++++++++++++++++++ 1 file changed, 195 insertions(+) create mode 100644 OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml diff --git a/OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml b/OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml new file mode 100644 index 00000000..45304c57 --- /dev/null +++ b/OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml @@ -0,0 +1,195 @@ +openapi: 3.0.1 +info: + title: Scenario specific Intent Expectations - NetworkMaintenanceExpectation + version: 20.0.0 + description: >- + OAS 3.0.1 definition of scenario specific Intent Expectations - NetworkMaintenanceExpectation + © 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 ----------# + NetworkMaintenanceExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for Network Maintenance + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' + expectationObject: + $ref: '#/components/schemas/NetworkMaintenanceExpectationObject' + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/MaintenanceVersionTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/WeakRSRPRatioTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/LowSINRRatioTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/AveULRANUEThptTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/AveDLRANUEThptTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/LowULRANUEThptRatioTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/LowDLRANUEThptRatioTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/HighULPrbLoadRatioTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/HighDLPrbLoadRatioTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/AveULPrbLoadTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/AveDLPrbLoadTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/RANEnergyConsumptionTarget' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/RANEnergyEfficiencyTarget' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/MaxNumberofPDUsessionsTarget' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/MaxNumberofRegisteredsubscribersTarget' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/IncomingDataTarget' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/OutgoingDataTarget' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' + expectationContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/MaintenanceTimeContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/DecompositionAssistingContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + required: + - expectationId + - expectationObject + - expectationTargets + + #-------Definition of the Scenario specific IntentExpectation dataType ----------# + + + #-------Definition of the scenario specific ExpectationObject dataType ----------# + NetworkMaintenanceExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for NetworkMaintenanceExpectation + type: object + properties: + objectInstance: + $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/MaintenanceVersionContext' + - $ref: '#/components/schemas/MaintenanceOrderContext' + - $ref: '#/components/schemas/MaintenanceTypeContext' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/NfTypeContext' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/NfInstanceLocationContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/PLMNContext' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/TaiContext' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/ServingScopeContext' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/DnnContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/CoverageAreaPolygonContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/CoverageTACContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/PLMNContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/DlFrequencyContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/UlFrequencyContext' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/RATContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + #-------Definition of the scenario specific ExpectationObject dataType ----------# + + + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + MaintenanceVersionTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for Maintenance Version Target. It describes the maintenance version target for the network maintenance, such as target version of the maintenance object after maintenance. + type: object + properties: + targetName: + type: string + enum: + - MaintenanceVersion + targetCondition: + type: string + enum: + - IS_EQUAL_TO + targetValueRange: + type: string + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + + + #-------Definition of the concrete ObjectContext dataType----------------# + MaintenanceVersionContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for MaintenanceVersionContext. It describes the scope of the maintenance objects based on software version. + type: object + properties: + contextAttribute: + type: string + enum: + - swVersion + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + type: string + MaintenanceOrderContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for MaintenanceOrderContext. It describes describes the list of DNs for NFs/NEs based on their order for maintenance. + type: object + properties: + contextAttribute: + type: string + enum: + - maintenanceOrder + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + type: string + MaintenanceTypeContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for MaintenanceTypeContext. It describes the type of maintenance expected for the maintenance object. + type: object + properties: + contextAttribute: + type: string + enum: + - maintenanceType + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + type: array + uniqueItems: true + items: + type: string + enum: + - UPGRADE + - DOWNGRADE + #-------Definition of the concrete ObjectContext dataType----------------# + + #-------Definition of the concrete ExpectationContext dataType----------------# + MaintenanceTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for MaintenanceTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - MaintenanceTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + #-------Definition of the concrete ExpectationContext dataType----------------# \ No newline at end of file -- GitLab From 252a0feba4eb9dccdfb3b2f9f601955e4d1770c7 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:43:55 +0000 Subject: [PATCH 06/13] Upload New File --- OpenAPI/TS28312_RadioNetworkExpectation.yaml | 770 +++++++++++++++++++ 1 file changed, 770 insertions(+) create mode 100644 OpenAPI/TS28312_RadioNetworkExpectation.yaml diff --git a/OpenAPI/TS28312_RadioNetworkExpectation.yaml b/OpenAPI/TS28312_RadioNetworkExpectation.yaml new file mode 100644 index 00000000..41b45cda --- /dev/null +++ b/OpenAPI/TS28312_RadioNetworkExpectation.yaml @@ -0,0 +1,770 @@ +openapi: 3.0.1 +info: + title: Scenario specific Intent Expectations - RadioNetworkExpectation + version: 20.0.0 + description: >- + OAS 3.0.1 definition of scenario specific Intent Expectations - RadioNetworkExpectation + © 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 ----------# + RadioNetworkExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio network delivering and performance assurance + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' + expectationObject: + $ref: '#/components/schemas/RadioNetworkExpectationObject' + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/WeakRSRPRatioTarget' + - $ref: '#/components/schemas/LowSINRRatioTarget' + - $ref: '#/components/schemas/AveULRANUEThptTarget' + - $ref: '#/components/schemas/AveDLRANUEThptTarget' + - $ref: '#/components/schemas/LowULRANUEThptRatioTarget' + - $ref: '#/components/schemas/LowDLRANUEThptRatioTarget' + - $ref: '#/components/schemas/HighULPrbLoadRatioTarget' + - $ref: '#/components/schemas/HighDLPrbLoadRatioTarget' + - $ref: '#/components/schemas/AveULPrbLoadTarget' + - $ref: '#/components/schemas/AveDLPrbLoadTarget' + - $ref: '#/components/schemas/RANEnergyConsumptionTarget' + - $ref: '#/components/schemas/RANEnergyEfficiencyTarget' + - $ref: '#/components/schemas/ActiveUEsNumTarget' + - $ref: '#/components/schemas/PRBsTarget' + - $ref: '#/components/schemas/InterRAThandoverTarget' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' + expectationContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/TargetAssuranceTimeContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/SchedulingTimeContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/DecompositionAssistingContext' + - $ref: '#/components/schemas/PrbHighLoadRatioContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + required: + - expectationId + - expectationObject + - expectationTargets + + #-------Definition of the IntentExpectation dataType ----------# + + #-------Definition of the scenario specific ExpectationObject dataType ----------# + RadioNetworkExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for RadioNetworkExpectation + type: object + properties: + objectType: + type: string + enum: + - RAN_SUBNETWORK + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/CoverageAreaPolygonContext' + - $ref: '#/components/schemas/CoverageTACContext' + - $ref: '#/components/schemas/TimeBasedAreaContext' + - $ref: '#/components/schemas/CellContext' + - $ref: '#/components/schemas/PLMNContext' + - $ref: '#/components/schemas/DlFrequencyContext' + - $ref: '#/components/schemas/UlFrequencyContext' + - $ref: '#/components/schemas/RATContext' + - $ref: '#/components/schemas/UEGroupContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + + #-------Definition of the scenario specific ExpectationObject dataType ----------# + + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + WeakRSRPRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for WeakRSRPRatioTarget. It describes + the downlink weak coverage ratio target for the RAN SubNetwork that the intent expectation is applied. + The numerator is the number of the cells with downlink weak RSRP, and the denominator is the total number + of cells of the RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - WeakRSRPRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/WeakRSRPContext' + WeakRSRPContext: + description: >- + This data type is the "TargetContext" data type with specialisations for WeakRSRPContext. It describes the threshold + for downlink weak RSRP of the cells (see RSRP measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent + expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - WeakRSRPThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: number + LowSINRRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LowSINRatioTarget.It describes the low SINR + ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the cells with + low SINR, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - LowSINRRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/LowSINRContext' + LowSINRContext: + description: >- + This data type is the "TargetContext" data type with specialisations for LowSINRContext.It describes the threshold for + low SINR of the cells (see SINR measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - LowSINRThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: integer + AveULRANUEThptTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveULRANUEThptTarget.It describes the average + UL RAN UE throughput target for RAN SubNetwork (see UL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent + expectation is applied. + type: object + properties: + targetName: + type: string + enum: + - AveULRANUEThpt + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + type: integer + targetContexts: + type: array + items: + type: object + oneOf: + - $ref: '#/components/schemas/UlFrequencyContext' + - $ref: '#/components/schemas/RATContext' + AveDLRANUEThptTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveDLRANUEThptTarget.It describes the average + DL RAN UE throughput target for RAN SubNetwork (see DL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent + expectation is applied. + type: object + properties: + targetName: + type: string + enum: + - AveDLRANUEThpt + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + type: integer + targetContexts: + type: array + items: + type: object + oneOf: + - $ref: '#/components/schemas/DlFrequencyContext' + - $ref: '#/components/schemas/RATContext' + LowULRANUEThptRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LowULRANUEThptRatioTarget.It describes the low + UL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number + of the cells with low UL RAN UE throughput, and the denominator is the total number of cells of the RAN Subnetwork in the + specified area. + type: object + properties: + targetName: + type: string + enum: + - LowULRANUEThptRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/LowULRANUEThptContext' + LowULRANUEThptContext: + description: >- + This data type is the "TargetContext" data type with specialisations for LowULRANUEThptContext.It describes the threshold + for the low UL RAN UE throughput cells (see average UL RAN UE throughput in gNB and distribution of UL UE throughput in gNB + in TS 28.552[6]) of the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - LowULRANUEThptThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: number + LowDLRANUEThptRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LowDLRANUEThptRatioTarget. It describes + the low DL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied.The numerator + is the number of the cells with low DL RAN UE throughput, and the denominator is the total number of cells of the + RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - LowDLRANUEThptRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/LowDLRANUEThptContext' + LowDLRANUEThptContext: + description: >- + This data type is the "TargetContext" data type with specialisations for LowDLRANUEThptContext.It describes the threshold + for the low DL RAN UE throughput cells ((see average DL RAN UE throughput in gNB and distribution of DL UE throughput in gNB + in TS 28.552[6]) ) of the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - LowDLRANUEThptThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: number + HighULPrbLoadRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for HighULPrbLoadRatioTarget. It describes the high UL + PRB load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number + of the cells with high UL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - HighULPrbLoadRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/HighULPrbLoadContext' + HighULPrbLoadContext: + description: >- + This data type is the "TargetContext" data type with specialisations for HighULPrbLoadContext.It describes the threshold for high + uplink PRB load (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN + SubNetwork in the specified area that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - HighULPrbLoadThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: integer + minimum: 0 + maximum: 100 + HighDLPrbLoadRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for HighDLPrbLoadRatioTarget.It describes the high DL PRB + load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the + cells with high DL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - HighDLPrbLoadRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/HighDLPrbLoadContext' + HighDLPrbLoadContext: + description: >- + This data type is the "TargetContext" data type with specialisations for HighDLPrbLoadContext.It describes the threshold for high downlink + PRB load (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) of the cells of the RAN SubNetwork in the + specified area that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - HighDLPrbLoadThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: integer + minimum: 0 + maximum: 100 + AveULPrbLoadTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveULPrbLoadTarget.It describes the average uplink PRB load target + (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN SubNetwork that the intent + expectation is applied. + type: object + properties: + targetName: + type: string + enum: + - AveULPrbLoad + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + AveDLPrbLoadTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveDLPrbLoadTarget.It describes the average dowlink PRB load + (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) target for RAN SubNetwork that the intent expectation + is applied. + type: object + properties: + targetName: + type: string + enum: + - AveDLPrbLoad + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + RANEnergyConsumptionTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for RANEnergyConsumptionTarget.It describes the RAN energy consumption + target for RAN SubNetwork that the intent expectation is applied. The definition for RAN energy consumption see ECNG-RAN in clause 6.7.3.4.1 in + TS 28.554 [11]. + type: object + properties: + targetName: + type: string + enum: + - RANEnergyConsumption + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + RANEnergyEfficiencyTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for RANEnergyEfficiencyTarget.It describes the RAN energy efficiency target + for RAN SubNetwork that the intent expectation is applied. The unit of this target is bit/J. The definition for RAN energy efficiency target for RAN + SubNetwork see EEMN,DV in clause 6.7.1.1 in TS 28.554 [11]. + type: object + properties: + targetName: + type: string + enum: + - RANEnergyEfficiency + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + type: integer + ActiveUEsNumTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for ActiveUEsNumTarget. + It describes the number of Active UEs for the specified areas. This target is related to Mean + number of Active UEs in the DL per cell and Mean number of Active UEs in the UL per cell defined + in 3GPP TS 28.552 [6]. + type: object + properties: + targetName: + type: string + enum: + - ActiveUEsNum + targetCondition: + type: string + enum: + - IS_WITHIN_RANGE + targetValueRange: + type: array + description: >- + a pair of integer values to represent minimum number of active UEs and maximum number of active UEs. + items: + type: integer + minItems: 1 + maxItems: 2 + PRBsTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for PRBsTarget. + It describes total available number of physical resource blocks (PRBs). This target is equal to the difference between the DL total available PRB plus UL total available PRB of operator A and the DL total available PRB plus UL total available PRB of operator B. DL total available PRB and UL total available PRB defined in clause 5.1.1.2.6 and 5.1.1.2.8 of TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - pRBS + targetCondition: + type: string + enum: + - IS_EQUAL_TO + targetValueRange: + type: integer + InterRAThandoverTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for PRBsTarget. + it shows how often a handover from 5GS to EPS is successful. The InterRAThandover target is equal to the difference between 5GS to EPS handover success rate of operator A and 5GS to EPS handover success rate of operator B. For details see attribute 5GS to EPS handover success rate defined in clause 6.6.4 of TS 28.554 [11]. + type: object + properties: + targetName: + type: string + enum: + - InterRATHandover + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + + #-------Definition of the concrete ObjectContext dataType----------------# + CoverageAreaPolygonContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CoverageAreaPolygonContext.It describes the coverage areas for the RAN SubNetwork that the + intent expectation is applied in the form of polygon. + type: object + properties: + contextAttribute: + type: string + enum: + - CoverageAreaPolygon + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + CoverageTACContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CoverageTACContext.It describes the coverage areas for the RAN SubNetwork that the intent + expectation is applied in the form of TAC. + type: object + properties: + contextAttribute: + type: string + enum: + - CoverageAreaTac + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: "TS28623_ComDefs.yaml#/components/schemas/Tac" + CellContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CellContext. + It describes the coverage areas for the RAN SubNetwork or Radio Service that the intent expectation is applied + in the form of a list of cells (including E-UTRAN cells identified by E-UTRAN-CGI and NR cells + identified by NG-RAN CGI). + type: object + properties: + contextAttribute: + type: string + enum: + - Cell + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + $ref: "#/components/schemas/CellId" + CellId: + oneOf: + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/EutraCellId' + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/NrCellId' + TimeBasedAreaContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for TimeBasedAreaContext. + It describes the areas for specific times for the RAN SubNetwork that the intent expectation is + applied in the form of a list. + type: object + properties: + contextAttribute: + type: string + enum: + - TimeBasedArea + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + $ref: "#/components/schemas/TimeBasedArea" + TimeBasedArea: + type: object + properties: + geoArea: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + timeWindow: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + PLMNContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for PLMNContext + type: object + properties: + contextAttribute: + type: string + enum: + - PLMN + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' + 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' + CivicAreaContext: + description: >- + It describes the coverage areas for the RAN SubNetwork or Radio Service that the intent expectation is applied in the form of civic area. + The civic area supports civic address (e.g. streets, districts, seats, etc.) or location label (e.g. hotel name, school name) + type: object + properties: + contextAttribute: + type: string + enum: + - CivicArea + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/CivicArea' + DlFrequencyContext: + description: >- + This data type is the "Context" data type with specialisations for Object context "DLFrequencyContext". It describes the downlink frequency information (RF reference + frequencies and/ or the frequency operating band) supported by the RAN SubNetwork or Radio Service that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - DlFrequency + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' + UlFrequencyContext: + description: >- + This data type is the "Context" data type with specialisations for Object context "ULFrequencyContext".It describes the uplink frequency information (RF reference + frequencies and/ or the frequency operating band) supported by the RAN SubNetwork or Radio Service that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - UlFrequency + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' + RATContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for RATContext.It describes the RAT supported by the RAN SubNetwork that the intent expectation + is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - RAT + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + enum: + - UTRAN + - EUTRAN + - NR + UEGroupContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for UEGroup([QoSId, SNSSAI, pLMNId]) + type: object + properties: + contextAttribute: + type: string + enum: + - UEGroup + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: "TS28312_IntentNrm.yaml#/components/schemas/UEGroup" + + #-------Definition of the concrete ObjectContext dataType----------# + + #-------Definition of the concrete ExpectationContext dataType----------------# + + TargetAssuranceTimeContext: + description: >- + This data type is the "Expectation Context" data type with specialisations for TargetAssuranceTimeContext.It describes the timeWindows + (including startTime, endTime) when the targets in the Intent Expectation need to be assured. + type: object + properties: + contextAttribute: + type: string + enum: + - TargetAssuranceTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + PrbHighLoadRatioContext: + description: >- + This data type describes the load condition (i.e. PrbHighLoadRatio) for the radio network + that the intent expectation is applied. The detailed PrbHighLoadRatio see PrbHighLoadRatio defined in TS 28.554 + type: object + properties: + contextAttribute: + type: string + enum: + - prbHighLoadRatio + contextCondition: + type: string + enum: + - IS_GREATER_THAN + contextValueRange: + type: number + minimum: 0 + maximum: 1 + #-------Definition of the concrete ExpectationContext dataType----------------# \ No newline at end of file -- GitLab From ef527cb9c5a6be66ccab14b631a8aa7f49a0dbc2 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:44:11 +0000 Subject: [PATCH 07/13] Upload New File --- OpenAPI/TS28312_RadioServiceExpectation.yaml | 240 +++++++++++++++++++ 1 file changed, 240 insertions(+) create mode 100644 OpenAPI/TS28312_RadioServiceExpectation.yaml diff --git a/OpenAPI/TS28312_RadioServiceExpectation.yaml b/OpenAPI/TS28312_RadioServiceExpectation.yaml new file mode 100644 index 00000000..5a172ecc --- /dev/null +++ b/OpenAPI/TS28312_RadioServiceExpectation.yaml @@ -0,0 +1,240 @@ +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: 'TS28312_RadioNetworkExpectation.yaml#/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 -- GitLab From 65c1c2b9db6090e4d3756964531888272b94a2da Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:44:29 +0000 Subject: [PATCH 08/13] Replace TS28312_IntentNrm.yaml --- OpenAPI/TS28312_IntentNrm.yaml | 427 +++++++++++++++++++++++++++++++-- 1 file changed, 401 insertions(+), 26 deletions(-) diff --git a/OpenAPI/TS28312_IntentNrm.yaml b/OpenAPI/TS28312_IntentNrm.yaml index 8a87834c..3c847380 100644 --- a/OpenAPI/TS28312_IntentNrm.yaml +++ b/OpenAPI/TS28312_IntentNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Intent NRM - version: 19.5.0 + version: 20.0.0 description: >- OAS 3.0.1 definition of the Intent NRM © 2026, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -39,11 +39,11 @@ components: type: object oneOf: - $ref: '#/components/schemas/IntentExpectation' - - $ref: 'TS28312_IntentExpectations.yaml#/components/schemas/RadioNetworkExpectation' - - $ref: 'TS28312_IntentExpectations.yaml#/components/schemas/EdgeServiceSupportExpectation' - - $ref: 'TS28312_IntentExpectations.yaml#/components/schemas/5GCNetworkExpectation' - - $ref: 'TS28312_IntentExpectations.yaml#/components/schemas/RadioServiceExpectation' - - $ref: 'TS28312_IntentExpectations.yaml#/components/schemas/NetworkMaintenanceExpectation' + - $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/RadioNetworkExpectation' + - $ref: 'TS28312_EdgeServiceSupportExpectation.yaml#/components/schemas/EdgeServiceSupportExpectation' + - $ref: 'TS28312_5GCNetworkExpectation.yaml#/components/schemas/5GCNetworkExpectation' + - $ref: 'TS28312_RadioServiceExpectation.yaml#/components/schemas/RadioServiceExpectation' + - $ref: 'TS28312_NetworkMaintenanceExpectation.yaml#/components/schemas/NetworkMaintenanceExpectation' intentMgmtPurpose: $ref: '#/components/schemas/IntentMgmtPurpose' contextSelectivity: @@ -86,6 +86,17 @@ components: implicitIntentIndex: type: boolean default: false + guaranteePeriods: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/SchedulingTimeContext' + intentHandlingInfo: + $ref: '#/components/schemas/IntentHandlingInfo' + intentInterpretationAssistanceInfo: + $ref: '#/components/schemas/IntentInterpretationAssistanceInfo' intentReportReference: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' intentUtilityFormulaRef: @@ -120,6 +131,8 @@ components: $ref: '#/components/schemas/IntentUtilityReport' intentFulfilmentNegotiationReport: $ref: '#/components/schemas/IntentFulfilmentNegotiationReport' + intentDecompositionReport: + $ref: '#/components/schemas/IntentDecompositionReport' lastUpdatedTime: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTimeRo' intentReference: @@ -135,6 +148,17 @@ components: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object properties: + intentHandlingScope: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/IntentHandlingScope' + supportedNegotiationFunctionalities: + type: array + uniqueItems: true + minimum: 1 + items: + $ref: '#/components/schemas/NegotiationFunctionality' intentHandlingCapabilityList: type: array uniqueItems: true @@ -209,6 +233,13 @@ components: minimum: 0 maximum: 10 description: It represents the preference information of the Consumer on expectations. + guaranteePeriods: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/SchedulingTimeContext' required: - expectationId - expectationObject @@ -270,6 +301,7 @@ components: type: string enum: - FEASIBILITYCHECK + - FEASIBILITYCHECK_WITH_RECOMMENDATIONS - FULFILMENT_WITHOUT_NEGOTIATION - EXPLORATION - FULFILMENT_WITH_NEGOTIATION @@ -286,13 +318,11 @@ components: type: string readOnly: true enum: - - ACKNOWLEDGED - - COMPLIANT + - RECEIVED - DEGRADED - SUSPENDED - TERMINATED - - FULFILMENTFAILED - default: ACKNOWLEDGED + default: RECEIVED description: It describes the current progress of or the reason for not achieving fulfilment for the intent, intentExpectation or expectationTarget. An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo @@ -314,7 +344,30 @@ components: readOnly: true description: An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo required: - - fulfilmentStatus + - fulfilmentStatus + + FulfilmentStatisticsInfo: + type: object + properties: + expectationObjectFulfilmentInfo: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Distribution' + expectationTemporalFulfilmentInfo: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Distribution' + + Distribution: + type: object + properties: + couter: + type: integer + bin: + type: string + ExpectationVerb: type: string enum: @@ -353,21 +406,159 @@ components: - $ref: '#/components/schemas/UEGroup' - $ref: '#/components/schemas/Frequency' - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/SchedulingTime' + - $ref: '#/components/schemas/CivicArea' UEGroup: description: >- - It describes the UE Group, - which is represented by specific 5QI, specific S-NSSAI, specific PLMNId or - a specific combination of S-NSSAI, 5QI and PLMNId. + which is represented by specific QoSId, specific S-NSSAI, specific PLMNId or + a specific combination of S-NSSAI, QoSId and PLMNId. type: object properties: pLMNId: $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' - fiveQI: - type: integer - minimum: 0 - maximum: 255 + qOSId: + $ref: '#/components/schemas/QoSId' sNssai: $ref: 'TS28541_NrNrm.yaml#/components/schemas/Snssai' + uEType: + description: It describes the information of a UE Type defined in TS 38.331 + type: string + enum: + - REDCAP_UE + - EREDCAP_UE + QoSId: + oneOf: + - type: object + properties: + qCI: + description: >- + It describes QCI for EUTRAN network. + type: integer + minimum: 0 + maximum: 255 + - type: object + properties: + fiveQI: + description: >- + It describes 5QI for NR network. + type: integer + minimum: 0 + maximum: 255 + IntentHandlingScope: + type: string + enum: + - RAN + - CN + NegotiationFunctionality: + type: string + enum: + - FEASIBILITY_CHECK + - EXPLORATION + - FULFILMENT_WITH_NEGOTIATION + CivicArea: + description: >- + It describes civic area, which is represented by civic address (e.g. streets, districts, seats, etc.) or + location label (e.g. hotel name, school name). + oneOf: + - type: object + properties: + civicAddress: + $ref: '#/components/schemas/CivicAddress' + - type: object + properties: + locationLabel: + description: >- + It describes a location label (e.g. hotel name, school name). + type: string + CivicAddress: + description: Indicates a Civic address. + type: object + properties: + country: + type: string + A1: + type: string + A2: + type: string + A3: + type: string + A4: + type: string + A5: + type: string + A6: + type: string + PRD: + type: string + POD: + type: string + STS: + type: string + HNO: + type: string + HNS: + type: string + LMK: + type: string + LOC: + type: string + NAM: + type: string + PC: + type: string + BLD: + type: string + UNIT: + type: string + FLR: + type: string + ROOM: + type: string + PLC: + type: string + PCN: + type: string + POBOX: + type: string + ADDCODE: + type: string + SEAT: + type: string + RD: + type: string + RDSEC: + type: string + RDBR: + type: string + RDSUBBR: + type: string + PRM: + type: string + POM: + type: string + usageRules: + type: string + method: + type: string + providedBy: + type: string + IntentHandlingInfo: + description: >- + It contains includeTraceInfo, which is an attribute to control whether traceability + information may be propagated upon intent decomposition. + It also contains an ordered list of IntentTraceabilityInfo entries, each recording the + identity of an intent handling function that has processed the intent and the identity + of the corresponding derived intent. + type: object + properties: + includeTraceInfo: + type: boolean + default: true + intentTraceabilityInfoList: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/IntentTraceabilityInfo' + #-------Definition of the generic dataType --------------# #-------Definition of the generic ExpectationTarget dataType----------# @@ -427,6 +618,9 @@ components: items: $ref: "#/components/schemas/ValueRangeType" - $ref: "#/components/schemas/ValueRangeType" + contextInvariant: + type: boolean + default: false required: - contextAttribute - contextCondition @@ -446,9 +640,8 @@ components: type: string observationPeriod: description: >- - It indicates the time period for which the fulfilment process is observed - and at the end of which the fulfilmentInfo for corresponding - ExpectationTargets, IntentExpectations and Intent is updated. + It indicates the time period for which the fulfilment process or exploration process is observed + and at the end of which which the IntentFulfilmentReport or IntentExplorationReport is updated and reported. type: integer expectedReportTypes: description: >- @@ -481,6 +674,7 @@ components: - INTENT_EXPLORATION_REPORT - INTENT_FULFILMENT_NEGOTIATION_REPORT - INTENT_UTILITY_REPORT + - INTENT_DECOMPOSITION_REPORT ReportingCondition: description: >- It describes the specified conditions for intent reporting. @@ -535,6 +729,14 @@ components: Cell) and corresponding attributes which are updated during intent fulfilment. type: string readOnly: true + guaranteeConfidenceLevel: + description: >- + It indicate the guarantee confidence level calculated by the MnS Producer. This should be reported if the + corresponding intent is set for guarantee, i.e., when the guarantee period is set for the whole intent. + type: integer + minimum: 0 + maximum: 100 + readOnly: true required: - intentFulfilmentInfo #-------Definition of the concrete IntentFulfilmentReport dataType----------------# @@ -550,11 +752,22 @@ components: readOnly: true expectationFulfilmentInfo: $ref: '#/components/schemas/FulfilmentInfo' + expectationFulfilmentStatisticsInfo: + $ref: '#/components/schemas/FulfilmentStatisticsInfo' targetFulfilmentResults: type: array uniqueItems: true items: $ref: '#/components/schemas/TargetFulfilmentResult' + guaranteeConfidenceLevel: + description: >- + It indicate the guarantee confidence level calculated by the MnS Producer. This should be reported + if the corresponding intent expectation is set for guarantee, i.e., when the guarantee period is + set for the specific intent expectations. + type: integer + minimum: 0 + maximum: 100 + readOnly: true required: - expectaitonId - expectationFulfilmentInfo @@ -671,6 +884,12 @@ components: type: array items: $ref: '#/components/schemas/InFeasibleExpectationInfo' + additionalPreEvaluationInfo: + description: >- + It describes the additional provide additional pre-evaluation information for feasibility + check process. The content and format is vendor specific. + type: string + readOnly: true required: - feasibilityCheckResult - infeasibilityReasons @@ -687,12 +906,23 @@ components: type: array uniqueItems: true items: - type: string + $ref: '#/components/schemas/InFeasibleTargetInfo' readOnly: true - description: It describes the list of TargetNames for the InFeasibleTargets + description: It describes the list of inFeasibleTargetInfo for the InFeasibleTargets required: - expectationId - - inFeasibleTargets + - inFeasibleTargets + InFeasibleTargetInfo: + description: >- + It describes each infeasible target, including the targetName and recommendedValue for the InFeasibleTargets. + type: object + properties: + targetName: + type: string + readOnly: true + recommendedValue: + type: number + readOnly: true #-------Definition of the concrete IntentFeasibilityCheckReport dataType----------------# @@ -709,6 +939,21 @@ components: $ref: '#/components/schemas/ExpectationExplorationResult' uniqueItems: true minItems: 1 + additionalPreEvaluationInfo: + description: >- + It describes the additional provide additional pre-evaluation information for intent exploration + process. The content and format is vendor specific. + type: string + readOnly: true + expectationExplorationStatus: + description: -> + It describes the status of intent exploration process. + type: string + enum: + - NOT_STARTED + - RUNNING + - FINISHED + - FAILED ExpectationExplorationResult: description: >- It represents the expectation exploration result for a specific intent expectation @@ -720,7 +965,7 @@ components: targetExplorationResults: type: array items: - $ref: '#/components/schemas/ExpectationTarget' + $ref: '#/components/schemas/TargetExplorationResult' uniqueItems: true minItems: 1 contextExplorationResults: @@ -732,6 +977,23 @@ components: required: - expectationId - targetExplorationResults + TargetExplorationResult: + type: object + description: >- + It represents exploration results (i.e. recommended best values) for the expectation targets. + properties: + targetName: + type: string + targetCondition: + $ref: '#/components/schemas/Condition' + targetValueRange: + $ref: '#/components/schemas/ValueRangeType' + cellContext: + $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/CellContext' + coverageAreaPolygonContext: + $ref: 'TS28312_RadioNetworkExpectation.yaml#/components/schemas/CoverageAreaPolygonContext' + + #-------Definition of the generic IntentExplorationReport dataType----------------# @@ -832,6 +1094,7 @@ components: type: string readOnly: true supportedExpectationObjectType: + description: It describes the expectation object type which can be supported by a specific intent handling function of MnS producer. type: string enum: - RAN_SUBNETWORK @@ -839,13 +1102,24 @@ components: - 5GC_SUBNETWORK - RADIO_SERVICE readOnly: true - description: It describes the expectation object type which can be supported by a specific intent handling function of MnS producer. + supportedObjectContextInfoList: + type: array + items: + $ref: '#/components/schemas/SupportedContextInfo' + uniqueItems: true + minItems: 1 supportedExpectationTargetInfoList: type: array items: $ref: '#/components/schemas/SupportedExpectationTargetInfo' uniqueItems: true minItems: 1 + supportedExpectationContextInfoList: + type: array + items: + $ref: '#/components/schemas/SupportedContextInfo' + uniqueItems: true + minItems: 1 required: - intentHandlingCapabilityId - supportedExpectationObjectType @@ -870,6 +1144,23 @@ components: - $ref: '#/components/schemas/ValueRangeType' required: - supportedTargetName + + SupportedContextInfo: + type: object + properties: + supportedContextAttribute: + type: string + supportedContextCondition: + $ref: '#/components/schemas/Condition' + supportedContextValueRange: + oneOf: + - type: array + uniqueItems: true + minItems: 1 + items: + $ref: '#/components/schemas/ValueRangeType' + - $ref: '#/components/schemas/ValueRangeType' + #-------Definition of the concrete IntentHandlingCapability dataType----------------# @@ -918,6 +1209,36 @@ components: uniqueItems: true #-------Definition of the concrete UtilityDefinition dataType----------------# + #-------Definition of the generic IntentDecompositionReport dataType----------------# + IntentDecompositionReport: + description: >- + It includes the intentDecompositionResults. This attribute shall be supported when intent decomposition result information is supported by intent Report + type: object + properties: + intentDecompositionResults: + type: array + items: + $ref: '#/components/schemas/IntentTraceabilityInfo' + #-------Definition of the generic IntentDecompositionReport dataType----------------# + + #-------Definition of the generic IntentDecompositionResult dataType----------------# + IntentTraceabilityInfo: + description: >- + It describes traceability record associated with the handling of an intent + by a particular intent handling function + type: object + properties: + intentHandlingFunctionID: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + readOnly: true + intentID: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + readOnly: true + decomposedExpectationID: + type: string + readOnly: true + #-------Definition of the generic IntentDecompositionResult dataType----------------# + #------Definition of JSON arrays for name-contained IOCs ---------------# Intent-Multiple: @@ -942,6 +1263,60 @@ components: #------Definition of JSON arrays for name-contained IOCs ---------------# + #-------Definition of the generic IntentInterpretationAssistanceInformation dataType----------------# + IntentInterpretationAssistanceInfo: + description: >- + It represents the additional information needed for intent interpretation. + type: object + properties: + dateTime: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + conditions: + type: string + prevProducerMessage: + type: string + prevConsumerMessage: + type: string + #-------Definition of the concrete IntentInterpretationAssistanceInformation dataType----------------# + + #-------Definition of the common scenario specific IntentExpectation dataType----------------# + DecompositionAssistingContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for DecompositionAssistingContext. It describes the list of DNs of authorized intent handling functions to which intent decomposition is not recommended + type: object + properties: + contextAttribute: + type: string + enum: + - DecompositionAssisting + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + type: string + SchedulingTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for SchedulingTimeContext.It describes + the scheduled times (including one-time interval, daily periodicity, weekly periodicity or monthly periodicity) + for the IntentObject that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - schedulingTime + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + $ref: "TS28623_GenericNrm.yaml#/components/schemas/SchedulingTime" + #-------Definition of the common scenario specific IntentExpectation dataType----------------# + + #----- Definitions in TS 28.312 for TS 28.532 --------------------------# resources-intentNrm: oneOf: -- GitLab From 41431f67bac988b63be30773f80d2fd88c4321af Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:44:55 +0000 Subject: [PATCH 09/13] Delete TS28312_IntentExpectations.yaml --- OpenAPI/TS28312_IntentExpectations.yaml | 1528 ----------------------- 1 file changed, 1528 deletions(-) delete mode 100644 OpenAPI/TS28312_IntentExpectations.yaml diff --git a/OpenAPI/TS28312_IntentExpectations.yaml b/OpenAPI/TS28312_IntentExpectations.yaml deleted file mode 100644 index 379962e3..00000000 --- a/OpenAPI/TS28312_IntentExpectations.yaml +++ /dev/null @@ -1,1528 +0,0 @@ -openapi: 3.0.1 -info: - title: Scenario specific Intent Expectations - version: 19.3.0 - description: >- - OAS 3.0.1 definition of scenario specific Intent Expectations - © 2025, 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 ----------# - RadioNetworkExpectation: - description: >- - This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio network delivering and performance assurance - type: object - properties: - expectationId: - type: string - expectationVerb: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' - expectationObject: - $ref: '#/components/schemas/RadioNetworkExpectationObject' - expectationTargets: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/WeakRSRPRatioTarget' - - $ref: '#/components/schemas/LowSINRRatioTarget' - - $ref: '#/components/schemas/AveULRANUEThptTarget' - - $ref: '#/components/schemas/AveDLRANUEThptTarget' - - $ref: '#/components/schemas/LowULRANUEThptRatioTarget' - - $ref: '#/components/schemas/LowDLRANUEThptRatioTarget' - - $ref: '#/components/schemas/HighULPrbLoadRatioTarget' - - $ref: '#/components/schemas/HighDLPrbLoadRatioTarget' - - $ref: '#/components/schemas/AveULPrbLoadTarget' - - $ref: '#/components/schemas/AveDLPrbLoadTarget' - - $ref: '#/components/schemas/RANEnergyConsumptionTarget' - - $ref: '#/components/schemas/RANEnergyEfficiencyTarget' - - $ref: '#/components/schemas/ActiveUEsNumTarget' - - $ref: '#/components/schemas/PRBsTarget' - - $ref: '#/components/schemas/InterRAThandoverTarget' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' - expectationContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/TargetAssuranceTimeContext' - - $ref: '#/components/schemas/SchedulingTimeContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - - expectationObject - - expectationTargets - 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: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' - expectationContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/SchedulingTimeContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - - expectationObject - - expectationTargets - EdgeServiceSupportExpectation: - description: >- - This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for service deployment - type: object - properties: - expectationId: - type: string - expectationVerb: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' - expectationObject: - $ref: '#/components/schemas/EdgeServiceSupportExpectationObject' - expectationTargets: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/DLThptPerUETarget' - - $ref: '#/components/schemas/ULThptPerUETarget' - - $ref: '#/components/schemas/DLLatencyTarget' - - $ref: '#/components/schemas/ULLatencyTarget' - - $ref: '#/components/schemas/MaxNumberofUEsTarget' - - $ref: '#/components/schemas/ActivityFactorTarget' - - $ref: '#/components/schemas/UESpeedTarget' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' - expectationContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/ServiceStartTimeContext' - - $ref: '#/components/schemas/ServiceEndTimeContext' - - $ref: '#/components/schemas/UEMobilityLevelContext' - - $ref: '#/components/schemas/ResourceSharingLevelContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - - expectationObject - - expectationTargets - 5GCNetworkExpectation: - description: >- - This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for 5GC network delivering - type: object - properties: - expectationId: - type: string - expectationVerb: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' - expectationObject: - $ref: '#/components/schemas/5GCNetworkExpectationObject' - expectationTargets: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/MaxNumberofPDUsessionsTarget' - - $ref: '#/components/schemas/MaxNumberofRegisteredsubscribersTarget' - - $ref: '#/components/schemas/IncomingDataTarget' - - $ref: '#/components/schemas/OutgoingDataTarget' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' - expectationContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/StartTimeContext' - - $ref: '#/components/schemas/ResourceSharingLevelContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - NetworkMaintenanceExpectation: - description: >- - This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for Network Maintenance - type: object - properties: - expectationId: - type: string - expectationVerb: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' - expectationObject: - $ref: '#/components/schemas/NetworkMaintenanceExpectationObject' - expectationTargets: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/MaintenanceVersionTarget' - - $ref: '#/components/schemas/WeakRSRPRatioTarget' - - $ref: '#/components/schemas/LowSINRRatioTarget' - - $ref: '#/components/schemas/AveULRANUEThptTarget' - - $ref: '#/components/schemas/AveDLRANUEThptTarget' - - $ref: '#/components/schemas/LowULRANUEThptRatioTarget' - - $ref: '#/components/schemas/LowDLRANUEThptRatioTarget' - - $ref: '#/components/schemas/HighULPrbLoadRatioTarget' - - $ref: '#/components/schemas/HighDLPrbLoadRatioTarget' - - $ref: '#/components/schemas/AveULPrbLoadTarget' - - $ref: '#/components/schemas/AveDLPrbLoadTarget' - - $ref: '#/components/schemas/RANEnergyConsumptionTarget' - - $ref: '#/components/schemas/RANEnergyEfficiencyTarget' - - $ref: '#/components/schemas/MaxNumberofPDUsessionsTarget' - - $ref: '#/components/schemas/MaxNumberofRegisteredsubscribersTarget' - - $ref: '#/components/schemas/IncomingDataTarget' - - $ref: '#/components/schemas/OutgoingDataTarget' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' - expectationContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/MaintenanceTimeContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - - expectationObject - - expectationTargets - #-------Definition of the IntentExpectation dataType ----------# - - #-------Definition of the scenario specific ExpectationObject dataType ----------# - RadioNetworkExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for RadioNetworkExpectation - type: object - properties: - objectType: - type: string - enum: - - RAN_SUBNETWORK - objectInstance: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/CoverageAreaPolygonContext' - - $ref: '#/components/schemas/CoverageTACContext' - - $ref: '#/components/schemas/TimeBasedAreaContext' - - $ref: '#/components/schemas/CellContext' - - $ref: '#/components/schemas/PLMNContext' - - $ref: '#/components/schemas/DlFrequencyContext' - - $ref: '#/components/schemas/UlFrequencyContext' - - $ref: '#/components/schemas/RATContext' - - $ref: '#/components/schemas/UEGroupContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - 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: '#/components/schemas/CoverageAreaPolygonContext' - - $ref: '#/components/schemas/DlFrequencyContext' - - $ref: '#/components/schemas/UlFrequencyContext' - - $ref: '#/components/schemas/CellContext' - - $ref: '#/components/schemas/ServiceTypeContext' - - $ref: '#/components/schemas/UEGroupContext' - - $ref: '#/components/schemas/GeoCoordinateContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - EdgeServiceSupportExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for EdgeServiceSupportExpectation - type: object - properties: - objectType: - type: string - enum: - - EDGE_SERVICE_SUPPORT #value for Edge Service Support Expectation--# - objectInstance: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/EdgeIdentificationIdContext' - - $ref: '#/components/schemas/EdgeIdentificationLocContext' - - $ref: '#/components/schemas/CoverageAreaTAContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - 5GCNetworkExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for 5GCNetworkExpectation - type: object - properties: - objectType: - type: string - enum: - - 5GC_SUBNETWORK #value for 5GC Network Expectation--# - objectInstance: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/NfTypeContext' - - $ref: '#/components/schemas/NfInstanceLocationContext' - - $ref: '#/components/schemas/PLMNContext' - - $ref: '#/components/schemas/TaiContext' - - $ref: '#/components/schemas/ServingScopeContext' - - $ref: '#/components/schemas/DnnContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - NetworkMaintenanceExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for NetworkMaintenanceExpectation - type: object - properties: - objectInstance: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/MaintenanceVersionContext' - - $ref: '#/components/schemas/MaintenanceOrderContext' - - $ref: '#/components/schemas/MaintenanceTypeContext' - - $ref: '#/components/schemas/NfTypeContext' - - $ref: '#/components/schemas/NfInstanceLocationContext' - - $ref: '#/components/schemas/PLMNContext' - - $ref: '#/components/schemas/TaiContext' - - $ref: '#/components/schemas/ServingScopeContext' - - $ref: '#/components/schemas/DnnContext' - - $ref: '#/components/schemas/CoverageAreaPolygonContext' - - $ref: '#/components/schemas/CoverageTACContext' - - $ref: '#/components/schemas/PLMNContext' - - $ref: '#/components/schemas/DlFrequencyContext' - - $ref: '#/components/schemas/UlFrequencyContext' - - $ref: '#/components/schemas/RATContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - #-------Definition of the ExpectationObject dataType ----------# - - - #-------Definition of the Scenario specific ExpectationTarget dataType----------# - WeakRSRPRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for WeakRSRPRatioTarget. It describes - the downlink weak coverage ratio target for the RAN SubNetwork that the intent expectation is applied. - The numerator is the number of the cells with downlink weak RSRP, and the denominator is the total number - of cells of the RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - WeakRSRPRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/WeakRSRPContext' - WeakRSRPContext: - description: >- - This data type is the "TargetContext" data type with specialisations for WeakRSRPContext. It describes the threshold - for downlink weak RSRP of the cells (see RSRP measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent - expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - WeakRSRPThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: number - LowSINRRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for LowSINRatioTarget.It describes the low SINR - ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the cells with - low SINR, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - LowSINRRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/LowSINRContext' - LowSINRContext: - description: >- - This data type is the "TargetContext" data type with specialisations for LowSINRContext.It describes the threshold for - low SINR of the cells (see SINR measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - LowSINRThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: integer - AveULRANUEThptTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for AveULRANUEThptTarget.It describes the average - UL RAN UE throughput target for RAN SubNetwork (see UL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent - expectation is applied. - type: object - properties: - targetName: - type: string - enum: - - AveULRANUEThpt - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - type: integer - targetContexts: - type: array - items: - type: object - oneOf: - - $ref: '#/components/schemas/UlFrequencyContext' - - $ref: '#/components/schemas/RATContext' - AveDLRANUEThptTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for AveDLRANUEThptTarget.It describes the average - DL RAN UE throughput target for RAN SubNetwork (see DL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent - expectation is applied. - type: object - properties: - targetName: - type: string - enum: - - AveDLRANUEThpt - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - type: integer - targetContexts: - type: array - items: - type: object - oneOf: - - $ref: '#/components/schemas/DlFrequencyContext' - - $ref: '#/components/schemas/RATContext' - LowULRANUEThptRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for LowULRANUEThptRatioTarget.It describes the low - UL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number - of the cells with low UL RAN UE throughput, and the denominator is the total number of cells of the RAN Subnetwork in the - specified area. - type: object - properties: - targetName: - type: string - enum: - - LowULRANUEThptRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/LowULRANUEThptContext' - LowULRANUEThptContext: - description: >- - This data type is the "TargetContext" data type with specialisations for LowULRANUEThptContext.It describes the threshold - for the low UL RAN UE throughput cells (see average UL RAN UE throughput in gNB and distribution of UL UE throughput in gNB - in TS 28.552[6]) of the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - LowULRANUEThptThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: number - LowDLRANUEThptRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for LowDLRANUEThptRatioTarget. It describes - the low DL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied.The numerator - is the number of the cells with low DL RAN UE throughput, and the denominator is the total number of cells of the - RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - LowDLRANUEThptRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/LowDLRANUEThptContext' - LowDLRANUEThptContext: - description: >- - This data type is the "TargetContext" data type with specialisations for LowDLRANUEThptContext.It describes the threshold - for the low DL RAN UE throughput cells ((see average DL RAN UE throughput in gNB and distribution of DL UE throughput in gNB - in TS 28.552[6]) ) of the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - LowDLRANUEThptThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: number - HighULPrbLoadRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for HighULPrbLoadRatioTarget. It describes the high UL - PRB load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number - of the cells with high UL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - HighULPrbLoadRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/HighULPrbLoadContext' - HighULPrbLoadContext: - description: >- - This data type is the "TargetContext" data type with specialisations for HighULPrbLoadContext.It describes the threshold for high - uplink PRB load (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN - SubNetwork in the specified area that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - HighULPrbLoadThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: integer - minimum: 0 - maximum: 100 - HighDLPrbLoadRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for HighDLPrbLoadRatioTarget.It describes the high DL PRB - load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the - cells with high DL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - HighDLPrbLoadRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/HighDLPrbLoadContext' - HighDLPrbLoadContext: - description: >- - This data type is the "TargetContext" data type with specialisations for HighDLPrbLoadContext.It describes the threshold for high downlink - PRB load (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) of the cells of the RAN SubNetwork in the - specified area that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - HighDLPrbLoadThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: integer - minimum: 0 - maximum: 100 - AveULPrbLoadTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for AveULPrbLoadTarget.It describes the average uplink PRB load target - (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN SubNetwork that the intent - expectation is applied. - type: object - properties: - targetName: - type: string - enum: - - AveULPrbLoad - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - AveDLPrbLoadTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for AveDLPrbLoadTarget.It describes the average dowlink PRB load - (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) target for RAN SubNetwork that the intent expectation - is applied. - type: object - properties: - targetName: - type: string - enum: - - AveDLPrbLoad - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - RANEnergyConsumptionTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for RANEnergyConsumptionTarget.It describes the RAN energy consumption - target for RAN SubNetwork that the intent expectation is applied. The definition for RAN energy consumption see ECNG-RAN in clause 6.7.3.4.1 in - TS 28.554 [11]. - type: object - properties: - targetName: - type: string - enum: - - RANEnergyConsumption - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - RANEnergyEfficiencyTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for RANEnergyEfficiencyTarget.It describes the RAN energy efficiency target - for RAN SubNetwork that the intent expectation is applied. The unit of this target is bit/J. The definition for RAN energy efficiency target for RAN - SubNetwork see EEMN,DV in clause 6.7.1.1 in TS 28.554 [11]. - type: object - properties: - targetName: - type: string - enum: - - RANEnergyEfficiency - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - type: integer - ActiveUEsNumTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for ActiveUEsNumTarget. - It describes the number of Active UEs for the specified areas. This target is related to Mean - number of Active UEs in the DL per cell and Mean number of Active UEs in the UL per cell defined - in 3GPP TS 28.552 [6]. - type: object - properties: - targetName: - type: string - enum: - - ActiveUEsNum - targetCondition: - type: string - enum: - - IS_WITHIN_RANGE - targetValueRange: - type: array - description: >- - a pair of integer values to represent minimum number of active UEs and maximum number of active UEs. - items: - type: integer - minItems: 1 - maxItems: 2 - PRBsTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for PRBsTarget. - It describes total available number of physical resource blocks (PRBs). This target is equal to the difference between the DL total available PRB plus UL total available PRB of operator A and the DL total available PRB plus UL total available PRB of operator B. DL total available PRB and UL total available PRB defined in clause 5.1.1.2.6 and 5.1.1.2.8 of TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - pRBS - targetCondition: - type: string - enum: - - IS_EQUAL_TO - targetValueRange: - type: integer - InterRAThandoverTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for PRBsTarget. - it shows how often a handover from 5GS to EPS is successful. The InterRAThandover target is equal to the difference between 5GS to EPS handover success rate of operator A and 5GS to EPS handover success rate of operator B. For details see attribute 5GS to EPS handover success rate defined in clause 6.6.4 of TS 28.554 [11]. - type: object - properties: - targetName: - type: string - enum: - - InterRATHandover - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - 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 - 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 - MaxNumberofUEsTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofUEsTarget.It describes the the number of UEs for edge service supporting - that the intent expectation is applied. For details see attribute maxNumberofUE defined in clause 6.3.1 of of TS 28.541 [5] - type: object - properties: - targetName: - type: string - enum: - - maxNumberofUEs - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - ActivityFactorTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for ActivityFactorTarget.It describes the percentage value of the amount of simultaneous - active UEs to the total number of UEs where active means the UEs are exchanging data with the edge service supporting that the intent expectation is applied. - For details see activityFactor in clause 6.3.1 in TS 28.541 [5]. - type: object - properties: - targetName: - type: string - enum: - - activityFactor - targetCondition: - type: string - enum: - - IS_EQUAL_TO - targetValueRange: - type: integer - UESpeedTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for UESpeedTarget.It describes the speed (in km/hour) supported for edge service supporting - that the intent expectation is applied. For details see uESpeed in clause 6.3.1 in TS 28.541[5]. - type: object - properties: - targetName: - type: string - enum: - - uESpeed - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - MaxNumberofPDUsessionsTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofPDUsessionsTarget.It describes the maximum number of PDU sessions for 5GC - SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofPDUsessions in clause 5.3.1.2 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - MaxNumberofPDUsessions - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - targetContexts: - $ref: '#/components/schemas/5GSessionContext' - 5GSessionContext: - description: >- - This data type is the "TargetContext" data type with specialisations for 5GSessionContext.It describes the maximum supported 5G PDU session of the 5GC SubNetwork - related to the intent expectation. - type: object - properties: - contextAttribute: - type: string - enum: - - 5GSession - contextCondition: - type: string - enum: - - IS_less_THAN - contextValueRange: - type: integer - MaxNumberofRegisteredsubscribersTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofRegisteredsubscribersTarget.It describes the maximum number of Registered - subscribers for 5GC SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofRegisteredsubscribers in clause 5.6.2 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - MaxNumberofRegisteredsubscribers - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - IncomingDataTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for IncomingDataTarget.It describes the maximum incoming data packets for 5GC SubNetwork - related to the intent expectation. For details, see N6 incoming link usage measurement in clause 5.4.2.1 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - IncomingData - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - OutgoingDataTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for OutgoingDataTarget.It describes the maximum outgoing data packets for 5GC SubNetwork - related to the intent expectation. For details, see N6 outgoing link usage measurement in clause 5.4.2.2 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - OutgoingData - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - MaintenanceVersionTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for Maintenance Version Target. It describes the maintenance version target for the network maintenance, such as target version of the maintenance object after maintenance. - type: object - properties: - targetName: - type: string - enum: - - MaintenanceVersion - targetCondition: - type: string - enum: - - IS_EQUAL_TO - targetValueRange: - type: string - - #-------Definition of the concrete ExpectationTarget dataType----------# - - #-------Definition of the concrete ObjectTarget dataType----------------# - CoverageAreaPolygonContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CoverageAreaPolygonContext.It describes the coverage areas for the RAN SubNetwork that the - intent expectation is applied in the form of polygon. - type: object - properties: - contextAttribute: - type: string - enum: - - CoverageAreaPolygon - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' - CoverageTACContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CoverageTACContext.It describes the coverage areas for the RAN SubNetwork that the intent - expectation is applied in the form of TAC. - type: object - properties: - contextAttribute: - type: string - enum: - - CoverageAreaTac - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Tac" - CellContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CellContext. - It describes the coverage areas for the RAN SubNetwork or Radio Service that the intent expectation is applied - in the form of a list of cells (including E-UTRAN cells identified by E-UTRAN-CGI and NR cells - identified by NG-RAN CGI). - type: object - properties: - contextAttribute: - type: string - enum: - - Cell - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - items: - $ref: "#/components/schemas/CellId" - CellId: - oneOf: - - $ref: 'TS28623_ComDefs.yaml#/components/schemas/EutraCellId' - - $ref: 'TS28623_ComDefs.yaml#/components/schemas/NrCellId' - TimeBasedAreaContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for TimeBasedAreaContext. - It describes the areas for specific times for the RAN SubNetwork that the intent expectation is - applied in the form of a list. - type: object - properties: - contextAttribute: - type: string - enum: - - TimeBasedArea - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - items: - $ref: "#/components/schemas/TimeBasedArea" - TimeBasedArea: - type: object - properties: - geoArea: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' - timeWindow: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' - PLMNContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for PLMNContext - type: object - properties: - contextAttribute: - type: string - enum: - - PLMN - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' - 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' - DlFrequencyContext: - description: >- - This data type is the "Context" data type with specialisations for Object context "DLFrequencyContext". It describes the downlink frequency information (RF reference - frequencies and/ or the frequency operating band) supported by the RAN SubNetwork or Radio Service that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - DlFrequency - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' - UlFrequencyContext: - description: >- - This data type is the "Context" data type with specialisations for Object context "ULFrequencyContext".It describes the uplink frequency information (RF reference - frequencies and/ or the frequency operating band) supported by the RAN SubNetwork or Radio Service that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - UlFrequency - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' - RATContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for RATContext.It describes the RAT supported by the RAN SubNetwork that the intent expectation - is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - RAT - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - enum: - - UTRAN - - EUTRAN - - NR - UEGroupContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for UEGroup([5QI, SNSSAI, pLMNId]) - type: object - properties: - contextAttribute: - type: string - enum: - - UEGroup - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/UEGroup" - EdgeIdentificationIdContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationIdContext - type: object - properties: - contextAttribute: - type: string - enum: - - edgeIdentificationId - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - type: string - EdgeIdentificationLocContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationLocContext - type: object - properties: - contextAttribute: - type: string - enum: - - edgeIdentificationTarget - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoCoordinate' - CoverageAreaTAContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CoverageAreaTAContext - type: object - properties: - contextAttribute: - type: string - enum: - - coverageAreaTA - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Tac' - NfTypeContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for NfTypeContext - type: object - properties: - contextAttribute: - type: string - enum: - - NfType - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28541_5GcNrm.yaml#/components/schemas/NFType' - NfInstanceLocationContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for NfInstanceLocationContext - type: object - properties: - contextAttribute: - type: string - enum: - - NfInstanceLocation - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - TaiContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for TaiContext - type: object - properties: - contextAttribute: - type: string - enum: - - Tai - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tai' - ServingScopeContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for ServingScopeContext - type: object - properties: - contextAttribute: - type: string - enum: - - ServingScope - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - DnnContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for DnnContext - type: object - properties: - contextAttribute: - type: string - enum: - - Dnn - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - MaintenanceVersionContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for MaintenanceVersionContext. It describes the scope of the maintenance objects based on software version. - type: object - properties: - contextAttribute: - type: string - enum: - - swVersion - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - items: - type: string - MaintenanceOrderContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for MaintenanceOrderContext. It describes describes the list of DNs for NFs/NEs based on their order for maintenance. - type: object - properties: - contextAttribute: - type: string - enum: - - maintenanceOrder - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - items: - type: string - MaintenanceTypeContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for MaintenanceTypeContext. It describes the type of maintenance expected for the maintenance object. - type: object - properties: - contextAttribute: - type: string - enum: - - maintenanceType - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - type: array - uniqueItems: true - items: - type: string - enum: - - UPGRADE - - DOWNGRADE - #-------Definition of the scenario specific ObjectTarget dataType----------------# - - #-------Definition of the concrete ExpectationContext dataType----------------# - - TargetAssuranceTimeContext: - description: >- - This data type is the "Expectation Context" data type with specialisations for TargetAssuranceTimeContext.It describes the timeWindows - (including startTime, endTime) when the targets in the Intent Expectation need to be assured. - type: object - properties: - contextAttribute: - type: string - enum: - - TargetAssuranceTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' - - ServiceStartTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ServiceStartTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - ServiceStartTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' - ServiceEndTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ServiceEndTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - ServiceEndTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' - UEMobilityLevelContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for UEMobilityLevelContext - type: object - properties: - contextAttribute: - type: string - enum: - - UEMobilityLevel - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/MobilityLevel" - ResourceSharingLevelContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ResourceSharingLevelContext - type: object - properties: - contextAttribute: - type: string - enum: - - ResourceSharingLevel - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/SharingLevel" - 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: - $ref: "TS28541_NrNrm.yaml#/components/schemas/Sst" - SchedulingTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for SchedulingTimeContext.It describes - the scheduled times (including one-time interval, daily periodicity, weekly periodicity or monthly periodicity) - for the IntentObject that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - schedulingTime - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - $ref: "TS28623_GenericNrm.yaml#/components/schemas/SchedulingTime" - StartTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for StartTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - StartTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' - MaintenanceTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for MaintenanceTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - MaintenanceTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' - #-------Definition of the concrete ExpectionContext dataType----------------# -- GitLab From ddc5ca379310680e367e8c121c5254dd4db63b7c Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:45:23 +0000 Subject: [PATCH 10/13] Replace TS28541_5GcNrm.yaml --- OpenAPI/TS28541_5GcNrm.yaml | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/OpenAPI/TS28541_5GcNrm.yaml b/OpenAPI/TS28541_5GcNrm.yaml index c937d623..7036240f 100755 --- a/OpenAPI/TS28541_5GcNrm.yaml +++ b/OpenAPI/TS28541_5GcNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: 3GPP 5GC NRM - version: 20.2.0 + version: 20.3.0 description: >- OAS 3.0.1 specification of the 5GC NRM © 2026, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -1808,7 +1808,16 @@ components: roamingExchange: type: boolean default: false - + hostingADRF: + type: boolean + default: false + mlModelAccuracyChecking: + type: boolean + default: false + analyticsAccuracyChecking: + type: boolean + default: false + MlAnalyticsInfo: description: ML Analytics Filter information supported by the Nnwdaf_MLModelProvision service type: object @@ -5095,6 +5104,10 @@ components: type: boolean roamingData: type: boolean + maximumLifetime: + type: integer + maximumStorage: + type: integer - type: object properties: -- GitLab From 0652c96feec4ec8fb61e26b72d766bcfd3638d64 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:45:37 +0000 Subject: [PATCH 11/13] Replace TS28561_NdtNrm.yaml --- OpenAPI/TS28561_NdtNrm.yaml | 83 ++++++++++++++++++++++++++++++++++--- 1 file changed, 77 insertions(+), 6 deletions(-) diff --git a/OpenAPI/TS28561_NdtNrm.yaml b/OpenAPI/TS28561_NdtNrm.yaml index 605cb1a9..f4e47e7a 100644 --- a/OpenAPI/TS28561_NdtNrm.yaml +++ b/OpenAPI/TS28561_NdtNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: NDT NRM - version: 19.2.0 + version: 20.0.0 description: >- OAS 3.0.1 definition of the NDT NRM © 2026, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -37,10 +37,19 @@ components: description: >- It indicates the different types of NDT application use cases which the NDT is capable of undertaking.. New values can be added to this list in future releases to support new use cases. + collaborationSupport: + type: boolean + default: false nDTFunctionScope: $ref: '#/components/schemas/NDTFunctionScope' + supportedExternalDataList: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' nDTFunctionRefList: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' + genericModellingCapabilities: + $ref: '#/components/schemas/GenericModellingCapability' + description: >- + It represents the generic modelling capabilities of the NDT Function. NDTJob-Single: description: >- @@ -60,14 +69,16 @@ components: $ref: '#/components/schemas/NDTInputDescription' nDTJobExecutionRequirements: $ref: '#/components/schemas/NdtJobExecutionReqts' - collaboratingNDT: - description: >- - It indicates the related NDT Job contributing as a collaborator to the executed NDT Job. It describes the DN of the collaborated NDT Job - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo' + reportingMethod: + $ref: '#/components/schemas/ReportingMethod' + ndtDataGeneration: + $ref: '#/components/schemas/DataGeneration' nDTReportRefList: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo' nDTJobRefList: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo' + externalDataTypeRefList: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' NDTReport-Single: description: >- This IOC represents the properties of an NDT report corresponding to an NDT job @@ -82,6 +93,15 @@ components: items: $ref: '#/components/schemas/NDTOutputDataPoint' description: It indicates the list of NDTOutput(s) that are provided by the NDT function as the output for any task executed in an instantiated NDT job. + nDTCollaborationInfoList: + type: array + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo' + nDTDaenumtaGenEnaInfo: + type: string + enum: + - AIML_BASED + - NON_AIML_BASED nDTJobRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' @@ -97,7 +117,8 @@ components: - NETWORK_CONFIGURATIONS_VERIFICATION - AUTOMATION_CONFIGURATION_VERIFICATION - ML_TRAINING_DATA_GENERATION - - USER_EXPERIENCE_DATA_GENERATION + - USER_EXPERIENCE_DATA_GENERATION + - PERFORMANCE_PREEVALUATION NDTFunctionScope: type: object properties: @@ -208,6 +229,56 @@ components: performanceDataScalingFactor: type: integer maxItems: 1 + GenericModellingCapability: + type: object + properties: + enviromentModelling: + type: boolean + default: false + uETrafficModelling: + type: string + enum: + - FIXEDUEMODEL + - MOVINGUEMODEL + - DISTRIBUTEDUEMODEL + serviceModelling: + enum: + - URLLC + - EMBB + - MMTC + + ReportingMethod: + type: string + enum: + - STREAMING + - NOTIFICATION + DataGeneration: + type: object + properties: + nDTDataGenObject: + type: array + uniqueItems: true + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + dataGenType: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/SimulationData' + dataGenTimeWindow: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + dataGenQuantity: + $ref: '#/components/schemas/DataGenQuantity' + DataGenQuantity: + type: object + oneOf: + - required: [ numberOfData ] + - required: [ dataGenPeriod ] + properties: + numberOfData: + type: integer + dataGenPeriod: + type: integer #------Definition of JSON arrays for name-contained IOCs ---------------# -- GitLab From f68402f10391b257c5553f77d07375aeb77af330 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:45:52 +0000 Subject: [PATCH 12/13] Replace TS28567_CclNrm.yaml --- OpenAPI/TS28567_CclNrm.yaml | 41 ++++++++++++++++++++++++++++++++----- 1 file changed, 36 insertions(+), 5 deletions(-) diff --git a/OpenAPI/TS28567_CclNrm.yaml b/OpenAPI/TS28567_CclNrm.yaml index f8f6c70d..5d807309 100644 --- a/OpenAPI/TS28567_CclNrm.yaml +++ b/OpenAPI/TS28567_CclNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: CCL NRM - version: 19.1.0 + version: 20.0.0 description: >- OAS 3.0.1 definition of the CCL NRM © 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -109,7 +109,7 @@ components: faultManagementAlarmIdList: type: array items: - type: string + $ref: '#/components/schemas/AlarmRef' faultManagementBackUpObjectRequirement: type: boolean faultManagementIsolateObjectRequirement: @@ -118,8 +118,28 @@ components: $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' clearUserId: type: string - -#-------Definition of the generic dataType --------------# + NetworkCapacityOptimization: + description: This IOC represents the Fault Management CCL purpose. + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + mFInstantiation: + $ref: '#/components/schemas/ManagedObjectCapacityOptimization' + mFTermination: + $ref: '#/components/schemas/ManagedObjectCapacityOptimization' + mFUpdate: + $ref: '#/components/schemas/ManagedObjectCapacityOptimization' +#-------Definition of the generic dataType --------------# + ManagedObjectCapacityOptimization: + type: object + properties: + targetManagementData: + type: string + targetDataValue: + type: string + targetParameters: + type: string CCLComponentsInfo: type: object properties: @@ -151,7 +171,7 @@ components: generatedAlarmResultList: type: array items: - type: string + $ref: '#/components/schemas/GeneratedAlarmResult' faultManagementCCLReportTime: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' @@ -168,6 +188,8 @@ components: type: array items: type: string + alarmListRef: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' CCLScopeCoordinationCapability: type: object @@ -200,6 +222,15 @@ components: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' cCLGoalBreachPercentage: type: integer + + AlarmRef: + type: object + properties: + alarmListRef: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + alarmId: + type: string + #-------Definition of the generic dataType --------------# -- GitLab From fc854236a5ebee81c64e3910fef083994bc6f256 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Sun, 21 Jun 2026 02:54:44 +0000 Subject: [PATCH 13/13] Replace README.md --- OpenAPI/README.md | 73 +++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 68 insertions(+), 5 deletions(-) diff --git a/OpenAPI/README.md b/OpenAPI/README.md index 8be2519a..19cd903f 100644 --- a/OpenAPI/README.md +++ b/OpenAPI/README.md @@ -1,12 +1,51 @@ # 3GPP SA5 models and MnS OpenAPI definitions -(c) 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. +(c) 2026, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. The links below will open the Swagger Editor/UI and auto-load the OpenAPI YAML file of each API: -## Network Resource Models (NRM) +## Overview of management capabilities and corresponding openAPI definitions + +| Management Feature | Management Capability | MnS definition | OpenAPI definition | +|:------|:------|:------|:------| +| Network and network slicing management | NR Provisioning|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NR NRM fragment ([3GPP TS 28.541](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3400)) | [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28541_NrNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28541_NrNrm.yaml)| +| | 5GC Provisioning|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + 5GC NRM fragment ([3GPP TS 28.541](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3400)) | [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28541_5GcNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28541_5GcNrm.yaml)| +| | Network Slicing Provisioning |CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + 5GC NRM fragment ([3GPP TS 28.541](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3400)) | [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28541_SliceNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28541_SliceNrm.yaml)| +| | Network Slicing Provisioning|Network slicing provisioning service ([3GPP TS 28.531](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3274))| [TS28531_NSProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28531_NSProvMnS.yaml)
[TS28531_NSSProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28531_NSSProvMnS.yaml)| +|Edge Computing Management|Edge Computing Management|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Edge NRM fragment ([3GPP TS 28.538](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3910))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28538_EdgeNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28538_EdgeNrm.yaml)| +|Performance Assurance |Performance Metric Collection Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + PM control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_PmControlNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_PmControlNrm.yaml)| +| |Performance Metric Collection Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + ManagementDataCollection control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_ManagementDataCollectionNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_ManagementDataCollectionNrm.yaml)| +| |Performance Metric Data Report|Streaming data reporting service ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Performance data stream units ([3GPP TS 28.550](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3411))| [TS28532_StreamingDataMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_StreamingDataMnS.yaml)| +| |Performance Metric Threshold Monitor Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Threshold monitoring control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_ThresholdMonitorNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_ThresholdMonitorNrm.yaml)| +| |Performance Metric Threshold Notification|notifyThresholdCrossing notification ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427))| [TS28532_PerfMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_PerfMnS.yaml)| +|Fault Management |Fault control |CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + FM control NRM fragment ([3GPP TS 28.111](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4178))|[TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28111_FaultNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28111_FaultNrm.yaml)| +| |Fault Notification |CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + FM control NRM fragment ([3GPP TS 28.111](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4178))|[TS28111_FaultNotifications.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28111_FaultNotifications.yaml)| +|Trace and MDT management |Trace/MDT data collection control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Trace control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))|[TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_TraceControlNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_TraceControlNrm.yaml)| +| |Trace/MDT data report |Streaming data reporting service ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Trace/MDT stream date schema definition ([3GPP TS 32.423](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=2010))|[TS28532_StreamingDataMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_StreamingDataMnS.yaml)| +| |Trace/MDT data report|File data reporting service ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Trace/MDT file date format definition ([TS 32.423](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=2010))|[TS28532_FileDataReportingMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_FileDataReportingMnS.yaml)| +|QoE management |QoE data collection control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + QoE Measurement Collection control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541)|[TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_QoEMeasurementCollectionNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_QoEMeasurementCollectionNrm.yaml)| +| |QoE data report|File data reporting service ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + QoE data file format ([3GPP TS 26.247](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1444))|[TS28532_FileDataReportingMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_FileDataReportingMnS.yaml)| +|Plan management|Configuration plan management|Information model for configuration plan management ([3GPP TS 28.572](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4363))|[TS28572_PlanManagement.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_FileDataReportingMnS.yaml)| +|Notification subscription and Heartbeat notification control |Subscription Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Notification subscription and heartbeat notification control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))|[TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_SubscriptionControlNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_SubscriptionControlNrm.yaml)| +| |Heartbeat Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Heartbeat notification control NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))|[TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_SubscriptionControlNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_SubscriptionControlNrm.yaml)| +| |Heartbeat Notification |notifyHeartbeat notification ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427))|[TS28532_HeartbeatNtf.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_HeartbeatNtf.yaml)| +|MDA|Management Data Analytic|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NRM fragment for MDA request and MDA report ([3GPP TS 28.104](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3877))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28104_MdaNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28104_MdaNrm.yaml)
[TS28104_MdaReport.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28104_MdaReport.yaml)| +|SON|RANSC Management|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + RANSC NRM Fragment [3GPP TS 28.317](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3959))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28317_RanScNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28317_RanScNrm.yaml) | +||SON policy|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NRM Fragment for DANR/DES/DRACH/DMRO/DPCI/CES/CPCI/DLMO/CCO Management ([3GPP TS 28.541](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3400) )| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28541_NrNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28541_NrNrm.yaml) | +|Closed-loop |Communication Service Assurance Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + Assurance management NRM fragment ([3GPP TS 28.536](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3701))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28536_CoslaNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28536_CoslaNrm.yaml) | +| |Closed control loop management|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NRM fragment for CCL management ([3GPP TS 28.567](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4382))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28567_CclNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28567_CclNrm.yaml) | +|Intent driven management|Intent Driven Management|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NRM fragment for intent driven management ([3GPP TS 28.312](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3554))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28312_IntentNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_IntentNrm.yaml)
[TS28312_RadioNetworkExpectation.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_RadioNetworkExpectation.yaml)
[TS28312_RadioServiceExpectation.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_RadioServiceExpectation.yaml)
[TS28312_NetworkMaintenanceExpectation.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml)
[TS28312_5GCNetworkExpectation.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_5GCNetworkExpectation.yaml)
[TS28312_EdgeServiceSupportExpectation.yamll](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml)| +|AI/ML management|ML model Management|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NRM fragment for ML model training/testing/ inference emulation control/ ML model loading / inference ([3GPP TS 28.105](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3970))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28105_AiMlNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28105_AiMlNrm.yaml) | +|NDT management|NDT Lifecycle Management|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + NRM fragment for NDT management ([3GPP TS 28.561](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4384))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28561_NdtNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28561_NdtNrm.yaml) | +|MnS Registry and Discovery|MnS Registry and Discovery|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + MnS Registry NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_MnSRegistryNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_MnSRegistryNrm.yaml) | +| |MgmtData Registry and Discovery|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + MnS Registry NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_MnSRegistryNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_MnSRegistryNrm.yaml) | +|MSAC|MnS Access Control|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427) ) + Information model for role based access control ([3GPP TS 28.319](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4283))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28319_MsacNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28319_MsacNrm.yaml) | +|NSOEU|DSO Rapid Recovery and Threshold Monitoring|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427))+ DSO Rapid Recovery NRM fragment ([3GPP TS 28.318](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4192)) + DSO Rapid Recovery NRM fragment([3GPP TS 28.318](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=4192))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28318_DsoNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28318_DsoNrm.yaml) | +|External Data Management|External Data Discovery and Request|CRUD operations/notifications ([3GPP TS 28.532](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427)) + External data type NRM fragment ([3GPP TS 28.622](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541))| [TS28532_ProvMnS.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28532_ProvMnS.yaml)
[TS28623_ExternalDataMgmtNrm.yaml](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_ExternalDataMgmtNrm.yaml) | + +## Network Resource Models (NRM) * Generic NRM (TS 28.623) ([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28623_GenericNrm.yaml)) ([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28623_GenericNrm.yaml)) @@ -83,9 +122,30 @@ The links below will open the Swagger Editor/UI and auto-load the OpenAPI YAML f ([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_IntentNrm.yaml)) ([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_IntentNrm.yaml)) -* Intent Scenario specific Intent Expectations (TS 28.312) -([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_IntentExpectations.yamll)) -([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_IntentExpectations.yaml)) +* RadioNetworkExpectation NRM (TS 28.312) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_RadioNetworkExpectation.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_RadioNetworkExpectation.yaml)) + +* RadioServiceExpectation NRM (TS 28.312) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_RadioServiceExpectation.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_RadioServiceExpectation.yaml)) + +* NetworkMaintenanceExpectation NRM (TS 28.312) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_NetworkMaintenanceExpectation.yaml)) + +* 5GCNetworkExpectation NRM (TS 28.312) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_5GCNetworkExpectation.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_5GCNetworkExpectation.yaml)) + +* EdgeServiceSupportExpectation NRM (TS 28.312) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28312_EdgeServiceSupportExpectation.yaml)) + +* NDT NRM (TS 28.561) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28561_NdtNrm.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28561_NdtNrm.yaml)) + * Edge NRM (TS 28.538) ([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28538_EdgeNrm.yaml)) @@ -145,6 +205,9 @@ The links below will open the Swagger Editor/UI and auto-load the OpenAPI YAML f ([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28531_NSSProvMnS.yaml)) ([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28531_NSSProvMnS.yaml)) +* Plan Provisioning Management (TS 28.572) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=OpenAPI/TS28572_PlanManagement.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=OpenAPI/TS28572_PlanManagement.yaml)) ## Tools * [Frontend](https://forge.3gpp.org/swagger/tools/GitlabOpenAPIFrontend.htm) to invoke the Swagger Editor, Swagger UI, or to parse OpenAPI files with APIDevTools Swagger Parser/Validator, or to search for APIs referencing a data structure -- GitLab