this presents the stage 3 for the current draftCR for Rel-19 (5c7f5e41) · Commits · SA5 – Management & Orchestration and Charging / Management and Orchestration APIs

OpenAPI/TS28105_AiMlNrm.yaml

+197 −5

Original line number	Diff line number	Diff line
		@@ -168,6 +168,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 +192,141 @@ 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
		items:
		$ref: '#/components/schemas/ImpactedPM'
		ImpactedPM:
		type: object
		properties:
		pMIdentifier:
		type: string
		readOnly: true
		MLKnowldge:
		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: >-
		A pair of DN, First is the DN of a CCL being coordinated represented,
		and Second is the DN of that CCL’s CCLScope
		minItems: 2
		maxItems: 2
		items:
		type: string
		EnvironmentScope:
		oneOf:
		- type: object
		#Choice_1.1 managedEntitiesScope
		#Choice_1.2 areaScope
		#Choice 2 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
		supportedEnvironment:
		type: array
		uniqueItems: true
		items:
		type: string
		enum:
		- SIMULATION_ENVIONMENTS
		- REAL_NETWORK_ENVIONMENTS
		readOnly: true
		supportedInferenceNameList:
		type: array
		uniqueItems: true
		items:
		$ref: '#/components/schemas/AIMLInferenceName'
		minItems: 1
		RLRequirement:
		type: object
		properties:
		rLEnvironmentType:
		type: array
		uniqueItems: true
		items:
		type: string
		enum:
		- SIMULATION_ENVIONMENTS
		- REAL_NETWORK_ENVIONMENTS
		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'
		preferredModelDiversity:
		type: string

		#-------- Definition of types for name-containments ------
		SubNetwork-ncO-AiMlNrm:
		@@ -233,6 +373,18 @@ components:
		- $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr'
		- type: object
		properties:
		supportedLearningTechnology:
		$ref: '#/components/schemas/SupportedLearningTechnology'
		mLKnowledge:
		$ref: '#/components/schemas/MLKnowldge'
		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'
		@@ -282,10 +434,35 @@ 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'
		mLModelCoordinationGroupRef:
		@@ -448,7 +625,7 @@ components:
		type: boolean
		default: FALSE
		mLModelToLoadRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'

		MLModelLoadingPolicy-Single:
		allOf:
		@@ -488,7 +665,7 @@ components:
		mLModelLoadingPolicyRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		loadedMLModelRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo'
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'

		MLModel-Single:
		allOf:
		@@ -524,6 +701,19 @@ 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
		uniqueItems: true
		items:
		$ref: '#/components/schemas/AIMLInferenceName'
		retrainingEventsMonitorRef:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn'
		sourceTrainedMLModelRef:
		@@ -706,6 +896,8 @@ components:
		items:
		$ref: '#/components/schemas/InferenceOutput'
		minItems: 1
		potentialImpactInfo:
		$ref: '#/components/schemas/PotentialImpactInfo'
		mLModelRefList:
		$ref: 'TS28623_ComDefs.yaml#/components/schemas/DnListRo'