Merge branch 'Code_Moderator_rebase_Integration_Rel20_SA5_162_YAML' into 'Rel-20' (d9266e85) · Commits · SA5 – Management & Orchestration and Charging / Management and Orchestration APIs

OpenAPI/TS28104_MdaNrm.yaml

+3 −2

Original line number	Diff line number	Diff line
		openapi: 3.0.1
		info:
		title: MDA NRM
		version: 19.2.0
		version: 19.3.0
		description: >-
		OAS 3.0.1 specification of the MDA NRM
		© 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		@@ -24,6 +24,7 @@ components:
		- SLS_ANALYSIS_NETWORK_SLICE_TRAFFIC_ANALYSIS
		- SLS_ANALYSIS_E2E_LATENCY_ANALYSIS
		- SLS_ANALYSIS_NETWORK_SLICE_LOAD_ANALYSIS
		- UE_THROUGHPUT_ANALYSIS_TRAFFIC_CONGESTION_PROBLEM_ANALYSIS
		- SLS_ANALYSIS_EDGE_APPLICATION_DEPLOYMENT_LOCATION_ANALYSIS
		- SLS_ANALYSIS_EDGE_COMPUTING_PERFORMANCE_ANALYSIS
		- SLS_ANALYSIS_TRAFFIC_CONGESTION_PREDICTION_ANALYSIS
		@@ -37,7 +38,7 @@ components:
		- RESOURCE_ANALYTICS_PHYSICAL_RESOURCE_UTILIZATION_ANALYSIS_NF
		- RESOURCE_ANALYTICS_5GC_CONTROL_PLANE_CONGESTION_ANALYSIS
		- PREDICTIONS_PM_DATA
		- UE_THROUGHPUT_ANALYSIS_TRAFFIC_CONGESTION_PROBLEM_ANALYSIS
		- ATSSS_PERFORMANCE_TRAFFIC_STEERING_ANALYTICS
		- CORRELATION_ANALYTICS_TRAINING_DATA_ANALYSIS
		- CORRELATION_ANALYTICS_NF_SCALING_DIMENSIONING_DATA_ANALYSIS

OpenAPI/TS28104_MdaReport.yaml

+35 −6

Original line number	Diff line number	Diff line
		openapi: 3.0.1
		info:
		title: MDA Report
		version: 19.2.0
		version: 19.3.0
		description: >-
		OAS 3.0.1 specification of the MDA Report
		© 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		@@ -46,13 +46,14 @@ components:
		$ref: 'TS28104_MdaNrm.yaml#/components/schemas/MDAType'
		mDAOutputList:
		oneOf:
		- $ref: '#/components/schemas/CoverageProblemAnalysisoutput'
		- $ref: '#/components/schemas/MobilityPerformanceAnalysisoutput'
		- $ref: '#/components/schemas/CoverageProblemAnalysisOutput'
		- $ref: '#/components/schemas/MobilityPerformanceAnalysisOutput'
		- $ref: '#/components/schemas/TrainingDataAnalysisOutput'
		- $ref: '#/components/schemas/NFScalingDimensioningDataAnalysisOutput'
		- $ref: '#/components/schemas/PMDataOutput'
		- $ref: '#/components/schemas/FailurePredictionOutput'
		- $ref: '#/components/schemas/PagingOptimizationAnalysisOutput'
		- $ref: '#/components/schemas/TrafficCongestionProblemAnalysisOutput'
		- type: array
		uniqueItems: true
		items:
		@@ -146,7 +147,7 @@ components:


		#-------- Definition of specific MobilityPerformanceAnalysis MDAoutput -----------------------------
		MobilityPerformanceAnalysisoutput:
		MobilityPerformanceAnalysisOutput:
		type: object
		properties:
		mobilityPerformanceIssueIdentifier:
		@@ -162,7 +163,7 @@ components:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea'

		#-------- Definition of specific CoverageProblemAnalysis MDAoutput -----------------------------
		CoverageProblemAnalysisoutput:
		CoverageProblemAnalysisOutput:
		type: object
		properties:
		coverageProblemId:
		@@ -392,6 +393,34 @@ components:
		items:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow'

		#-------- Definition of specific UEThroughputAnalysis MDAoutput -----------------------------
		TrafficCongestionProblemAnalysisOutput:
		type: object
		properties:
		trafficCongestionId:
		type: string
		trafficCongestionType:
		type: string
		enum:
		- NON_REGULAR_TRAFFIC_CONGESTION
		- REGULAR_TRAFFIC_CONGESTION
		timeDuration:
		type: array
		items:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow'
		trafficCongestionAreas:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea'
		recommendedActions:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/RecommendedAction'
		severityLevel:
		type: string
		enum:
		- SLIGHT_CONGESTION
		- MODERATE_CONGESTION
		- SEVERE_CONGESTION

OpenAPI/TS28105_AiMlNrm.yaml

+322 −13

Original line number	Diff line number	Diff line
		openapi: 3.0.1
		info:
		title: AI/ML NRM
		version: 19.2.0
		version: 19.3.0
		description: >-
		OAS 3.0.1 specification of the AI/ML NRM
		© 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		@@ -76,7 +76,6 @@ components:
		managedActivationScope:
		$ref: '#/components/schemas/ManagedActivationScope'


		SupportedPerfIndicator:
		type: object
		properties:
		@@ -168,6 +167,11 @@ components:
		# FIXME, isOrder/isUnique both as True
		inferencePerformance:
		$ref: '#/components/schemas/ModelPerformance'
		inferenceExplanationInfo:
		type: array
		uniqueItems: true
		items:
		type: string
		outputResult:
		description: A map (list of key-value pairs) for Inference result name and it's value
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/AttributeNameValuePairSet'
		@@ -187,6 +191,249 @@ components:
		- NG_RAN_MOBILITY_OPTIMIZATION
		VSExtensionType:
		type: string
		DataStatisticalProperties:
		type: object
		properties:
		uniformlyDistributedTrainingData:
		type: boolean
		default: FALSE
		trainingDataWithOrWithoutOutliers:
		type: boolean
		default: FALSE
		DistributedTrainingExpectation:
		type: object
		properties:
		expectedTrainingTime:
		type: integer
		dataSplitIndication:
		type: boolean
		default: FALSE
		suggestedTrainingNodeList:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList'
		PotentialImpactInfo:
		type: object
		properties:
		impactedScope:
		$ref: '#/components/schemas/ManagedActivationScope'
		impactedPM:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/ImpactedPM'
		ImpactedPM:
		type: object
		properties:
		pMIdentifier:
		type: string
		readOnly: true

		MLKnowledge:
		type: object
		properties:
		mLKnowledgeName:
		type: string
		readOnly: true
		knowledgeType:
		type: string
		enum:
		- TABLE
		- STATISTIC
		- REGRESSION
		readOnly: true
		predictorResponseArray:
		# array of pair <String, String>
		type: array
		description: Array of pair <String, String>
		uniqueItems: true
		items:
		type: array
		description: Array of pair <String, String>
		minItems: 2
		maxItems: 2
		items:
		type: string

		EnvironmentScope:
		oneOf:
		#Choice_1.1 managedEntitiesScope
		- type: object
		properties:
		managedEntitiesScope:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList'
		#Choice_1.2 areaScope
		- type: object
		properties:
		areaScope:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea'
		#Choice 2 timeWindow
		- type: object
		properties:
		timeWindow:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow'
		#todo: stage 2 attribute definition missing

		SupportedLearningTechnology:
		type: object
		properties:
		learningTechnologyName:
		type: array
		uniqueItems: true
		items:
		type: string
		enum:
		- RL
		- FL
		- DL
		readOnly: true
		supportedRLEnvironment:
		description: Included when RL is supported.
		type: array
		uniqueItems: true
		items:
		type: string
		enum:
		- SIMULATION_ENVIRONMENTS
		- REAL_NETWORK_ENVIRONMENTS
		readOnly: true
		supportedFLRole:
		description: Included when FL is supported.
		type: array
		uniqueItems: true
		items:
		type: string
		enum: [FL_SERVER, FL_CLIENT]
		minItems: 1
		maxItems: 2
		readOnly: true
		supportedInferenceNameList:
		description: Types of inference the training technologies can be applied to.
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/AIMLInferenceName'
		minItems: 1
		readOnly: true

		RLRequirement:
		type: object
		properties:
		rLEnvironmentType:
		type: array
		uniqueItems: true
		items:
		type: string
		enum:
		- SIMULATION_ENVIRONMENTS
		- REAL_NETWORK_ENVIRONMENTS

		rLEnvironmentScope:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/EnvironmentScope'
		minItems: 1

		rLImpactedScope:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/EnvironmentScope'
		minItems: 1

		rLPerformanceRequirements:
		type: array
		uniqueItems: true
		items:
		$ref: 'TS28623_ThresholdMonitorNrm.yaml#/components/schemas/ThresholdInfo'

		ClusteringCriteria:
		type: object
		properties:
		performanceMetric:
		type: string
		taskType:
		type: string
		allowedClusterTrainingTime:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow'
		minItems: 1
		maxItems: 1
		preferredModelDiversity:
		type: string

		FLParticipationInfo:
		type: object
		additionalProperties: false
		properties:
		fLRole:
		type: string
		enum: [FL_SERVER, FL_CLIENT]
		readOnly: true
		isAvailableForFLTraining:
		type: boolean
		default: FALSE
		readOnly: true
		candidateFLClientRefList:
		description: >
		List of MLTrainingFunction DNs capable of acting as FL clients.
		Applicable when fLRole = FL_SERVER.
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList'

		FLRequirement:
		type: object
		additionalProperties: false
		properties:
		fLClientSelectionCriteria:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/FLClientSelectionCriteria'
		minItems: 1

		FLClientSelectionCriteria:
		type: object
		additionalProperties: false
		properties:
		minimumAvailableDataSamples:
		type: integer
		minimumAvailableTimeDuration:
		type: integer
		description: Minutes
		minimumInterimModelPerformance:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/ModelPerformance'
		servingGeoArea:
		type: array
		uniqueItems: true
		items:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea'
		clientRedundancy:
		type: boolean
		trainingDataWithOrWithoutOutliers:
		type: boolean
		default: FALSE
		uniformlyDistributedTrainingData:
		type: boolean
		default: FALSE
		required:
		- minimumAvailableDataSamples
		- minimumAvailableTimeDuration

		FLReportPerClient:
		type: object
		additionalProperties: false
		properties:
		clientRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'
		numberOfDataSamplesUsed:
		type: integer
		trainingTimeDuration:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow'
		modelPerformanceOnClient:
		type: array
		items:
		$ref: '#/components/schemas/ModelPerformance'

		#-------- Definition of types for name-containments ------
		SubNetwork-ncO-AiMlNrm:
		@@ -233,6 +480,20 @@ components:
		- $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr'
		- type: object
		properties:
		supportedLearningTechnology:
		$ref: '#/components/schemas/SupportedLearningTechnology'
		fLParticipationInfo:
		$ref: '#/components/schemas/FLParticipationInfo'
		mLKnowledge:
		$ref: '#/components/schemas/MLKnowledge'
		mLTrainingType:
		type: string
		enum:
		- INITIAL_TRAINING
		- PRE_SPECIALISED_TRAINING
		- RE_TRAINING
		- FINE_TUNING
		readOnly: true
		mLModelRepositoryRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		- $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO'
		@@ -262,6 +523,8 @@ components:
		properties:
		aIMLInferenceName:
		$ref: '#/components/schemas/AIMLInferenceName'
		fLRequirement:
		$ref: '#/components/schemas/FLRequirement'
		candidateTrainingDataSource:
		type: array
		uniqueItems: true
		@@ -282,14 +545,39 @@ components:
		uniqueItems: true
		items:
		$ref: '#/components/schemas/ModelPerformance'
		rLRequirement:
		$ref: '#/components/schemas/RLRequirement'
		cancelRequest:
		type: boolean
		suspendRequest:
		type: boolean
		trainingDataStatisticalProperties:
		$ref: '#/components/schemas/DataStatisticalProperties'
		distributedTrainingExpectation:
		$ref: '#/components/schemas/DistributedTrainingExpectation'
		mLKnowledgeName:
		type: string
		mLTrainingType:
		type: string
		enum:
		- INITIAL_TRAINING
		- PRE_SPECIALISED_TRAINING
		- RE_TRAINING
		- FINE_TUNING
		expectedInferenceScope:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/AIMLInferenceName'
		clusteringInfo:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/ClusteringCriteria'
		mLModelRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'
		mLModelCoordinationGroupRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'

		MLTrainingProcess-Single:
		allOf:
		@@ -315,6 +603,8 @@ components:
		default: FALSE
		trainingRequestRef: ## Figure 7.3a.1.1.1-1 has no such pointer
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'
		participatingFLClientRefList:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList'
		trainingReportRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		mLModelGeneratedRef:
		@@ -357,6 +647,12 @@ components:
		readOnly: true
		trainingRequestRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'
		fLReportPerClient:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/FLReportPerClient'

		trainingProcessRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		lastTrainingRef:
		@@ -448,7 +744,7 @@ components:
		type: boolean
		default: FALSE
		mLModelToLoadRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'

		MLModelLoadingPolicy-Single:
		allOf:
		@@ -484,11 +780,12 @@ components:
		type: boolean
		default: FALSE
		mLModelLoadingRequestRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'
		mLModelLoadingPolicyRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'
		loadedMLModelRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'
		uniqueItems: true

		MLModel-Single:
		allOf:
		@@ -524,6 +821,18 @@ components:
		items:
		$ref: '#/components/schemas/MLCapabilityInfo'
		minItems: 1
		mLTrainingType:
		type: string
		enum:
		- INITIAL_TRAINING
		- PRE_SPECIALISED_TRAINING
		- RE_TRAINING
		- FINE_TUNING
		readOnly: true
		inferenceScope:
		type: array
		items:
		$ref: '#/components/schemas/AIMLInferenceName'
		retrainingEventsMonitorRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'
		sourceTrainedMLModelRef:
		@@ -688,8 +997,6 @@ components:
		$ref: '#/components/schemas/MLModelLoadingProcess-Multiple'
		MLModelLoadingPolicy:
		$ref: '#/components/schemas/MLModelLoadingPolicy-Multiple'
		MLModel:
		$ref: '#/components/schemas/MLModel-Multiple'

		AIMLInferenceReport-Single:
		allOf:
		@@ -706,6 +1013,8 @@ components:
		items:
		$ref: '#/components/schemas/InferenceOutput'
		minItems: 1
		potentialImpactInfo:
		$ref: '#/components/schemas/PotentialImpactInfo'
		mLModelRefList:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'

OpenAPI/TS28111_FaultNotifications.yaml

+2 −3

Original line number	Diff line number	Diff line
		openapi: 3.0.1
		info:
		title: Fault Management Notifications
		version: 18.1.0
		version: 19.3.0
		description: >-
		OAS 3.0.1 definition of the Fault Supervision MnS
		© 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		© 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		All rights reserved.
		externalDocs:
		description: 3GPP TS 28.111; Fault Management
		@@ -35,7 +35,6 @@ paths:
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyNewAlarm'
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyNewSecAlarm'
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyClearedAlarm'
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyChangedAlarm'
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyChangedAlarmGeneral'
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyChangedSecAlarmGeneral'
		- $ref: 'TS28111_FaultNrm.yaml#/components/schemas/NotifyCorrelatedNotificationChanged'

OpenAPI/TS28111_FaultNrm.yaml

+224 −30

File changed.

Preview size limit exceeded, changes collapsed.