YD-T 4344-2023 5G网络切片 管理功能（NSMF）与核心网网络切片子网管理功能（CN-NSSMF）接口技术要求

2023-07-28发布2023-11-01实施I 12规范性引用文件 13术语和定义 1 1 25.1接口概述 2 26NSMF与CN-NSSMF接口功能要求 36.1认证接口 36.2核心网切片子网业务实例生命周期管理接口 46.3切片子网配置参数管理接口 56.4切片子网模板管理接口 57NSMF与CN-NSSMF接口定义 67.1认证接口 67.2核心网切片子网业务实例生命周期管理接口 7.3切片子网配置参数管理接口 437.4切片子网模板管理接口 Ⅱj)5G网络切片管理功能(NSMF)与基于切片分组网(SPN)的承载网切片子网管理功能1本文件规定了5G网络切片管理功能(NSMF)与核心网子切片管理功能(CN-NSSMF)的接口功本文件适用于5G网络切片管理功能(NSMF)及核心网子切片管理功能(CN-NSSMF)的技术研2规范性引用文件4缩略语5G业务质量标识AccessandMobilityManagementFuIdentiferNSNetworkServiceNSDNetworkServiceDescriptorNSINSIIDNetworkSliceInstanceIndentifierNSTNSMFNetworkSliceManagementFunctionNSSAINetworkSliceSelectionAssis2NSSINSSIIDNSSTNSSMF网络切片管理域网络切片管理域NSMFNSMF-ANNSMFCN网络切片业务域UuN6 3 ——204NOCONTENT-[DELETE]: 401Unauthorized-[all]:表示用户没有权限(令牌、用户名、密码错误)。——403Forbidden-[all]:表示用户得到授权(与401错误相对),但是访问是被禁止的。有XML格式)。4REST接口Authentication(NSMF-NSS/apirest/securityManagement/{apiVNSMF向CN-NSSMF进行握手机制/api/rest/securityManagement/{apiVNSMF向CN-NSSMF进行/api/rest/securityManagement/{apiVNSMF退出CN-NSSMF系统登录Authentication(NSSMF-NSlapirest/securityManaCN-NSSMF向NSMF进行注：CN-NSSMF向NSMF发送消息时，不采用握手协议进行维护，到期后自动退出REST接口POST/api/rest/provMns/{apiVersion}/NSS/SliceProPOST/api/rest/provMns/{apiVersion}/NSS/apirest/provMns/{apiVersion}/NSS/{S-NSSAI}/act/api/rest/provMns/{apiVersion}/NSS/{S-NSSAI}/deactPUT/api/rest/provMns/{apiVersion}/NSS/nssi/{ns务实例5REST接口GET/api/rest/provMns/({apiVersion}/NSS/nssi/{n子网业务实例查询DELETE/api/rest/provMns/{apiVersion}/NSS/SlicePro终止或解绑定带业务的NSSIDELETE/api/rest/provMns/{apiVersion}/NSS/ns终止NSSI实例/api/rest/provMns/{apiVersion}/NSS/nssi/notifGET/api/rest/provMns/{apiVersion}/NSS/jobs/(j管理进度查询REST接口/api/rest/provMns/{apiVersion}/NSS/api/rest/provMns/{apiVer/api/rest/provMns/{apiVersion}/NSSPOST/api/rest/provMns/{apiVersion}/NSS/script/api/rest/provMns/{apiVersion}/NSS6表4切片子网模板管理接口包含的APIREST接口GET/api/rest/provMns/{apiVersion}所有NSST模板查询指定NSST模板查询7.1认证接口7.1.1Authentication(NSMF-NSSMF)用户认证Authentication(NSMF-NSSMF)用户认证API参数定义见表5。方向参数说明鉴权类型M登录用户名MMMtoken超时时间M状态返回码如果执行正确，返回状态码200.如果用户名密码错误，返回状态码400.API接口样例请求举例。POST/api/rest/securityManagement/v1/oauth/token{f7{“accessToken”:”7512eb3feb5249eca5ddd742fedddd39”,“expires”:18007.1.2Handshake(NSMF-NSSMF)握手机制Handshake(NSMF-NSSMF)握手机制API参数定义见表6。表6API参数定义方向参数说明M无无M状态返回码如果执行正确，返回状态码200OK。如果携带的token错误或不存在，返回状态码400.其他错误见HTTP标准状态码。API接口样例POST/api/rest/securityManagement/v1/oauth/hanaccessToken:7512eb3feb5249eca5ddd}8{}7.1.3Logout(NSMF-NSSMF)退出登录Logout(NSMF-NSSMF)退出登录API参数定义见表7。方向参数说明M无无M如果携带的token错误或不存在，返回状态码400.其他错误见HTTP标准状态码。API接口样例DELETE/api/rest/securityManagement/v1/oauth/tokaccessToken:7512eb3feb5249eca5ddd9{7.1.4Authentication(NSSMF-NSMF)用户认证Authentication(NSSMF-NSMF)用户认证API参数定义见表8。方向参数说明鉴权类型M登录用户名MMMtoken超时时间M状态返回码如果执行正确，返回状态码201.如果用户名密码错误，返回状态码400.API接口样例POST/api/rest/securityManagement/vl/oauth/token}“accessToken”:”7512eb3feb5249eca5ddd742fedddd39”,“expires”:1800数据类型鉴权类型。最大长度255,申请token时取值”password”用户名。由字母和数字组成，字母不区分大超时时间。厂家自定义，单位分钟表10API参数定义方向参数说明必选M/条件必M0CM0表10API参数定义(续)方向参数说明必选M/条件必核心网子网服务的省份列时必选CMMMMMC0用户下行体验速率(Mbps)0用户上行体验速率(Mbps)0下行区域流量密度00活动因子(%)00端到端时延(ms)0抖动(us)0生存时间(ms)0服务可用性(%)0服务可靠性(%)0用户体验速率(Mbps)0载荷大小0流量密度(Gbps/km2)0连接密度(pcs/km2)00M支持的最大PDU会话数(万)0表10API参数定义(续)方向参数说明必选M/条件必每月上行总数据量(TB)0每月下行总数据量(TB)0每年上行总数据量(TB)0每年下行总数据量(TB)000时延M终端移动等级0资源共享等级M资源隔离要求0MMM0M切片承载部署信息MCCAPI接口样例}"sliceProfileId":"ab9af40f13f721b5"coverageAreaTAList':"nsild":"NSI-M-001-HDB"transDeployInfoFileUrl":"https://x.x.x.x:x/transDepolyI}}"nssild":"NSSI-C-001-HDBN"jobld":"4b45d919816ccaa2}7.2.2createNSSI(创建或分配一个不带业务的NSSI)a)新创建NSSI,并建立NSI、NSSI绑定关系。b)引用已有不带业务的NSSI,并建立NSI、NSSI绑定关系。createNSSI(创建或分配一个不带业务的NSSI)API参数定义见表11。方向参数说明MMC0核心网子网服务的省份列表，NSIC00MM00CC如果执行正确，返回状态码202。其他错误见HTTP标准状态码。API接口样例POST/api/rest/provMns/{apiVersion}/NSS/nssi/NSSI-C-001-HDBNJ-NSSMF-01-A-ZXHTTP/1.1{"nsstId":"NSST-C-001-HDBN"nsild":"NSI-M-001-HDB}{"nssild":"NSSI-C-001-HDBN"jobId":"4b45d919816ccaa2b}activateNSSI(切片业务子网激活)API参数定义见表12。方向参数说明MMC其他错误见HTTP标准状态码。API接口样例/api/rest/provMns/{apiVersion}/NS"nsild":“NSI-M-001-HDB"nssild":“NSSI-C-001-HDBNJ-NSSMF-01-A-ZX”}{“jobId”:“4b45d919816ccaa2b762df5120f72067”}7.2.4deactivateNSSI(切片业务子网去激活)deactivateNSSI(切片业务子网去激活)API参数定义见表13。方向参数说明MMC状态返回码如果执行正确，返回状态码202.其他错误见HTTP标准状态码。API接口样例请求举例：PUT/apirest/provMns/{apiVersion}/NSS/001-100001/deactivationHTTP/1.1{"nsild":“NSI-M-001-HDBN"nssild:“NSSI-C-001-HDBNJ-NSSMF-01-A-ZX”}响应举例：HTTP/1.1202ACCEP“jobld”:“4b45d919816ccaa2b762df5120f72067”}该接口支持五种场景。a)仅更新切片子网业务。b)仅更新子网配置(通过脚本),如DNN配置等。c)更新切片子网业务，同时切换原有模板中的flavor。d)更新切片子网业务，同时切换新模板nsst。modifyNSSI(NSSI更新)API参数定义见表14。表14API参数定义方向参数说明必选M/条件必MMC00000用户下行体验速率(Mbps)0用户上行体验速率(Mbps)0下行区域流量密度00活动因子(%)00时延(ms)0抖动(us)0生存时间(ms)0服务可用性(%)0服务可靠性(%)0用户体验速率(Mbps)0载荷大小0流量密度(Gbps/km2)0连接密度(pcs/km2)000表14API参数定义(续)方向参数说明必选M/条件必(万)0每月上行总数据量(TB)0每月下行总数据量(TB)0每年上行总数据量(TB)0每年下行总数据量(TB)000时延0终端移动等级0资源共享等级0资源隔离要求0MM00C实例时必选C00CM0C如果执行正确，返回状态码202。API接口样例PUT/api/rest/provMns/v1/NSS/SliceProfiles/ab9af40f13f721b5fl3539d874{"nssild":NSSI-C-001-HDB"coverageAreaTAList":}"nsiId":"NSI-M-001-HDB"nsiName":“eMBB-002”}"nsstId:"NSST-C-001-HDBN}{}b)切换新nsst。c)仅更新子网配置(通过脚本),如DNN配置等。方向参数说明时必选CC00CM0MM00C{}{}表16API参数定义方向参数说明MMM0M表16API参数定义(续)方向参数说明0M核心网子网服务的MM网元实例标识列表M网络服务信息MMMM0M0MMMVNFD标识MM0MMPNFD标识M内嵌NS实例信息0内嵌NS实例标识M内嵌NS实例名称M内嵌NS实例描述0内嵌NSD标识M内嵌NS中的VNFM表16API参数定义(续)方向参数说明MMMM内嵌NS中的PNE实例信息列表0MMM内嵌NS中内嵌的0内嵌NS实例状态0MMMMMMembb性能需求列表000下行区域流量密度0上行区域流量密度0活动因子(%)00端到端时延(ms)0抖动(us)0表16API参数定义(续)方向参数说明生存时间(ms)0服务可用性(%)0服务可靠性(%)00载荷大小00连接密度(pcs/km2)00M话数(万)0000000时延M终端移动等级0资源共享等级M资源隔离要求0API接口样例GET/api/rest/provMns/{apiVersion}/NSS/SliceProfiles/ab9af40f13f721b5fl3539d87484098HTTP/1.1{"nssild":"NSSI-C-001-HDBN"nsstId":"NSST-C-001-HDBN"nsInstanceId":"fe9af40f13f721b5"nsdId":"7356240f13f721b5f"vnfInstanceId":"2345640f13f721b5"vnfdId":"a345640f13f721b5f"pnfId":"8aed640f13f721b5f"pnfdld":"fff640f13f721b5f"nsInstanceId":"1233f40f13f721b5f"nsdId":"abc6240f13f721b5fYD/T4344—2023"vnfdId":"8885640f13f721b5f"nestedNsInstanceId":["bbbcf40f13f721b5f"sliceProfileId":"ab9af40f13f721b5"coverageAreaTAList':}getNSSIbylId(根据子网实例标识进行切片子网业务实例查询)API参数定义见表17。方向参数说明MMM0NSST标识M0MMM网元实例标识列表M网络服务信息MMMM0NSD标识M0MMMVNFD标识MM0MMM内嵌NS实例信息0内嵌NS实例标识M表17API参数定义(续)方向参数说明内嵌NS实例名称M内嵌NS实例描述0内嵌NSD标识M内嵌NS中的VNF实例MMMMM内嵌NS中的PNF实例0MMM内嵌NS中内嵌的NS实0内嵌NS实例状态0MMMMMMcmbb性能需求列表000下行区域流量密度0表17API参数定义(续)方向参数说明上行区域流量密度0活动因子(%)00端到端时延(ms)0抖动(us)0生存时间(ms)0服务可用性(%)0服务可靠性(%)0用户体验速率(Mbps)0载荷大小0流量密度(Gbps/km2)0连接密度(pcs/km2)00M(万)0每月上行总数据量(TB)0每月下行总数据量(TB)0每年上行总数据量(TB)0每年下行总数据量(TB)000时延M终端移动等级0资源共享等级M资源隔离要求0API接口样例GET/api/rest/provMns/{apiVers{“nssiInfo”:{“nssild”:“NSSI-C-001-HDBNJ-NSSMF-01-A-ZX”,“nssiName”:“test_CN”,“nsstId”:“NSST-C-001-HDBNJ-NSSMF-01-A-ZX”,“nssiState”:“enabled”,“networkSliceSubnet”:{“mfldList”:[“1301ZTHX2SMFA12ZA1”,”1301ZTHX2UPF023A4D”,”1301ZTHX2SMF7“nsInfo”:{“nsInstanceld”:“fe9af40f13f721b5f13539d87488899”,“nsInstanceName”:“test_NS”,“nsdId”:“7356240f13f721b5f13539d87ad2341”,“ynfInstance”:[{“vnfInstanceId”:“2345640f13f721b5fl3539d8748ade4”,“vnfInstanceName”:“smf”,“vnfdId”:“a345640fl3f721b5f13539d8748adef”,“instantiationState”:“active”“pnfinfo”:[{“pnfId”:“8aed640f13f721b5f13539d874812a8”,“pnfName”:“upf”,“pnfdld”:“fff640fl3f721b5f13539d87482222”,“nestedNsInstance”:[{“nsInstanceId”:“1233f40f13f721b5f13539d87488333”,“nsInstanceName”:“nested_ns”,“nsdId”:“abc6240fl3f721b5f13539d87ad2abc”,“nestedVnfInstanceList”:[{“vnfInstanceId”:“amf”,“vnfInstanceName”:“amf”,“vnfdId”:“8885640f13f721b5fl3539d8748adef”,“instantiationState”:“active”“nestedNsInstanceId”:[“bbbcf40f13f721b5f13539d8748aedd”],“nsState”:“active”,“nsState”:“active”“sliceProfileList”:[{“sliceProfileId”:“ab9af40f13f721b5fl3539d87484098”,"coverageAreaTAList":}}a)仅删除NSSI与S-NSSAI绑定关系，不删除NSSI与NSI的绑定关系，不终止NSSI资源。b)删除NSSI与S-NSSAI绑定关系，同时在NSSI不被其他NSI共享时删除NSSI与NSI绑定关c)删除NSSI与S-NSSAI绑定关系，在NSSI被其他NSI共享时删除NSSI与NSI绑定关系，不终止NSSI资源。deallocateNSSI(终止或解绑定带业务的NSSI)API参数定义见表18。表18API参数定义方向参数说明MM时必选C是否允许终止切片子网实例资1:是，表示当NSSI不被其他NSI共享时需要终止NSSI资源M00C其他错误见HTTP标准状态码。API接口样例DELETE/api/rest/provMns/v1/NSS/SliceProfiles/ab9af40f13f721b5fl3539d8{"nsiId":"NSI-M-001-HDB"nssild";"NSSI-C-001-HDBN}}“jobId”:“4b45d919816ccaa2b762df5120f73811”}a)删除NSSI与NSI绑定关系，同时在NSSI不被其他NSI共享时终止NSSI资源。b)删除NSSI与NSI绑定关系，在NSSI被其他NSI共享时不终止NSSI资源。terminateNSSI(终止NSSI实例)API参数定义见表19。表19API参数定义方向参数说明止NSSI资源，被其他NSI引M00CAPI接口样例DELETE/api/rest/provMns/v1/NSS/nssi/NSSI-C-001-HDBNJ-NSSMF-01-A-Z{}}YD/T4344—2023{“jobId”:“4b45d919816ccaa2b762df5120f73811”}7.2.11NSSIChangeNotify(切片子网业务实例变更NSSIChangeNotify(切片子网业务实例变更通知)API参数定义见表20。表20API参数定义方向参数说明NSSMF标识MMM其他错误见HTTP标准状态码。API接口样例POST/api/rest/provMns/v1/NSS/nssi/notificatio{["NSSI-C-001-HDBNJ-NSSMF-01-A-ZX","NSSI-C-002-H}{}一次切片业务子网实例生命周期操作是一个长时任务，任务的发起方(NSSMF)发起请求后，实施方返回一个任务号，发起方可以使用本接口定时去查询实施方任务完成由于发起方发起的查询周期和实施方写日志的周期不同步，所以为防止漏消息，引入了志，分别为操作日志1,操作日志2,操作日志3,操作日志4,操作日志5,那么操作日志1,操作日志2,操作日志3,操作日志4将放在作日志6,操作日志7,操作日志8,操作日志9,操作日志10,这时，操作日志6,操作日志7,操作表21API参数定义方向参数说明CMM当前进度描述000MM0M表21API参数定义(续)方向参数说明M消息号MCMM当前进度描述000MM0MM消息号M如果执行正确，返回状态码200(查询结果不为空)、404(查询结果为空)。其他错误见HTTP标准状态码。API接口样例GET/api/rest/provMns/v1/NSS/4b45d919816ccaa2b762df5120f72067?res{“responseDescriptor”:{“progress”:42,“status”:“processing”,“statusDescription”:“InitiatingVNFInstance”,“responseId”:“6”,“responseHistoryList”:[“progress”:10,“status”:“processing”,“statusDescription”:“PreparingforInstantiatingNSSI“,“responseId”:“4”{“progress”:15,“status”:“processing”,“statusDescription”:“CheckRequirementsofNSSI”,“responseId”:“5”}]}核心网切片子网业务实例生命周期管理接口参数定义见表22。表22参数定义数据类型NSST标识S-NSSAI的格式是3GPP规范，本身32bit,前8bit代表SST,后24bit代表SD。此变量为长度为10个字符字符，组成方式：3个字符标前3个字符为SST对应8bit十进制数直后6个字符位SD对应的24bit的十六进制数直接NSSI关联的业务需求，由plmninfoList、sliceProfileId、perfReq、maxNumberofUEs、covergeAreaTAList、latency、ueMobilityLe数据类型包括S-NSSAI与plmnldl两个参数组成。S-NSSAI的格式是3GPP规范，本身32bit,前8bit代表SST,后24bit代表SD。此变量为长度为10个字符字符，组成方式：3个字符标前3个字符为SST对应8bit十进制数直后6个字符位SD对应的24bit的十六进制数直接组成格式mcc-mnc性能需求，由perfReqEmbbList、perfReq性能需求列表，由参数名和参数值组成，格式示例“paraml”:“value”,“param2”:“value”性能需求列表，由参数名和参数值组成，格式示例“paraml”:“value”,“param2”:“value”用户下行体验速率(Mbps)用户上行体验速率(Mbps)下行区域流量密度(Gbps/km2)上行区域流量密度(Gbps/km2)活动因子(%)端到端时延(ms)抖动(us)生存时间(ms)服务可用性(%)服务可靠性(%)表22参数定义(续)数据类型用户体验速率(Mbps)载荷大小流量密度(Gbps/km2)连接密度(pcs/km2)支持的最大PDU会话数(万),可以同时/并发接入网每月上行总数据量(TB)每月下行总数据量(TB)每年上行总数据量(TB)每年下行总数据量(TB)UPF部署位置，枚举：市级：prefectural省级：province覆盖区域TA列表，如[1,2,3,4]终端移动等级，枚举：资源隔离要求，切片实例的资源是否与其他切片实例共享，取值：整数类型(1、2、3),1:独享资源池+独享用户面；2:共享资源池+独享用户面；表22参数定义(续)数据类型NSSI归属的NSI信息，格式示例：}NSSI扩展参数，由参数名paramName和参数值paramValue组成{“param2”:“value2”}instantiating实例化中updating更新中terminating终止中“nsInfo”:{:}NF信息列表，由NSSI包含的所有NF的标识组成，其中NF的表22参数定义(续)数据类型嵌套NS实例列表，展开结构见nsInfo,对于嵌NS实例的场景不再展开，仅通过nestedNsInstanceld参数列出子嵌内嵌NS中的VNF实例信息列表内嵌NS中的PNF实例信息列表内嵌NS中内嵌的NS实例标识列表表22参数定义(续)“paraml”:“value”“param2”:“value”消息号Job响应的消息号，每个Job的Respons1:是，表示当NSSI不被其他NSI共享时需要终止NSSI资源vnf错误信息列表，由vnfinstanceId、vnfErropnf错误信息列表，由pnfld、pnfError切换后的NSST,通过更新NSST更新NSSI时必选，由nsstId、f表22参数定义(续)数据类型切片核心网与承载网对接部署信息文件URID,port,5QI(可选),DSCP(可选),VLANPRI(可选);根据承接设备列表，对接VLANID,port,5QI,DSCP,VLAN备列表对应核心网侧对接设备(如DCGW、UVLANID对应承载网VLANID号；port对应对接端口；5QI、DSCP、VLANPRI对应5QI与SPN优先级(DSCP/VLANPRI)的映射关系。多个元素使用“I”分割。如：承载网类型标识，对接设备列表，对接VLANID,port,5QI,DSCP,设备列表，对接VLANID,port,5QI,DSCP。核心网侧5QI与DSCP的映射关系。多个元素使用“承载网类型标识，对接设备列表，对接VLANID,port作，并通过切片子网业务配置脚本下发接口，将配置脚本的脚本名称与脚本URI下发给表23API参数定义方向参数说明M配置脚本URIM}{}deleteScript(切片子网业务配置脚本删除)API参数定义见表24。表24API参数定义方向参数说明其他错误见HTTP标准状态码。DELETE/apirest/provMns/v1NSS/Script/CN2HTTP/1.1{}}queryScript(切片子网业务配置脚本查询)API参数定义见表25。表25API参数定义方向参数说明0如果执行正确，返回状态码200(查询结果不为空)、404(查询结果为空)。其他错误见HTTP标准状态码。GET/api/rest/provMns/v1/NSS/ScriptHTTP/1.1{}}7.3.5deliverScriptOrder(切片子网业务配置脚本工单下发)务，根据allocate、create、modify、modifybyId、deallocate、terminate场景分配不同orejectedOrderId,NSSMF需覆盖原有脚本包，并制作新的脚本包返回NSMF。deliverScriptOrder(切片子网业务配置脚本工单下发)API参数定义见表26。表26API参数定义方向参数说明Version}/NSS/MM,枚举，取值“allocate”、“deallocate”、”terminate”C,type取值“allocate”、“create”时必选，取值“modify”、“modifybyId”,表26API参数定义(续)方向参数说明C,type取值“allocate”、“create”时可选，取值的flavor来更新实例C,type取值“allocate”、“create”且引用已有NSSI时必选，取值“modify”、C,type取值“allocate”、“create”时必选，取值“modify”、“modifybyld”可选C,type取值“allocate”、“modify”必选，取值“deallocate”且为场景一时必选1必选MMMMC0用户下行体验速率(Mbps)0用户上行体验速率(Mbps)0下行区域流量密度(Gbps/km2)0上行区域流量密度(Gbps/km2)0活动因子(%)0表26API参数定义(续)方向参数说明0端到端时延(ms)0抖动(us)0生存时间(ms)0服务可用性(%)0服务可靠性(%)0用户体验速率(Mbps)0载荷大小0流量密度(Gbps/km2)0连接密度(pcs/km2)00M支持的最大PDU会话数(万)0每月上行总数据量(TB)0每月下行总数据量(TB)0每年上行总数据量(TB)0每年下行总数据量(TB)000时延M终端移动等级0资源共享等级M资源隔离要求0止NSSI资源，被其他NSI引表26API参数定义(续)方向参数说明C,type取值“modify”、“modifybyld”且通过切换M0是否允许终止切片子网实例资止NSSI资源，对应场景11:是，表示当NSSI不被其他该字段取值0时，S-NSSAIList0详设文件URIM其他错误见HTTP标准状态码。API接口样例POST/api/rest/provMns/v1/NSS/scriptOrder{"nsstId":"NSST-C-001-HDBN"sliceProfileId":"ab9af40f13f721b5}"coverageAreaTAList":"nsild":"NSI-M-001-HDB"docUri":"https://x.x,x.x:x