6.2 Information model definition for Intent (MnS component typeB)

28.3123GPPIntent driven management services for mobile networksManagement and orchestrationTS

6.2.1 Information model definition for Intent

Editor’s Note: The following information model needs to be revisited based on the further discussion, and the alignment/coordination work with other SDO needs to be considered, which may impact the following information model.

6.2.1.1 Class diagram

6.2.1.1.1 Relationship

Figure 6.2.1.1.1-1 Relationship UML diagram for intent

Note: Above XOR means an instance of Context can only be name contained by either the Intent, IntentExpectation or IntentTarget.

Editor’s Note: The detailed model for Intent, IntentReport and IntentExpectation objects (e.g. is it <<IOC>>, <<DataType>>, or string) is FFS as their relationship needs to be decided later based on the content of these three objects 6.2.1.1.2 Inheritance

Editor’s Note: whether using the context or constraint is FFS, which needs to discuss together with intent definition.”

Editor’s Note: the relationship related to context in above figure need further study

Figure 6.2.1.1.2-1 Inheritance UML diagram for intent

6.2.1.2 Class definition

6.2.1.2.1 Intent <<IOC>>

6.2.1.2.1.1 Definition

This IOC represents the properties of an Intent. The Intent IOC contains one or multiple intentExpectation(s) which includes MnS consumer’s requirements, goals and constraints given to a 3GPP system.

The Intent IOC includes the attribute objectClass and objectInstance from the TOP IOC. The value of attribute objectClass is “Intent” and the value of attribute objectInstance is the DN of the instance of Intent IOC.

6.2.1.2.1.2 Attributes

The Intent includes attributes inherited from TOP IOC (defined in TS 28.622) and the following attributes:

Attribute Name	Support Qualifier	isReadable	isWritable	isInvariant	isNotifyable
intentExpectation	M	T	T	F	T
userLabel	M	T	T	F	T
intentContexts	O	T	T	F	T
intentFulfilStatus	M	T	F	F	T

Editor’s Note: whether other the attributes are needed for the Intent IOC needs further discussion.

6.2.1.2.1.3 Attribute constraints

None

6.2.1.2.2 IntentExpectation

6.2.1.2.2.1 Definition

IntentExpectation class represent MnS consumer’s requirements, goals and constraints given to a 3GPP system.

Editor’s Note: more description for IntentExpectation will be added later based on the further discussion.

6.2.1.2.2.2 Attributes

The IntentExpectation includes the following attributes:

Attribute Name	Support Qualifier	isReadable	isWritable	isInvariant	isNotifyable
expectationId	M	T	T	T	T
expectationObject	O	T	T	F	T
expectationObjectContexts	O	T	T	F	T
expectationTargets	O	T	T	F	T
expectationContexts	O	T	T	F	T

Note: The scenario/requirements-specific IntentExpectations are defined utilizing the constructs of this generic IntentExpectation model.

Editor’s Note: whether other the attributes are needed for the IntentExpectation IOC needs further discussion.

Editor’s Note: The naming of the terms may need further discussion.

Editor’s Note: whether both expectionObjectContexts and ExpetationTargets are mandatory is FFS.

6.2.1.2.2.3 Attribute constraints

TBD

6.2.1.2.3 IntentReport

6.2.1.2.3.1 Definition

IntentReport class represent intent fulfilment feedback information that MnS consumer can obtained from a 3gpp system.

Editor’s Note: more description for IntentReport will be added later based on the further discussion.

6.2.1.2.3.2 Attributes

TBD

6.2.1.2.3.3 Attribute constraints

TBD

6.2.1.2.4 IntentExpectation

6.2.1.2.4.1 Definition

Following Content for MnS’s expectation on a radio network is used as example to discuss the concrete model for IntentExpectation:

Editor’s Note: following content needs to be revisited based on further discussion for intent model, how to model IntentExpectation is FFS.

Following described the information/attributes for MnS Consumer’ s expectation to deliver/ensure on a radio network,

– ManagedObject, it describes the managed object (i.e. RadioNetwork) expressed by MnS’s expectation on a radio network.

– ExpectedAreas, it describes a list of coverage areas for radio network. This can be implemented by multiple choices, e.g. CoverageAreaPolygon, TrackingAreaCode.

– RANCoverageTarget, it describes the properties of coverage quality for the radio network, which includes:

– targetWeakRSRPRatioInfo, it describes the list of target Weak RSRP Ratio for the radio network. Each TargetWeakRSRPRatioInfo includes WeakRSRPRatio and WeakRSRPThreshold.

– targetLowSINRRatioInfos, it describes the list of target low SINR Ratio for the radio network. Each TargetLowSINRRatioInfo includes LowSINRThreshold and LowSINRRatio.

– RANCapacityTarget, it describes the properties of network capacity for the radio network, which includes：

– targetMaximumUENumber, it describes the maximum number of should be supported by the radio network

– targetActivityFactor, it describes the maximum number of should be supported by the radio network

– RANUEThptTarget, it describes the properties of the RAN UE throughput for the radio network, which includes:

– targetAveULRANUEThpt, it describes the average UL RAN UE throughput for the radio network

– targetAveDLRANUEthpt, it describes the average UL RAN UE throughput for the radio network

– targetLowULRANUEThptRatioInfos, it describes the list of target low uplink RAN UE throughput ratio for the network, which includes LowULRANUEThptRatio and LowULRANUEThptThreshold

– targetLowDLRANUEThptRatioInfos, it describes the list of target low downlink RAN UE throughput ratio for the radio network, which includes LowDLRANUEThptThreshold and LowDLRANUEThptRatio

– RANConstraint, it describes the properties of a set of constraints for the radio network, which includes:

– radioConstraints, it describes the properties of a set of radio constraints for the radio network, which includes cellIdRanges, gNBIdRanges, tACRanges, pLMNIdList and nRPCIRanges.

– frequencyConstraints, it describes the properties of a set of frequency constraints for radio network, which includes arfcnUL/DL and bSChannelBwUL/DL

– transportConstraints, it describes the properties of a set of transport constraints to be used in the radio network, including ngcLocalIpAddressList, nguRemoteIpAddressList, logicInterfaceId and nextHopInfo.

6.2.1.3 DataType definition

6.2.1.3.1 expectationTarget <<dataType>>

6.2.1.3.1.1 Definition

This <<dataType>> represents the Targets of the IntentExpectation that are required to be achieved .

6.2.1.3.1.2 Attributes

The expectationTarget includes the following attributes:

Attribute Name	Support Qualifier	isReadable	isWritable	isInvariant	isNotifyable
targetName	M	T	T	T	T
targetCondition	M	T	T	F	T
targetValueRange	M	T	T	F	T
targetContexts	O	T	T	F	T

6.2.1.3.1.3 Attribute constraints

None

6.2.1.3.2 context << dataType >>

6.2.1.3.2.1 Definition

This IOC represents the properties of a context. A context describes the list of constraints and conditions that should evaluate to True when the targets are fulfilled but are themselves not to be enforced. The context may apply to the intent, the intent expectation, the intent targets or to the object as filter information used to identify the manged objects to which the targets are intended.

6.2.1.3.2.2 Attributes

The context includes the following attributes:

Attribute Name	Support Qualifier	isReadable	isWritable	isInvariant	isNotifyable
contextAttribute	M	T	F	T	T
contextCondition	M	T	T	F	T
contextValueRange	M	T	T	F	T

6.2.1.3.2.3 Attribute constraints

None

6.2.1.4 Attribute definition

Attribute Name	Documentation and Allowed Values	Properties
userLabel	A user-friendly (and user assignable) name of the intent. allowedValues: Not Applicable	type: String multiplicity: 1 isOrdered: F isUnique: F defaultValue: None isNullable: False
intentExpectation	It indicates the expectations including requirements, goals and context (including constraints and filter information) given to a 3GPP system. It states the list of specific outcomes desired to be realized for a certain object	type: FFS multiplicity: * isOrdered: F isUnique: F defaultValue: None isNullable: False
intentFulfilStatus	It describes the current status of the intent fulfilment result, which is configured by MnS producer and can be read by MnS consumer. allowedValues: "FULFILLED", “NOT_FULFILLED Editor’s Note: whether other allowed values should be supported is FFS, and the name for the attribute intentFulfilStatus is FFS.	type: ENUM multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False
intentContext	It describes the list of constraints and conditions that should apply for the entire intent even if there may be specific constraints and conditions defined for specific parts of the intent. allowedValues: triple of (attribute, condition, value range)	type: Context multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
expectationId	A user-friendly (and user assignable) name of the intentExpectation. allowedValues: Not Applicable	type: String multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
expectionObject	expectation carries requirements (expectations, goals and constrains) on an expectationObject. expectionObject refers to an object (e.g. instance of managed object) to which the intentExpectation should apply. This means, which object the requirements specified by the expectation are meant for. expectionObject is optional.  allowedValues: NA	type: DN multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
expectionobjectContext	It describes the list of constraints and conditions to be used as filter information to identify the specific object to which a given intentExpectation should apply. Note there may be other constraints and conditions defined either for the entire intent, for the specific intentExpectation or for the expectationTarget of the considered intentExpectation. allowedValues: depends on Object in the IntentExpectation	type: Context multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
expectionTargets	It describes the list of specific outcomes on metrics and observables related to the Object (e.g. the metrics that characterize the performance of the object(s) or some abstract index that expresses the behavior of the object(s)) that are desired to be realized for a given intentExpectation. allowedValues: depends on Object in the IntentExpectation	type: expectationTarget multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
expectationContext	It describes the list of constraints and conditions that should apply for a specific intentExpectation. Note there may be other constraints and conditions defined for the entire intent or for specific parts of the intentExpectation. allowedValues: depends on Object in the IntentExpectation	type: Context multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
targetName	It describes a specific attribute of the object on which the outcomes are stated, either a configuration or observable of that object. The attributes may be a parameter, gauge, counter, KPI, weighted metric, etc. related to that object allowedValues: depends on Object in the IntentExpectation	type: string multiplicity: 1 isOrdered: False isUnique: False defaultValue: Null isNullable: True
targetCondition	It expresses the limits within which the targetName is allowed/supposed to be allowedValues: is equal to; is less than; is greater than; Note: Others conditions like "is within the range" or "is outside the range" can be expressed in terms of these basic conditions	type: enum multiplicity: upto 2 isOrdered: False isUnique: False defaultValue: "is equal to" isNullable: False
targetValueRange	It describes the range of values that applicable to the targetName and the TargetCondition.	type: FFS multiplicity: upto 2 isOrdered: False isUnique: False defaultValue: Null isNullable: True
targetContext	It describes the list of constraints and conditions that should apply for a specific expectationTarget. Note there may be other constraints and conditions defined for the entire intent or the intentExpectation. allowedValues: triple of (attribute, condition, value range)	type: Context multiplicity: 1 isOrdered: False isUnique: False defaultValue: None isNullable: False
contextAttribute	It describes a specific attribute of or related to the object or to characteristics thereof (e.g. its control parameter, gauge, counter, KPI, weighted metric, etc) to which the expectation should apply or an attribute related to the operating conditions of the object (such as weather conditions, load conditions, etc).	type: DN multiplicity: 1 isOrdered: False isUnique: False defaultValue: Null isNullable: True
contextCondition	It expresses the limits within which the ContextAttribute is allowed/supposed to be allowedValues: is equal to; is less than; is greater than; Note: Others conditions like "is within the range" or "is outside the range" can be expressed in terms of these basic conditions	type: enum multiplicity: upto 2 isOrdered: False isUnique: False defaultValue: "is equal to" isNullable: False
contextValueRange	It describes the range of values that explicatable to the ContextAttribute and the ContextCondition.	type: FFS multiplicity: upto 2 isOrdered: False isUnique: False defaultValue: Null isNullable: True