美利体育登录入口官网

美利体育登录入口官网:ITU-T X.785-2021
定义基于 REST 的托管对象和管理接口的指南

Guidelines for defining REST-based managed objects and management interfaces


标准制定背景与技术演进

ITU-T X.785(2021年7月发布)是电信管理网络(TMN)领域向REST架构转型的关键标准。传统网络管理协议如CMIP、SNMP、CORBA及SOAP虽成熟,但存在复杂性高、耦合紧密等问题。随着IT行业REST/HTTP技术的广泛应用(如云管理、IoT),网络管理接口亟需轻量化、松耦合的方案。该标准基于ITU-T M.3020方法论,将REST范式正式引入TMN,定义了管理对象建模、资源访问方法及信息模型指南,填补了REST在电信管理中的标准化空白。


RESTful管理框架概述

框架核心包括:资源(URI标识)、表示(JSON/YAML)和操作(HTTP方法)。资源分为三类:文档资源(单个实体)、集合资源(同类资源列表)和操作资源(RPC风格功能)。管理对象(MO)的状态通过JSON/YAML Schema描述,行为通过REST API暴露。标准采用YAML作为主定义语言,因其可读性优于JSON,且YAML是JSON的超集。

维度传统CMIP/GDMORESTful HTTP
协议CMIP(OSI栈)HTTP/1.1
对象标识Distinguished Name (DN)URI
创建/读取/更新/删除M-CREATE, M-GET, M-SET, M-DELETEPOST, GET, PUT/PATCH, DELETE
数据模型ASN.1/GDMOJSON/YAML Schema
耦合性紧密耦合松耦合

通用管理对象类定义

所有管理对象类需继承自基类ManagedObject_C,包含三个强制属性:objectClass(类名)、objectInstance(URI格式的实例标识)、creationSource(创建来源)。YAML Schema定义如下:

ManagedObject_C:
  type: object
  required: [- objectClass, - objectInstance]
  properties:
    objectClass: {type: string}
    objectInstance: {type: string, format: uri}
    creationSource: {$ref: '...'}

继承关系通过YAML的allOf实现,例如Equipment_C继承ManagedObject_C并扩展ID、userLabel等属性。多重继承也受支持。


包含关系与关联关系建模

包含关系(Containment)用ContainmentRelationshipType描述,例如一个EquipmentHolder可包含多个CircuitPack,通过superiorClass、subordinateClass和multiplicity定义。关联关系(Association)用AssociationRelationshipType描述,支持双向关联,如Trail与LinkConnection之间的关联。这些类型以YAML Schema形式提供,便于程序解析。

关系类型属性示例
ContainmentcontainmentRelationshipName, superiorClass, subordinateClass, multiplicityEquipmentHolder包含CircuitPack (1:0..n)
AssociationassociationRelationshipName, direction, fromClass, toClass, associationAttributeTrail与LinkConnection双向关联

通用访问方法(CRUD)

标准定义了基于HTTP方法的通用MO访问服务(MOAccessService),包括:

  • createMO(POST):创建MO实例,返回201和Location头。
  • getMOAttributes(GET):读取全部或部分属性,支持查询参数。
  • setMOAttributes(PATCH):部分更新属性,支持JSON Merge Patch。
  • deleteMO(DELETE):删除实例,返回204。

标准还提供了具体资源(如Equipment)的CRUD示例,URI遵循/Network={id}/ManagedElement={id}/Equipment={id}模式。


信息建模规范与实施建议

信息建模应遵循:MOC名称以'_C'结尾,属性首字母小写,数据类型以'Type'结尾。通用操作映射为HTTP方法,路径参数用于标识资源。实施建议:

  • 所有新接口应继承ManagedObject_C,并遵循YAML/JSON Schema。
  • 利用OpenAPI 3.0规范定义接口文档,确保可读性和自动化。
  • 使用标准HTTP状态码(200, 201, 204, 400, 404, 409, 500等)。
  • 对频繁访问的集合资源启用缓存,提高性能。
  • 支持JSON Patch和Merge Patch以优化部分更新。

标准对比:合规性与一致性

标准文档合规要求:所有MOC必须直接或间接继承ManagedObject_C,使用通用数据类型,遵循命名约定。系统一致性要求:要么支持通用MO访问方法,要么支持特定MO的CRUD。一致性声明需指明YAML/JSON schema版本。


案例:Equipment资源CRUD实现

附录I给出了Equipment资源的完整YAML定义:Equipment_C继承自ManagedObject_C,包含equipmentId、serialNumber等属性。操作包括:

  • POST /Network/{n}/ManagedElement/{m}/Equipment → 创建美利体育官网首页网址
  • GET /.../Equipment → 获取美利体育官网首页网址列表
  • GET /.../Equipment={id} → 获取单个美利体育官网首页网址
  • PUT /.../Equipment={id} → 完全替换
  • PATCH /.../Equipment={id} → 部分更新
  • DELETE /.../Equipment={id} → 删除

这些示例可作为开发者的模板。


技术优势与挑战

REST引入网络管理的主要优势:互操作性强、松耦合、成本低、行业广泛支持。挑战包括:状态管理(HTTP无状态需借助客户端或令牌)、批量操作支持不足、通知机制需额外定义(如WebSocket)。标准已规划后续补充:REST-based通知、心跳、包含服务。

 

请注意,本内容不等同于标准原文,请参阅正式版文本。

 

 

ITU-T X.785-2021

点击查看大图

标准号
ITU-T X.785-2021
发布
2021年
ICS
35.100.70
总页数
58页
发布单位
国际电信联盟
当前最新
ITU-T X.785-2021
 
 
引用标准
RFC 5789 RFC 6585 RFC 6901 RFC 6902 RFC 7230 RFC 7231 RFC 7232 RFC 7396
 
 
本体
管理对象类

本建议书提出了一个框架,用于定义管理系统和网络元素支持的接口应如何使用JSON/YAML模式进行建模。本建议书的范围包括提供以下指南或说明: - REST接口设计原则; - 管理实体的包含、关联和继承关系及命名规则; - 管理对象的通用访问方法; - 定义特定资源访问方法的指南; - 基于REST的接口的信息建模指南; - 通用数据类型定义。

术语 
代理 agent
管理对象类 managed object class
管理者 manager
通知 notification

美利体育登录入口官网: 专题


美利体育登录入口官网: ITU-T X.785-2021相似标准





Copyright ?2007-2026 ANTPEDIA, All Rights Reserved
京ICP备07018254号 京公网安备1101085018 电信与信息服务业务经营许可证:京ICP证110310号
页面更新时间: 2026-09-14 19:56

美利体育(meili)官方网站_美利体育手机版下载