ETSI TS 118 109 V4.4.1(2023-12)是欧洲电信标准协会发布的oneM2M HTTP协议绑定技术规范,作为oneM2M TS-0009第4.4.1版本Release 4的重要组成部分。该标准定义了oneM2M兼容系统使用的通信协议特定部分,特别是RESTful HTTP绑定机制。
本标准的核心在于建立oneM2M协议原语与HTTP消息之间的精确映射关系。规范详细定义了四种使用场景的映射机制:请求原语到HTTP请求消息、HTTP请求消息到请求原语、响应原语到HTTP响应消息、HTTP响应消息到响应原语。
| oneM2M操作 | HTTP方法 | 应用场景 |
|---|---|---|
| Create | POST | 资源创建操作 |
| Retrieve | GET | 资源检索操作 |
| Update | PUT | 资源更新操作 |
| Delete | DELETE | 资源删除操作 |
| Notify | POST | 通知发送操作 |
特别需要注意的是,POST方法需要根据Content-Type头部区分Create和Notify操作,当Content-Type包含资源类型参数时表示Create请求,否则表示Notify请求。
规范详细定义了三种资源标识符格式到HTTP请求目标路径组件的映射规则:
| 资源ID类型 | To参数示例 | 路径组件格式 |
|---|---|---|
| 结构化CSE相对 | CSEBase/ae12/cont27/contInst696 | /CSEBase/ae12/cont27/contInst696 |
| 非结构化CSE相对 | cin00856 | /cin00856 |
| 结构化SP相对 | /CSE178/CSEBase/ae12/cont27 | /~/CSE178/CSEBase/ae12/cont27 |
| 绝对资源ID | //mym2msp.org/CSE178/cin00856 | /_/mym2msp.org/CSE178/cin00856 |
查询组件承载了可选的原语参数,包括响应类型、结果持久性、过滤条件等20余个参数,采用field-name=value格式,多个参数间用&符号分隔。
标准定义了oneM2M响应状态码到HTTP状态码的精确实时映射关系,由于oneM2M状态码比HTTP状态码更加详细,多个oneM2M状态码可能映射到同一个HTTP状态码。
| oneM2M状态码 | HTTP状态码 | 描述 |
|---|---|---|
| 2000-2004 | 200 OK | 成功操作 |
| 2001 | 201 Created | 资源创建成功 |
| 1000-1002 | 202 Accepted | 请求已接受 |
| 4000系列 | 400 Bad Request | 客户端错误 |
| 4103 | 403 Forbidden | 权限不足 |
| 4004 | 404 Not Found | 资源未找到 |
| 5000系列 | 500 Internal Error | 服务器内部错误 |
原始oneM2M响应状态码通过X-M2M-RSC头部传递,确保详细的错误信息不丢失。
规范定义了28个专用的X-M2M-*头部字段,用于承载oneM2M特定的协议参数:
| 头部字段 | 映射参数 | 功能描述 |
|---|---|---|
| X-M2M-Origin | From参数 | 请求源标识 |
| X-M2M-RI | Request Identifier | 请求标识符 |
| X-M2M-RSC | Response Status Code | 响应状态码 |
| X-M2M-RVI | Release Version Indicator | 版本指示器 |
| Authorization | Tokens参数 | 认证令牌 |
| X-M2M-AS | Authorization Signature | 授权签名 |
这些头部字段确保了oneM2M协议丰富的元数据信息在HTTP协议中的完整传递。
规范支持双层次认证:使用Proxy-Authorization头部向注册CSE提交凭据,使用Authorization头部向托管CSE提交凭据。当使用OAuth 2.0兼容的访问令牌时,必须使用Bearer认证方案。
HTTP消息中的oneM2M原语参数可以通过TLS进行逐跳保护。虽然ETSI TS 118 103支持端到端凭据的配置,但非相邻节点间建立安全关联的协议不在本标准范围内。
附录B规定了WebSocket协议在通知传输中的应用。对于不具备服务器能力或无法接收非请求消息的AE/CSE,WebSocket提供了有效的解决方案。
当AE需要从CSE接收通知消息时,AE与CSE建立WebSocket连接。新通知消息生成后,将作为WebSocket的数据帧发送给AE,实现了高效的双向通信。
在实施oneM2M HTTP绑定时,建议采用分层架构设计:
针对大规模物联网部署,建议:
安全实施应遵循:
本标准作为Release 4版本,在之前版本基础上增加了对WebSocket通知、增强的安全机制和更精细的状态码映射的支持。实施时应确保向后兼容性,特别是处理4001(RELEASE_VERSION_NOT_SUPPORTED)状态码的场景。
随着物联网技术的快速发展,预计未来版本将进一步完善对HTTP/2、QUIC等新协议的支持,并提供更强大的安全功能和性能优化机制。
请注意,本内容不等同于标准原文,请参阅正式版文本。

点击查看大图
本文件涵盖了一M2M兼容系统使用的通信协议的协议特定部分,作为RESTful HTTP绑定。 本文件的范围包括(但不限于以下内容): ? 将一M2M协议原语类型绑定到HTTP方法。 ? 将一M2M响应状态码(成功/不成功)绑定到HTTP响应码。 ? 将一M2M RESTful资源绑定到HTTP资源。 本文件依赖于核心协议规范(ETSI TS 118 104 ...
Copyright ?2007-2026 ANTPEDIA, All Rights Reserved
京ICP备07018254号 京公网安备1101085018 电信与信息服务业务经营许可证:京ICP证110310号
页面更新时间: 2026-07-27 10:19