使用前必读
欢迎使用路网数字化服务（Digital Road Infrastructure Service，DRIS），本服务通过车路协同、物联网等智能技术，打造人、车、路、云的全面协同，构建协作式的智慧交通，使能协同式的自动驾驶，给出行者提供更安全、更高效、更便捷的出行，给管理者提供全路段感知、全天候通行、全过程管控的智慧运营。
您可以使用本文档提供的API对道路设备和感知事件等资源进行相关操作，如RSU资源管理、交通事件资源管理等，支持的全部操作请参见API概览。业务数据开放接口的数据集定义满足标准编号为YD/T 3709-2020的《基于LTE的车联网无线通信技术 消息层技术要求》以及标准编号为TCSAE 53-2017的《合作式智能运输系统 车用通信系统应用层及应用数据交互标准》的标准要求。
在调用DRIS API之前，请确保已经充分了解路网数字化服务相关概念，详细信息请参见产品介绍。
调用说明
路网数字化服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。
终端节点
终端节点（Endpoint）即调用API的请求地址，您可以直接访问地区和终端节点获取路网数字化服务的终端节点。
路网数字化服务的终端节点如下表所示，请您根据业务需要选择对应区域的终端节点。
|
区域名称 |
区域 |
终端节点（Endpoint） |
|---|---|---|
|
华北-北京四 |
cn-north-4 |
ocv2x-api.cn-north-4.myhuaweicloud.com |
约束与限制
- 您能创建的DRIS资源的数量与配额有关系，具体请参见服务配额。
- 更详细的限制请参见具体API的说明。
基本概念
-
用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。
-
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。
您可以在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
-
从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。
详情请参见区域和可用区。
-
一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
- 项目
区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。
图1 项目隔离模型
同样在我的凭证下，您可以查看项目ID。
- 企业项目
企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。
关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理服务用户指南》。
