YD∕T 3896-2021 网络功能虚拟化（NFV）配置管理技术要求(通信).pdf
ICS 33.060 M36 YD 中华人民共和国通信行业标准 YD/T xxxxxxxxx 网络功能虚拟化（NFV）配置管理技术要求 Network functions virtualisation(NFV)configuration management technical requirement (报批稿)XXXX-XX-XX 发布 XXXX-XX-XX 实施 中华人民共和国工业和信息化部 发 布 YD/T XXXXXXXX-I-目 次 前 言.II 1 范围.1 2 规范性引用文件.1 3 缩略语.1 4 概述.2 4.1 VNF 可配置参数和 VNF 应用层参数.2 4.2 NFV 配置管理数据流.2 5 网络功能虚拟化（NFV）配置管理功能需求.3 5.1 Itf-N 接口配置管理需求.3 5.2 Ve-vnfm-em 接口配置管理需求.3 5.3 Ve-vnfm-vnf 接口配置管理需求.4 6 网络功能虚拟化（NFV）配置管理接口分析.4 6.1 Itf-N 接口分析.4 6.2 Ve-vnfm-em 接口分析.4 6.2.1 修改配置参数.4 6.2.2 订阅配置变更.5 6.2.3 取消订阅配置变更.5 6.2.4 通知配置变更.6 6.3 Ve-vnfm-vnf 接口分析.6 6.3.1 设置初始配置参数.6 6.3.2 修改配置参数.7 7 网络功能虚拟化（NFV）配置管理接口定义.8 7.1 Itf-N 接口定义.8 7.2 Ve-vnfm-em 接口定义.8 7.2.1 接口定义概述.8 7.2.2 资源与对应 HTTP 方法的映射关系表.9 7.2.3 API 资源定义.9 7.3 Ve-vnfm-vnf 接口定义.11 7.3.1 接口定义概述.11 7.3.2 资源与对应 HTTP 方法的映射关系表.11 7.3.3 API 资源定义.12 附录 A.14 A.1 EMS 与 VNFM 之间修改配置参数流程.14 A.2 EMS 与 VNFM 之间订阅与取消订阅变更以及通知流程.15 A.3 VNFM 与 VNF 之间设置初始配置参数流程.15 A.4 VNFM 与 VNF 之间修改配置参数流程.16 附录 B.18 B.1 配置数据结构定义.18 B.2 订阅数据结构定义.18 B.3 订阅过滤器 Filter 数据结构定义.19 B.4 通知数据结构定义.19 参考文献.20 YD/T XXXXXXXX前 言 本标准是网络功能虚拟化（NFV）网络管理系列标准中的一项。该系列标准的预计结构为：网络功能虚拟化（NFV）生命周期管理技术要求 网络功能虚拟化（NFV）配置管理技术要求 网络功能虚拟化（NFV）故障管理技术要求 网络功能虚拟化（NFV）性能管理技术要求 本标准按照GB/T 1.1-2009给出的规则起草。本标准的某些内容可能涉及专利。本标准的发布机构不承担识别这些专利的责任。本标准由中国通信标准化协会提出并归口。本标准起草单位：中兴通讯股份有限公司、北京市天元网络技术股份有限公司、上海诺基亚贝尔股份有限公司、爱立信（中国）通信有限公司。本标准主要起草人：巨满昌、陈丽萍、高娴、李笑昕、李欣蔚、李钢。YD/T XXXXXXXX1 网络功能虚拟化（网络功能虚拟化（NFVNFV）配置管理技术要求）配置管理技术要求 1范围 本标准规定了网络功能虚拟化（NFV）环境下的配置管理功能，包括网络功能虚拟化中各管理接口涉及的配置管理功能需求、接口分析和接口定义。本标准适用于网络功能虚拟化（NFV）的配置管理。2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。YD/T XXXX-XXXX 网络功能虚拟化编排器（NFVO）总体技术要求 YD/T 3262-2017 LTE网元管理系统 网络管理系统（EMS-NMS）接口功能技术要求 3缩略语 下列缩略语适用于本文件。EMS 网元管理系统 Element Manager System GS 组规范 Group Specification HTTP 超文本传送协议 Hypertext Transfer Protocol HTTPS 安全超文本传输协议 HTTP Secure IFA 接口和构架 Interfaces and Architecture JSON JavaScript 对象标记语言 JavaScript Object Notation MOI 管理对象实例 Managed Object Instance NFV 网络功能虚拟化 Network FunctionVirtualization NFVO 网络功能虚拟化编排器 Nework Function Virtualization Ochestrator OSS 运营支撑系统 Operation Support System REST 具象状态转移 Representational State Transfer RFC 征求评议文件 Request for Comments SOL 解决方案 Solution TLS 安全传输层协议 Transport Layer Security VNF 虚拟网络功能 Virtualised Network Function VNFC 虚拟网络功能组件 Virtualised Network Function Component VNFD 虚拟网络功能模板 Virtualised Network Function Descriptor VNFM 虚拟网络功能管理实体 Virtualised Network Function Manager YD/T XXXXXXXX24概述 4.1 VNF 可配置参数和 VNF 应用层参数 在 VNF 设计阶段，厂商确定 VNFD 中所包含的 VNF 部署和运行所需要的参数，VNFD 为静态描述文件，其中只有部分参数可以在 VNF 实例化期间或之后被修改，该部分参数在 VNFD 中被声明为 VNF 的可配置参数。可配置参数通常与资源相关。另外，VNF 应用层参数主要是指业务运行以及业务管理所需要的参数。此类参数可以在 VNF实例化期间或之后被修改，例如北向接口的参数等。4.2 NFV 配置管理数据流 NFV配置管理的数据流如图1所示。图 1 NFV配置管理的数据流 网络功能虚拟化（NFV）配置管理涉及以下接口：OSS EMS 接口（Itf-N）EMS VNFM 接口（Ve-vnfm-em）VNF VNFM 接口（Ve-vnfm-vnf）各接口的位置和定义见YD/T XXXX-XXXX 网络功能虚拟化编排器（NFVO）总体技术要求。注：路径 A 中虚线相关的操作是包含在生命周期管理中（VNF Package 中包含可配置参数）。根据图1，VNF可配置参数的配置路径有：通过路径A：a)OSS将VNF Package通过Os-Ma-Nfvo上传到NFVO，其中VNF可配置参数包含在VNFD里；b)NFVO将VNF可配置参数通过Or-Vnfm接口在VNF实例化时发送给VNFM；c)VNFM将需要发送给VNF的可配置参数通过Ve-Vnfm-vnf接口在VNF实例化期间发送给VNF。通过路径C：a)OSS通过北向接口Itf-N发送新的VNF可配置参数给EMS；b)EMS通过Ve-Vnfm-em接口发送新的VNF可配置参数给VNFM；YD/T XXXXXXXX3c)VNFM将需要发送给VNF的可配置参数通过Ve-Vnfm-vnf接口发送给VNF。VNF可配置参数可以通过路径A或路径C来修改。路径C可选用于VNF实例化后对VNF可配置参数进行修改，并且前提条件是EMS知道VNF的VNFD信息，能够确认哪些参数是该VNF的可配置参数。例如，EMS通过路径C修改VNF网元的网口信息。根据图 1，VNF 应用层参数的配置路径为通过路径 B：a)VNF实例化期间或之后，OSS通过北向接口Itf-N下发VNF应用层参数给EMS；b)EMS给VNF发送VNF应用层参数。修改VNF应用层参数采用的路径和参数下发时的路径一致。5网络功能虚拟化（NFV）配置管理功能需求 5.1Itf-N 接口配置管理需求 此接口用于VNF应用层参数处理。Itf-N接口的配置管理功能需求如下：a)应支持 OSS 通过该接口创建 VNF 实例对应的管理对象实例（MOI）。b)应支持 OSS 通过该接口配置 VNF 实例对应的管理对象实例。c)应支持 OSS 通过该接口删除 VNF 实例对应的管理对象实例。d)应支持 OSS 通过该接口在创建和删除 VNF 实例对应的管理对象实例后给 OSS 发送通知消息。e)应支持 EMS 通过该接口在 VNF 实例对应的管理对象实例的属性发生变化时给 OSS 发送通知消息。f)应支持 OSS 通过该接口订阅创建 VNF 实例对应的管理对象实例的通知消息。g)应支持 OSS 通过该接口订阅删除 VNF 实例对应的管理对象实例的通知消息。h)应支持 OSS 通过该接口订阅 VNF 实例对应的管理对象实例的属性发生变化的通知消息。5.2Ve-vnfm-em 接口配置管理需求 此接口用于VNF可配置参数处理。Ve-vnfm-em接口的配置管理功能需求如下：a)应支持 EMS 通过该接口修改 VNF/VNFC 实例的可配置参数。b)应支持 EMS 通过该接口查询 VNFM 所管理的 VNF 实例的信息。c)应支持 VNFM 通过该接口给 EMS 发送 VNF 实例的可配置参数发生变化的通知。d)应支持 EMS 通过该接口订购 VNF 实例的可配置参数发生变化的通知消息。注：查询操作在生命周期管理中实现。5.3Ve-vnfm-vnf 接口配置管理需求 此接口用于VNF可配置参数处理。YD/T XXXXXXXX4Ve-vnfm-vnf接口的配置管理功能需求如下：a)应支持 VNFM 通过该接口给 VNF/VNFC 实例设置初始参数。b)应支持 VNFM 通过该接口修改 VNF/VNFC 实例的配置参数。6网络功能虚拟化（NFV）配置管理接口分析 6.1Itf-N 接口分析 见 YD/T 3262-2017 的接口分析。6.2Ve-vnfm-em 接口分析 6.2.1 修改配置参数 描述描述：本操作用于修改一个 VNF 实例以及所有 VNFC 实例或个别 VNFC 实例的配置信息。EMS与VNFM之间的消息交互如表1所示。表 1 修改 VNF/VNFC 配置参数 消息 英文名称 必选M/条件必选C/可选O 方向 修改VNF配置请求 ModifyVnfConfigurationRequest M EMSVNFM 修改VNF配置应答 ModifyVnfConfigurationResponse M VNFMEMS 输入参数输入参数：修改VNF/VNFC配置参数操作时，发送输入参数说明见表2。表 2 修改 VNF/VNFC 配置参数的输入参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 VNF实例ID VnfInstanceId M 1 Identifier VNF实例标识 VNF配置数据 VnfConfigurationData M 0.1 VnfConfiguration VNF实例的配置数据注1 VNFC配置数据 VnfcConfigurationData M 0.N VnfcConfiguration VNFC实例相关配置数据注1注2 注1：0表示不需要修改VNF配置。注2：0用于不需要修改VNFC配置 输出参数输出参数：无 操作结果操作结果：操作结果会通过标准的成功/错误结果表明是否成功。操作成功时，VNF实例配置被修改，同时发送VnfConfigChangeNotification消息。YD/T XXXXXXXX56.2.2 订阅配置变更 描述描述：本操作用于 EMS 通过一个过滤器订阅 VNF 配置变更相关的通知，这个通知由 VNFM 发送。EMS与VNFM之间的消息交互如表3所示。表 3 订阅操作 消息 英文名称 必选M/条件必选C/可选O 方向 订阅请求 SubscribeRequest M EMSVNFM 订阅应答 SubscribeResponse M VNFMEMS 输入参数输入参数：订阅操作时，发送输入参数说明见表4。表 4 订阅操作的输入参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 过滤器 Filter M 1 Filter 用于选择感兴趣或指定的VNF实例配置变化 输出参数输出参数：订阅操作时，返回输出参数说明见表5。表 5 订阅操作的输出参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 订阅ID SubscriptionId M 1 Identifier 实现订阅的标识符 操作结果操作结果：成功订阅后，消费者（EMS）注册接收VNF配置参数变化的通知。操作结果会通过标准的成功/错误结果表明是否成功。特定的订阅，只有匹配过滤器的通知才会由生产者发送给消费者。6.2.3 取消订阅配置变更 描述描述：本操作用于EMS取消订阅VNF配置变更相关的通知。EMS与VNFM之间的消息交互如表6所示。表 6 取消订阅操作 消息 英文名称 必选M/条件必选C/可选O 方向 取消订阅请求 TerminatingSubscribeRequest M EMSVNFM 取消订阅应答 TerminatingSubscribeResponse M VNFMEMS 输入参数输入参数：取消订阅操作时，发送输入参数说明见表7。表 7 取消订阅操作的输入参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 订阅ID SubscriptionId M 1 Identifier 待取消的订阅的标识符 输出参数输出参数：无 YD/T XXXXXXXX6操作结果操作结果：操作结果会通过标准的成功/错误结果表明是否成功。在成功取消订阅后，EMS应当不再接收任何此类通知。6.2.4 通知配置变更 描述描述：本操作用于通知已订阅 VNF 实例变更的订阅者。此操作将通知分发给订阅服务器。它是由生产商（VNFM）出具的单向操作，不能作为消费者（EMS）调用操作。为了接收通知，消费者（EMS）必须预先执行显式订阅操作。EMS与VNFM之间的消息交互如表8所示。表 8 通知操作 消息 英文名称 必选M/条件必选C/可选O 方向 通知 Notify M VNFMEMS 输入参数输入参数：通知操作时，发送输入参数说明见表9。表 9 通知操作的输入参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 VNF实例ID VnfInstanceId M 1 Identifier VNF实例标识 变化的配置数据 ChangedConfig M 1 Not specified 变化的配置数据 输出参数输出参数：无 操作结果操作结果：无。后续章节中变化的配置数据根据实际应用来定义。6.3Ve-vnfm-vnf 接口分析 6.3.1 设置初始配置参数 描述描述：本操作用于 VNFM 给一个 VNF 实例以及所有 VNFC 实例或个别 VNFC 实例的设置初始配置参数。VNF与VNFM之间的消息交互如表10所示。表 10 初始参数配置操作 消息 英文名称 必选M/条件必选C/可选O 方向 设置初始参数配置请求 SetInitialConfigurationRequest M VNFMVNF 设置初始参数配置应答 SetInitialConfigurationResponse M VNFVNFM 输入参数输入参数：设置初始配置参数操作时，发送输入参数说明见表11。表 11 设置初始参数配置的输入参数 参数 英文名称 必选M/基数 类型 描述 YD/T XXXXXXXX7条件必选C/可选O VNF实例ID VnfInstanceId M 1 Identifier VNF实例标识 VNF配置数据 VnfConfigurationData M 0.1 VnfConfiguration VNF实例的配置数据a VNFC配置数据 VnfcConfigurationData M 0.N VnfcConfiguration VNFC实例相关配置数据b a 0表示用于只配置VNFC实例。b 0表示用于只配置VNF实例。注：VNF实例配置数据或VNFC配置数据至少包含一个。输出参数输出参数：设置初始配置参数操作时，输出参数说明见表12。表 12 设置初始参数配置的输出参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 VNF配置数据 VnfConfigurationData M 0.1 VnfConfiguration 对应于输入参数中VNF配置数据。VNFC配置数据 VnfcConfigurationData M 0.N VnfcConfiguration 对应于输入参数中VNFC配置数据 操作结果操作结果：操作完成后，生产者（VNF）应向消费者（VNFM）指示是否成功。6.3.2 修改配置参数 描述描述：本操作用于 VNFM 修改一个 VNF 实例以及所有 VNFC 实例或个别 VNFC 实例的配置参数。VNF与VNFM之间的消息交互如表13所示。表 13 修改配置参数操作 消息 英文名称 必选M/条件必选C/可选O 方向 修改配置参数请求 ModifyVnfConfigurationRequest M VNFMVNF 修改配置参数应答 ModifyVnfConfigurationResponse M VNFVNFM 输入参数输入参数：修改配置参数操作时，发送输入参数说明见表14。表 14 修改配置参数的输入参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 VNF实例ID VnfInstanceId M 1 Identifier VNF实例标识 YD/T XXXXXXXX8VNF配置数据 VnfConfigurationData M 0.1 VnfConfiguration VNF实例的配置数据a VNFC配置数据 VnfcConfigurationData M 0.N VnfcConfiguration VNFC实例相关配置数据b a.0表示用于只配置VNFC实例。b 0表示用于只配置VNF实例，注当信息元素都包括在内，它们是指不同的VNFC实例。输出参数输出参数：修改配置参数操作时，输出参数说明见表15。表 15 修改配置参数的输出参数 参数 英文名称 必选M/条件必选C/可选O 基数 类型 描述 VNF配置数据 VnfConfigurationData M 0.1 VnfConfiguration 对应于输入参数中VNF配置数据。VNFC配置数据 VnfcConfigurationData M 0.N VnfcConfiguration 对应于输入参数中VNFC配置数据 操作结果操作结果：操作完成后，生产者（VNF）应向消费者（VNFM）指示是否成功。7网络功能虚拟化（NFV）配置管理接口定义 7.1Itf-N 接口定义 见 YD/T 3262-2017 的接口定义。7.2Ve-vnfm-em 接口定义 7.2.1 接口定义概述 EMS-VNFM的接口宜使用Restful API。EMS-VNFM接口(Ve-Vnfm)Restful API的URI的接口定义要求，所有资源所使用的URI应当遵循apiRoot/apiName/apiVersion/前缀格式，其中：-apiRoot 指示所使用的协议是http 或者 https,主机名和对应的端口，以及其他可选的前缀路径；-apiName指示的是所使用的接口名字的简写方式；-apiVersion指示的是当前 API 所使用的版本。HTTP 请求和相应的结构体也可以遵循 JSON 的格式(参见 IETF RFC7159)，如果采用 JSON 的格式，应当指示 content type 是 application/json.所有的 API 可以使用 HTTP Over TLS 的形式即HTTPS 的传输方式传送消息。VNF-VNFM 接口(Ve-Vnfm-vnf)Restful API 的 URI 的接口过程参见 ETSI GS NFV-SOL 002 第9 章节。YD/T XXXXXXXX97.2.2 资源与对应 HTTP 方法的映射关系表 用于指明该 URI 资源对应的操作内容。命令方式与说明见表 16。表 16 Ve-vnfm-em 接口配置管理资源与 HTTP 方法的映射关系 归属接口 对应接口资源操作 操作名称 对应的HTTP方法 资源URI EMS-VNFM 修改配置参数 ModifyVnfConfiguration PATCH vnfconfig/v1/configuration EMS-VNFM 订阅配置变更 Subscribe POST vnfconfig/v1/subscriptions EMS-VNFM 取消订阅配置变更 TerminatingSubscribe DELETE vnfconfig/v1/subscriptions/subscriptionId VNFM-EMS 通知配置变更 Notify POST vnfconfig/v1/notification 7.2.3 API 资源定义 7.2.3.1 修改配置参数 EMS 与 VNFM 之间修改配置参数 API 资源定义见表 17。表 17 EMS 与 VNFM 之间修改配置参数 API 资源定义 参数 必选/可选 描述 VnfInstanceId M VNF 实例标识 VnfInstanceName O VNF 实例名称 VnfType O VNF 类型 VnfcConfigurationData O 虚机集合，每个虚机参数包含 VDUID、VMID、VMName 以及 NicData 等 VduId O 虚机所属 VDU 标识 VmId O 虚机 UUID VmName O 虚机名称 NicData O 虚机网口数据，包含 Name,Order,IP,MAC。NicName O 网口名 Order O 网口顺序 Ip O 网口 IP 地址 Mac O 网口 MAC 地址 VnfConfiguratinData O 扩展配置参数集合，每个参数包含配置项名称和值 Name O 配置项名称 请求 消息体 Value O 配置项值 参数 必选/可选 响应代码 描述 无 M 201 Created 修改成功 响应 消息体 ProblemDetails C 4xx/5xx 适用于 PATCH 方法的通用错误代码 YD/T XXXXXXXX107.2.3.2 订阅配置变更 订阅配置管理变更 API 定义见表 18。表 18 订阅配置管理变更 API 定义 参数 必选/可选 描述 CreateConfigSubscriptionRequest M 订阅配置管理通知的请求 Filter O 订阅的过滤器设置，以定义所涉及订阅全集中的子集。如果匹配过滤器，或者没有过滤器，则会向订阅者发送特定通知。请求 消息体 CallbackUri M 发送通知所至端点的 URI。参数 必选/可选 响应代码 描述 ConfigSubscription M 配置管理订阅创建成功 HTTP 响应消息中应包含“Location”头域以指向已创建的订阅资源 Id M 订阅标识的表示 Filter O 此订阅的过滤器设置，以定义本订阅所涉及的所有通知的子集。以定义所涉及订阅全集中的子集。如果匹配过滤器，或者没有过滤器，则会向订阅者发送特定通知。CallbackUri M 201 Created 发送通知所至端点的 URI。响应 消息体 ProblemDetails C 4xx/5xx 适用于 POST 方法的通用错误代码 7.2.3.3 取消订阅配置变更 取消订阅配置变更 API 定义见表 19。表 19 取消订阅配置变更 API 定义 参数 必选/可选 描述 请求 消息体 SubscriptionId M 待取消的订阅的标识符 参数 必选/可选 响应代码 描述 无 M 204 No Content 配置管理订阅删除成功。成功的响应消息体应为空。响应 消息体 ProblemDetails C 4xx/5xx 适用于 DELETE 方法的通用错误代码 7.2.3.4 通知配置变更 通知配置变更 API 定义见表 20。表 20 通知配置变更 API 定义 请求 参数 必选/可选 描述 YD/T XXXXXXXX11VnfInstanceId M VNF 实例标识 VnfInstanceName O VNF 实例标识名称 VnfType O VNF 类型 TimeStamp M 时间戳 EventType M 事件类型 instantiate scaleout scalein terminate Status C 只 有 EventType为scaleout、scalein和terminate 时，必须有值 生命周期操作结果 finished failed StatusDescription C 在 Status 为 failed时，必须有值 状态描述 VnfcConfigurationData O 虚机集合，每个虚机参数包含 VDUID、VMID、VMName 以及 NicData 等 VduId O 虚机所属 VDU 标识 VmId O 虚机 UUID VmName O 虚机名称 NicData O 虚机网口数据，包含 Name,Order,IP,MAC。NicName O 网口名 Order O 网口顺序 Ip O 网口 IP 地址 Mac O 网口 MAC 地址 VnfConfiguratinData O 扩展配置参数集合，每个参数包含配置项名称和值 Name O 配置项名称 消息体 Value O 配置项值 参数 必选/可选 响应代码 描述 无 M 204 No Content 通知发送成功 响应 消息体 ProblemDetails C 4xx/5xx 适用于 POST 方法的通用错误代码 7.3Ve-vnfm-vnf 接口定义 7.3.1 接口定义概述 见 7.2.1 节描述。YD/T XXXXXXXX127.3.2 资源与对应 HTTP 方法的映射关系表 用于指明该 URI 资源对应的操作内容。命令方式与说明见表 21。表 21 Ve-vnfm-vnf 接口配置管理资源与 HTTP 方法的映射关系 归属接口 对应接口资源操作 操作名称 对应的HTTP方法 资源URI VNFM-VNF 设置初始配置参数 SetInitialConfiguration POST vnfconfig/v1/configuration VNFM-VNF 修改配置参数 ModifyVnfConfiguration PATCH vnfconfig/v1/configuration 7.3.3 API 资源定义 7.3.3.1 设置初始配置参数 VNFM 与 VNF 之间设置初始配置参数 API 资源定义见表 22。表 22 VNFM 与 VNF 之间设置初始配置参数 API 资源定义 参数 必选/可选 描述 VnfInstanceId M VNF 实例标识 VnfInstanceName M VNF 实例名称 VnfType M VNF 类型 VnfcConfigurationData M 虚机集合，每个虚机参数包含 VDUID、VMID、VMName 以及 NicData 等 VduId M 虚机所属 VDU 标识 VmId M 虚机 UUID VmName M 虚机名称 NicData M 虚机网口数据，包含 Name,Order,IP,MAC。NicName M 网口名 Order M 网口顺序 Ip M 网口 IP 地址 Mac M 网口 MAC 地址 VnfConfiguratinData O 扩展配置参数集合，每个参数包含配置项名称和值 Name O 配置项名称 请求 消息体 Value O 配置项值 参数 必选/可选 响应代码 描述 无 M 201 Created 修改成功 响应 消息体 ProblemDetails C 4xx/5xx 适用于 POST 方法的通用错误代码 YD/T XXXXXXXX137.3.3.2 修改配置参数 VNFM 与 VNF 之间修改配置参数 API 资源定义见表 23。表 23 VNFM 与 VNF 之间修改配置参数 API 资源定义 参数 必选/可选 描述 VnfInstanceId M VNF 实例标识 VnfInstanceName O VNF 实例名称 VnfType O VNF 类型 VnfcConfigurationData O 虚机集合，每个虚机参数包含 VDUID、VMID、VMName 以及 NicData 等 VduId O 虚机所属 VDU 标识 VmId O 虚机 UUID VmName O 虚机名称 NicData O 虚机网口数据，包含 Name,Order,IP,MAC。NicName O 网口名 Order O 网口顺序 Ip O 网口 IP 地址 Mac O 网口 MAC 地址 VnfConfiguratinData O 扩展配置参数集合，每个参数包含配置项名称和值 Name O 配置项名称 请求 消息体 Value O 配置项值 参数 必选/可选 响应代码 描述 无 M 201 Created 修改成功 响应 消息体 ProblemDetails C 4xx/5xx 适用于 PATCH 方法的通用错误代码 YD/T XXXXXXXX14附录附录A A (资料性附录资料性附录)配置管理流程配置管理流程 A.1 EMS 与 VNFM 之间修改配置参数流程 图 A.1 EMS和VNFM之间修改配置参数流程 过程如图A.1所示，描述如下：前置条件前置条件：VNF实例和VNFC实例已创建 1)EMS向VNFM发送PATCH请求,携带配置参数,对应的URI为./configuration/(VnfConfigModifications)；VnfconfigModifations中是消息净荷。2)VNFM进行配置数据处理；3)VNFM返回201 OK消息，指示成功。YD/T XXXXXXXX15A.2 EMS 与 VNFM 之间订阅与取消订阅变更以及通知流程 图A.2 EMS与VNFM之间订阅与取消订阅变更以及通知流程 过程如图A.2所示，描述如下：1)EMS向VNFM发出一个“POST”订购请求，该请求包含“ConfigSubscriptionRequest”数据。该数据结构中包含过滤条件与客户侧URI，VNFM后续将向该客户侧URI发送符合过滤条件的通知。2)VNFM创建配置管理订阅。3)VNFM返回“201 Created”消息，该消息包含一个“ConfigSubscription”数据，并且该消息的HTTP头部分“Location”字段中提供VNFM侧所创建的订购资源URI。4)VNFM向EMS通过POST发送通知消息，携带VnfInstanceId等数据。5)EMS确认接收到通知消息，向EMS发出“204 No Content”消息。6)当EMS不再需要该订购服务时，EMS将发出一个“DELETE”请求，该请求中包含指定需要终止的通知。7)VNFM 确认订购终止后，向 EMS 发出“204 No Content”消息。A.3 VNFM 与 VNF 之间设置初始配置参数流程 YD/T XXXXXXXX16 A.3 VNFM与VNF之间设置初始配置参数流程 过程如图A.3所示，描述如下：1)VNFM向VNF发送POST请求,设置初始配置参数,对应的URI为./configuration/(VnfConfigModifications)；VnfconfigModifations中是消息净荷。2)VNF 实例或 VNFC 实例设置配置参数；3)VNF 返回 201 OK 消息，指示设置配置参数成功。后置条件后置条件：VNF 实例和（或）VNFC 实例配置生效。A.4 VNFM 与 VNF 之间修改配置参数流程 A.4 VNFM与VNF之间修改配置参数流程 过程如图A.4所示，描述如下：YD/T XXXXXXXX17前置条件前置条件：VNF实例和VNFC实例已创建 1)VNFM 向 VNF 发送 PATCH 请求,修改配置参数,对应的 URI为./configuration/(VnfConfigModifications)；VnfconfigModifations中是消息净荷。2)VNF 实例或 VNFC 实例设置配置参数；3)VNF 返回 201 OK 消息，指示设置配置参数成功。后置条件后置条件：VNF 实例和（或）VNFC 实例配置生效。YD/T XXXXXXXX18附录附录B B (规范性附录规范性附录)数据结构定义数据结构定义 B.1 配置数据结构定义 配置数据结构定义见表 B.1。表 B.1 配置数据结构定义 参数名称 数据类型 参数要求 VnfInstanceId string 由 VNFM 分配,在 VNFM 作用域唯一 VnfInstanceName string VNF 实例名 VnfType string VNF 类型，来源于 VNFD 中的定义 VmList array 虚机集合，每个虚机参数包含 VDUID、VMID、VMName 以及 NicData 等 VduId string 虚机所属 VDU 标识，来源于 VNFD 中VDU 节点名 VmId string 虚机的 UUID VmName string 虚机名 NicData array 虚机网口数据 NicName string 虚机网口名 Order string 虚机网口序号，从 0 开始编号 Ip string 虚机网口 IP Address Mac string 虚机网口 Mac Address Name string 配置项名称 Value string 配置项值 B.2 订阅数据结构定义 订阅数据结构定义见表 B.2。表 B.2 订阅数据结构定义 参数名称 数据类型 参数要求 Filter Filter 过滤器，指定的 VNF 实例配置变化 SubscriptionId string 订阅 ID CallbackUri Uri 发送通知的端点的 URI。YD/T XXXXXXXX19B.3 订阅过滤器 Filter 数据结构定义 订阅过滤器 Filter 数据结构定义见表 B.3。表 B.3 订阅过滤器Filter数据结构定义 参数名称 数据类型 参数要求 VnfInstances List VNF 实例列表，可选参数 VnfTypes List VNF 类型列表,可选参数 StartTime string 开始时间，YYYYMMDDHHMMSS，可选参数 EndTime string 结束时间，YYYYMMDDHHMMSS，可选参数 B.4 通知数据结构定义 通知数据结构定义见表 B.4。表 B.4 通知数据结构定义 参数名称 数据类型 参数要求 VnfInstanceId string 由 VNFM 分配,在 VNFM 作用域唯一 VnfInstanceName string VNF 实例名 VnfType string VNF 类型，来源于 VNFD 中的定义 TimeStamp string 时间戳，YYYYMMDDHHMMSS EventType string 事件类型 instantiate scaleout scalein terminate Status string 生命周期操作结果 finished failed StatusDescription string 状态描述，在Status为failed时，必须有值 YD/T XXXX
