Merge branch 'Integration_Rel19_SA5_158_YANG' into 'Rel-19' (2854e1d2) · Commits · SA5 – Management & Orchestration and Charging / Management and Orchestration APIs

yang-models/_3gpp-5g-common-yang-types.yang

+67 −1

Original line number	Diff line number	Diff line
		@@ -3,7 +3,6 @@ module _3gpp-5g-common-yang-types {
		namespace "urn:3gpp:sa5:_3gpp-5g-common-yang-types";
		prefix "types5g3gpp";


		import ietf-yang-types { prefix yang; }
		import _3gpp-common-yang-types { prefix types3gpp; }

		@@ -15,6 +14,8 @@ module _3gpp-5g-common-yang-types {
		TTA, TTC). All rights reserved.";
		reference "3GPP TS 28.541";

		revision 2024-11-01 { reference CR-1405; }
		revision 2024-10-06 { reference CR-1389; }
		revision 2024-05-24 { reference CR-1273 ; }
		revision 2023-09-18 { reference CR-1043 ; }
		revision 2023-05-10 { reference CR-0916; }
		@@ -22,6 +23,71 @@ module _3gpp-5g-common-yang-types {
		revision 2020-11-05 { reference CR-0412 ; }
		revision 2019-10-20 { reference "Initial version."; }

		grouping MappedCellIdInfoGrp {
		description "This data type represents the mapping relationship between
		Mapped Cell IDs and geographical areas (see clause 16.14.5 of TS 38.300";

		list ntnGeoArea {
		description "This attribute indicates a specific geographical location
		mapped to Mapped Cell ID(s).";
		min-elements 1;
		max-elements 1;
		key idx;
		leaf idx { type uint32; }
		uses types3gpp:GeoAreaGrp;
		}

		list mappedCellId {
		description "This attribute is in format of NCGI to indicate a fixed
		geographical area (See subclause 16.14.5 in TS 38.300)";
		min-elements 1;
		max-elements 1;
		key idx;
		leaf idx { type uint32; }
		uses NcgiGrp;
		}
		}

		grouping NcgiGrp {
		description "Represents the Ncgi datatype";

		list plmnId {
		description "This attribute represents a PLMN Identity.";
		min-elements 1;
		max-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses types3gpp:PLMNId ;
		}

		leaf nrCellId {
		type string;
		mandatory true;
		description "This attribute represents NR Cell Identity.
		It's a 36-bit string identifying an NR Cell Id as specified in
		clause 9.3.1.7 of TS 38.413, in hexadecimal representation. Each
		character in the string shall take a value of
		'0' to '9', 'a' to 'f' or 'A' to 'F' and shall represent 4 bits.
		The most significant character representing the 4 most significant
		bits of the Cell Id shall appear first in the string, and the
		character representing the 4 least significant bit of the
		Cell Id shall appear last in the string.

		Pattern: '^[A-Fa-f0-9]{9}$'

		Example:
		An NR Cell Id 0x225BD6007 shall be encoded as '225BD6007'.";
		}

		leaf nId {
		type string;
		mandatory true;
		description "Network Identity; Shall be present if PlmnIdNid identifies
		an SNPN (see clauses 5.30.2.3, 5.30.2.9, 6.3.4, and 6.3.8 in
		3GPP TS 23.501.";
		}
		}

		typedef NRTAC {
		type string;
		description "This holds the identity of the common Tracking Area Code

yang-models/_3gpp-5gc-nrm-amffunction.yang

+366 −24

Original line number	Diff line number	Diff line
		@@ -8,7 +8,9 @@ module _3gpp-5gc-nrm-amffunction {
		import _3gpp-common-yang-types { prefix types3gpp; }
		import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
		import ietf-inet-types { prefix inet; }
		import ietf-yang-types { prefix yang; }
		import _3gpp-common-top { prefix top3gpp; }
		import _3gpp-5gc-nrm-nfprofile { prefix nfp3gpp; }

		organization "3gpp SA5";
		contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
		@@ -17,16 +19,17 @@ module _3gpp-5gc-nrm-amffunction {
		TTA, TTC). All rights reserved.";
		reference "3GPP TS 28.541 5G Network Resource Model (NRM)";

		revision 2024-11-01 { reference CR-1405; }
		revision 2024-10-06 { reference CR-1389; }
		revision 2024-04-04 { reference CR-1139; }
		revision 2023-09-18 { reference CR-1043 ; }
		revision 2022-01-07 { reference CR-0643; }
		revision 2020-11-06 { reference CR-0412 ; }
		revision 2019-10-25 { reference "S5-194457 S5-193518"; }

		revision 2019-05-31 { reference "Ericsson refactoring."; }
		revision 2018-08-07 { reference "Initial revision"; }

		grouping GlobalRanNodeIDGrp{
		grouping NTNGlobalRanNodeIDGrp{

		list pLMNId {
		description "The PLMN Identifier is composed of
		@@ -116,14 +119,13 @@ module _3gpp-5gc-nrm-amffunction {
		}
		}

		grouping satelliteBackhaulInfo{
		grouping SatelliteBackhaulInfoGrp{
		description "Defines information related to satellite backhaul category
		and corresponding information of gNB.";
		reference "3GPP TS 23.501";

		list GlobalRanNodeID{
		list nTNGlobalRanNodeID{
		description "Unique identifier of an NG-RAN node.";
		uses GlobalRanNodeIDGrp;
		min-elements 1;
		max-elements 1;
		leaf GlobalRanNodeIDValue{
		@@ -131,6 +133,7 @@ module _3gpp-5gc-nrm-amffunction {
		description "this relies on the choice of GlobalRanNodeID";
		}
		key "GlobalRanNodeIDValue";
		uses NTNGlobalRanNodeIDGrp;
		}

		leaf satelliteBackhaulCategory{
		@@ -160,20 +163,309 @@ module _3gpp-5gc-nrm-amffunction {
		}
		}

		grouping GUAMInfoGrp {
		description "Represents the GUAMInfo datatype.";

		list pLMNId {
		description "This attribute represents a PLMN Identity.";
		min-elements 1;
		max-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses types3gpp:PLMNId ;
		}

		leaf aMFIdentifier {
		type int64;
		description "The AMFI is constructed from an AMF Region ID, an
		AMF Set ID and an AMF Pointer. The AMF Region ID identifies the region,
		the AMF Set ID uniquely identifies the AMF Set within the AMF Region,
		and the AMF Pointer uniquely identifies the AMF within the AMF Set.
		(Ref. 3GPP TS 23.003)";
		}
		}

		grouping N2InterfaceAmfInfoGrp {
		description "Represents the N2InterfaceAmfInfo datatype.";

		leaf-list ipv4EndpointAddress {
		type inet:ipv4-address;
		min-elements 1;
		description "This attribute represents available AMF endpoint
		IPv4 address(es) for N2.";
		}

		leaf-list ipv6EndpointAddress {
		type inet:ipv6-address;
		min-elements 1;
		description "This attribute represents available AMF endpoint
		IPv6 address(es) for N2.";
		}

		leaf amfName {
		type inet:host-name;
		description "This attribute represents AMF Name FQDN as defined in
		clause 28.3.2.5 of TS 23.003.";
		}
		}

		grouping BlockedLocationInfoGrp {
		description "Repreasents the datatype BlockedLocationInfo";

		list blockedLocation {
		description "This provides the geographical location at which the PLMN
		are not allowed in case of NTN.";
		min-elements 1;
		max-elements 1;
		key "mnc mcc";
		uses types3gpp:PLMNId ;
		}

		list blockedDurWindow {
		description "This provides the time durations for which the PLMN are
		not allowed at a given location in case of NTN";
		key idx;
		leaf idx { type uint32 ; }
		uses types3gpp:TimeWindowGrp;
		}

		list blockedSlice {
		description "This provides the slice for which the access is
		not allowed at a given location in case of NTN. ";
		max-elements 1;
		key idx;
		unique "sst sd";
		leaf idx { type uint32; }
		uses types5g3gpp:SNssai;
		}
		}

		grouping NTNPLMNRestrictionsInfoGrp {
		description "Represents the datatype NTNPLMNRestrictionsInfo";

		list pLMNId {
		description "This attribute represents a PLMN Identity.";
		min-elements 1;
		max-elements 1;
		key "mnc mcc";
		uses types3gpp:PLMNId ;
		}

		list blockedLocationInfoList {
		description "This defines the information related with the location
		for which the access restrictions are to be applied in case of NTN.";
		key "idx";
		leaf idx { type uint32 ; }
		uses BlockedLocationInfoGrp;
		}
		}

		grouping NtnLocationInfoGrp {
		description "Represents the NtnLocationInfo datatype.";

		list location {
		description "This defines the Location (geographical area) under
		consideration to which the satellite coverage info belongs";
		key idx;
		leaf idx { type uint32 ; }
		uses types3gpp:GeoAreaGrp;
		}

		list availabilityWindows {
		description "This attribute defines the list of time windows at which
		the satellite coverage will be available for this location.
		Either availabilityWindows or nonAvailabilityWindows shall be present.";
		key idx;
		leaf idx { type uint32 ; }
		uses types3gpp:TimeWindowGrp;
		}

		list nonAvailabilityWindows {
		description "This attribute defines the list of time windows at which
		the satellite coverage will not be available for this location.
		Either availabilityWindows or nonAvailabilityWindows shall be present.";
		key idx;
		leaf idx { type uint32 ; }
		uses types3gpp:TimeWindowGrp;
		}
		}

		grouping SatelliteCoverageInfoGrp {
		description "Represents the datatype SatelliteCoverageInfo";

		leaf nRSatelliteRATtype {
		type enumeration {
		enum NRLEO;
		enum NRMEO;
		enum NRGEO;
		enum NROTHERSAT;
		}
		description "This attribute defines the RAT Type for NR satellite
		access.";
		}

		list locationInfo {
		description "This attribute defines the information about location and
		corresponding time windows for which the satellite coverage will be
		available or unavailable.";
		key idx;
		leaf idx { type uint32 ; }
		uses NtnLocationInfoGrp;
		}
		}

		grouping SliceExpiryInfoGrp {
		description "Represents the datatype SliceExpiryInfo";

		list pLMNInfo {
		min-elements 1; // ???
		config false;
		description "It defines the PLMN(s) of a Network Function. ";
		key idx;
		leaf idx { type uint32 ; }
		uses types5g3gpp:PLMNInfo;
		}

		leaf expiryTime {
		type yang:date-and-time;
		config false;
		description "This attribute provides information about the time at
		which the slice is scheduled to be expired as it is not required
		anymore.
		This attribute will be set based on the sliceAvailability coming as
		part of ServiceProfile.";
		}
		}

		grouping MappedCellIdInfoGrp {
		description "Represents the datatype MappedCellIdInfo";

		list ntnGeoArea {
		description "This attribute indicates a specific geographical location
		mapped to Mapped Cell ID(s).";
		min-elements 1;
		max-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses types3gpp:GeoAreaGrp;
		}

		list mappedCellId {
		description "This attribute is in format of NCGI to indicate a fixed
		geographical area (See subclause 16.14.5 in TS 38.300";
		min-elements 1;
		max-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses types5g3gpp:NcgiGrp;
		}
		}

		grouping AmfInfoGrp {
		description "Represents the data type AmfInfo.";

		leaf amfRegionId {
		type int64;
		mandatory true;
		description "It represents the AMF Region ID, which identifies the
		region. AllowedValues: defined in subclause 2.10.1 of 3GPP TS 23.003 ";
		}

		leaf amfSetId {
		type int64;
		mandatory true;
		description "It represents the AMF Set ID, which is uniquely identifies
		the AMF Set within the AMF Region.
		allowedValues: defined in subclause 2.10.1 of 3GPP TS 23.003";
		}

		list taiList {
		min-elements 1;
		description "The list of TAIs.";
		key "idx";
		leaf idx { type uint32 ; }
		uses types3gpp:TaiGrp;
		}

		list taiRangeList {
		min-elements 1;
		description "The range of TAIs.";
		key "idx";
		leaf idx { type uint32 ; }
		uses nfp3gpp:TaiRangeGrp;
		}

		list gUAMIdList {
		description "List of supported Globally Unique AMF Ids (GUAMIs).";
		config false;
		min-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses GUAMInfoGrp;
		}

		list backupInfoAmfFailure {
		description "List of GUAMIs for which the AMF acts as a backup for AMF
		failure.";
		min-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses GUAMInfoGrp;
		}

		list backupInfoAmfRemoval {
		description "List of GUAMIs for which the AMF acts as a backup for
		planned AMF removal.";
		min-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses GUAMInfoGrp;
		}

		list n2InterfaceAmfInfo {
		description "This attribute represents the N2 interface information of
		the AMF. ";
		max-elements 1;
		key "idx";
		leaf idx { type uint32 ; }
		uses N2InterfaceAmfInfoGrp;
		}

		leaf amfOnboardingCapability {
		type boolean;
		default false;
		description "This attribute indicates the AMF supports SNPN Onboarding
		capability. This is used for the case of Onboarding of UEs for SNPNs
		(see TS 23.501, clause 5.30.2.10).
		- FALSE: AMF does not support SNPN Onboarding;
		- TRUE: AMF supports SNPN Onboarding.";
		}

		leaf highLatencyCom {
		type boolean;
		description "This attribute indicates whether the AMF supports High
		Latency communication (e.g. for NR RedCap UE). This is used for CP NF
		to discover AMF supporting High Latency communication (see TS 23.501,
		clause 6.3.5).
		- FALSE: AMF does not support High Latency communication e.g. for
		NR RedCap UE;
		- TRUE: AMF supports High Latency communication e.g. for NR RedCap UE;";
		}
		}

		grouping AMFFunctionGrp {
		description "Represents the AMFFunction IOC";
		uses mf3gpp:ManagedFunctionGrp;

		list pLMNIdList {
		list pLMNInfoList {
		min-elements 1;
		description "A list of PLMN identifiers (Mobile Country Code and Mobile
		Network Code).";
		key "mcc mnc";
		uses types3gpp:PLMNId;
		description "It defines the PLMN(s) of a Network Function. ";
		key idx;
		leaf idx { type uint32 ; }
		uses types5g3gpp:PLMNInfo;
		}

		container aMFIdentifier {
		//presence true;
		description "An AMF identifier, comprising an AMF Region ID, an
		AMF Set ID and an AMF Pointer.";
		uses types3gpp:AmfIdentifier;
		@@ -185,15 +477,14 @@ module _3gpp-5gc-nrm-amffunction {
		type inet:domain-name;
		}

		list sNSSAIList {
		min-elements 1;
		description "List of S-NSSAIs the managed object is capable of supporting.
		(Single Network Slice Selection Assistance Information)
		An S-NSSAI has an SST (Slice/Service type) and an optional SD
		(Slice Differentiator) field.";
		reference "3GPP TS 23.003";
		key "sd sst";
		uses types5g3gpp:SNssai;
		leaf-list cNSIIdList {
		type string;
		description "It is a set of NSI ID. NSI ID is an identifier for
		identifying the Core Network part of a Network Slice instance when
		multiple Network Slice instances of the same Network Slice are deployed,
		and there is a need to differentiate between them in the 5GC.
		See NSI ID definition in clause 3.1 of TS 23.501 and
		subclause 6.1.6.2.7 of TS 29.531";
		}

		list managedNFProfile {
		@@ -213,6 +504,39 @@ module _3gpp-5gc-nrm-amffunction {
		uses types5g3gpp:CommModel;
		}

		list amfInfo {
		max-elements 1;
		description "This attribute represents information of an AMF
		NF Instance.";
		key "idx";
		leaf idx { type uint32 ; }
		uses AmfInfoGrp;
		}

		list nTNPLMNRestrictionsList {
		description "This attribute defines the location restrictions per PLMN
		that relates to non-terrestrial network access.";
		key "idx";
		leaf idx { type uint32 ; }
		uses NTNPLMNRestrictionsInfoGrp;
		}

		list satelliteCoverageInfoList {
		description "This attribute defines the information related to NR
		Satellite RAT type and corresponding information of satellite coverage";
		key "idx";
		leaf idx { type uint32 ; }
		uses SatelliteCoverageInfoGrp;
		}

		list sliceExpiryInfo {
		description "This provides information related to a network slice
		validity.";
		key "idx";
		leaf idx { type uint32 ; }
		uses SliceExpiryInfoGrp;
		}

		list satelliteBackhaulInfoList{
		description "Specifies a list of satellite backhaul information. It can be
		used by NF and NF services.";
		@@ -222,7 +546,7 @@ module _3gpp-5gc-nrm-amffunction {
		}
		key "GlobalRanNodeIDValue";
		min-elements 1;
		uses satelliteBackhaulInfo;
		uses SatelliteBackhaulInfoGrp;
		}

		leaf-list mdtUserConsentReqList {
		@@ -243,12 +567,30 @@ module _3gpp-5gc-nrm-amffunction {
		Any MDT measurement, whose name is not specified in this list, is not
		subject to user consent at MDT activation.";
		}

		list mappedCellIdInfoList {
		description "It provides the list of mapping between GEO area and
		Mapped Cell ID.";
		key "idx";
		leaf idx { type uint32 ; }
		uses MappedCellIdInfoGrp;
		}

		leaf aMFSetRef {
		type types3gpp:DistinguishedName;
		description "This is the DN of AMFSet";
		}
		}

		augment "/me3gpp:ManagedElement" {
		list AMFFunction {
		description "5G Core AMF Function";
		reference "3GPP TS 28.541";
		description "This IOC represents the AMF functionality in 5GC.
		For more information about the AMF, see 3GPP TS 23.501.

		The attribute sliceExpiryInfo is used when the validity information of
		a network slice need to be configured. The attribute
		sliceExpiryInfo.pLMNInfo indicates the network slice to which the
		validity information applies.";
		key id;
		uses top3gpp:Top_Grp;
		container attributes {

yang-models/_3gpp-5gc-nrm-lmffunction.yang

+236 −10

File changed.

Preview size limit exceeded, changes collapsed.

yang-models/_3gpp-5gc-nrm-nwdaffunction.yang

+23 −1

Original line number	Diff line number	Diff line
		@@ -73,6 +73,14 @@ module _3gpp-5gc-nrm-nwdaffunction {
		description "It indicate whether the NWDAF supports analytics metadata
		provisioning:";
		}

		leaf roamingExchange {
		type boolean ;
		default false;
		description "It indicates whether the NWDAF
		supports roaming exchange capability";
		}

		}

		grouping MlAnalyticsInfoGrp {
		@@ -370,6 +378,20 @@ module _3gpp-5gc-nrm-nwdaffunction {
		decomposition, in that case the NWDAF only supports the analytics
		services.";
		}

		leaf roamingAnalytics {
		type boolean ;
		config false;
		description "It indicates whether the NWDAF supports
		Nnwdaf_RoamingAnalytics service";
		}

		leaf roamingData {
		type boolean ;
		config false;
		description "It indicates whether the NWDAF supports
		Nnwdaf_RoamingData service";
		}
		}

		augment "/me3gpp:ManagedElement" {

yang-models/_3gpp-5gc-nrm-stmfunction.yang

0 → 100644

+103 −0

Original line number	Diff line number	Diff line
		module _3gpp-5gc-nrm-stmfunction {
		yang-version 1.1;

		namespace urn:3gpp:sa5:_3gpp-5gc-nrm-stmfunction;
		prefix stm3gpp;

		import _3gpp-common-top { prefix top3gpp; }
		import ietf-inet-types { prefix inet; }
		import _3gpp-common-yang-types { prefix types3gpp; }

		organization "3gpp SA5";
		contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
		description "This IOC represents the STM function defined in 3GPP TS 28.abc.
		Copyright 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI,
		TTA, TTC). All rights reserved.";
		reference "3GPP TS 28.abc
		Signalling traffic monitoring management";

		revision 2024-11-07 { reference "S5-247077"; }

		grouping StmCtrlGrp {
		description "Represents the StmCtrl IOC.";

		leaf-list reportingNFList {
		type types3gpp:DistinguishedName;
		description "List of Network Function Distinguished Name, which
		specifies the target network interface type to be monitored. If
		this parameter is not present or it is empty, then all applicable
		interface types from the target NF shall be monitored";
		}

		leaf-list networkInterfaceTypeList {
		type enumeration {
		enum ALL;
		enum N4;
		enum N5;
		enum N7;
		enum N8;
		enum N10;
		enum N11;
		enum N12;
		enum N13;
		enum N14;
		enum N15;
		enum N22;
		enum N58;
		enum N59;
		enum N80;
		enum N81;
		}
		default ALL;
		description "List of network interface type. it specifies the network
		function whose signalling traffic is to be monitored. If this
		parameter is not present or it is empty, then all Network Functions
		within the SubNetwork or ManagedElement shall be monitored. This
		parameter shall be omitted if the STM control object is specified
		under a ManagedFunction. ";
		reference "Clause 4.2.3 of 3GPP TS 23.501 for details on the
		allowed values.";
		}

		leaf stmTargetUri {
		type inet:uri;
		mandatory true;
		description "It specifies the Uniform Resource Identifier (URI) of the STM
		consumer that shall receive the monitored signalling message copies ";
		reference "Clause 4.4 of 3GPP TS 32.158";
		}

		leaf administrativeState {
		default LOCKED;
		type types3gpp:BasicAdministrativeState ;
		description "It is used by the STM consumer to lock or unlock the
		StmCtrl instance in order to stop or start the signalling traffic
		monitoring";
		}

		leaf operationalState {
		config false;
		mandatory true;
		type types3gpp:OperationalState ;
		description "It is used by STM consumer to report its working state";
		}
		}

		grouping StmCtrlSubTree {
		description "Contains classes that manage Signalling traffic monitoring
		management";

		list StmCtrl {
		description "This IOC represents the STM Control and Configuration
		parameters of a particular STM controlling. It can be
		name-contained by SubNetwork, ManagedElement, or ManagedFunction.";

		key id;
		uses top3gpp:Top_Grp ;
		container attributes {
		uses StmCtrlGrp ;
		}

		}
		}
		}
		No newline at end of file