服务账号所需权限
通过应用进行以下操作前，必须对应用的服务账号进行授权：
- 应用程序通过API访问EnOS上的资源
- 通过配置数据订阅任务，消费订阅数据
本文介绍进行 EnOS API 服务调用、消费订阅数据等操作时，需要对服务帐号授予的具体权限。
API 服务调用
调用 EnOS API 需要的权限如下：
模型服务
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Get Thing Model |
模型管理 |
Read |
| Search Thing Model |
模型管理 |
Read |
接入服务
产品
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Create Product |
设备管理 |
Full Access |
| Delete Product |
设备管理 |
Full Access |
| Get Product |
设备管理 |
Read |
| Search Product |
设备管理 |
Read |
| Update Product |
设备管理 |
Full Access |
设备
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Create Device |
设备管理 |
Full Access |
| Delete Device |
设备管理 |
Full Access |
| Disable Device |
设备管理 |
Full Access |
| Enable Device |
设备管理 |
Full Access |
| Get Device |
设备管理 |
Read |
| Replace Device |
设备管理 |
Full Access |
| Search Device |
设备管理 |
Read |
| Update Device |
资产 |
Write |
| Get Device Statistics |
设备管理 |
Read |
证书
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Apply Certificate |
设备管理 |
Full Access |
| Renew Certificate |
设备管理 |
Full Access |
| Revoke Certificate |
设备管理 |
Full Access |
| List Certificate |
设备管理 |
Read |
网关与子设备
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Add Sub-Device |
设备管理 |
Full Access |
| Get Gateway |
设备管理 |
Read |
| Remove Sub-Device |
设备管理 |
Full Access |
| Search Sub-Device |
设备管理 |
Read |
设备数据
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Cancel Command |
资产 |
Control |
| Get Command |
资产 |
Read |
| Get Event |
资产 |
Read |
| Get Latest Measurement Points |
设备管理 |
Read |
| Invoke Service |
资产 |
Control |
| Search Command |
资产 |
Read |
| Search Event |
资产 |
Read |
| Set Measurepoint Point |
资产 |
Control |
| Delete File |
资产 |
Write |
| Download File |
资产 |
Read |
HTTP 消息集成
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Upload Attribute |
资产 |
Write |
| Upload Events |
资产 |
Write |
| Upload Measurement Points |
资产 |
Write |
固件管理
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Create Firmware File |
设备管理 |
Full Access |
| Get Firmware File |
设备管理 |
Read |
| List Device Current Firmware |
设备管理 |
Read |
| Search Firmware File |
设备管理 |
Read |
| Search Device Upgrade |
设备管理 |
Read |
| Delete Firmware |
设备管理 |
Full Access |
OTA 固件升级管理
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Create OTA Job |
设备管理 |
Full Access |
| Get OTA Job |
设备管理 |
Read |
| Search OTA Job |
设备管理 |
Read |
| Search OTA Task |
设备管理 |
Read |
| Start OTA Job |
设备管理 |
Full Access |
| Stop OTA Job |
设备管理 |
Full Access |
| Delete OTA Job |
设备管理 |
Full Access |
| Cancel OTA Task |
设备管理 |
Full Access |
| Retry OTA Task |
设备管理 |
Full Access |
资产服务
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Get Asset |
资产树管理 |
Read |
| Update Asset |
资产树管理 |
Full Access |
| Create Logical Asset |
资产树管理 |
Full Access |
| Update Logical Asset |
资产树管理 |
Full Access |
| Delete Logical Asset |
资产树管理 |
Full Access |
资产树服务
资产树
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Create Asset Tree |
资产树管理 |
Full Access |
| Create Asset Tree and Associate Asset |
资产树管理 |
Full Access |
| Delete Asset Tree |
资产树管理 |
Full Access |
| Get Asset Tree |
资产树管理 |
Read |
| Search Asset Tree |
资产树管理 |
Read |
| Update Asset Tree |
资产树管理 |
Full Access |
资产树节点
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Associate Asset |
资产树管理 |
Full Access |
| Create and Associate Asset |
资产树管理 |
Full Access |
| Delete Asset Node |
资产树管理 |
Full Access |
| Search Asset Node |
资产树管理 |
Read |
| Search Related Asset Node |
资产树管理 |
Read |
| Get Asset Trees |
资产树管理 |
Read |
| Search Asset Path |
资产树管理 |
Read |
TSDB 数据服务
| API 名称 |
需授权的服务 |
操作权限 |
|---|
| Filter Asset Latest Data |
资产 |
Read |
| Get Asset AI Data with Aggregation Logic |
资产 |
Read |
| Get Asset AI Raw Data |
资产 |
Read |
| Get Asset Current Day Electric Power |
资产 |
Read |
| Get Asset DI Data |
资产 |
Read |
| Get Asset DI Data Duration |
资产 |
Read |
| Get Asset Electric Power Data |
资产 |
Read |
| Get Asset Generic Data |
资产 |
Read |
| Get Asset Latest Data |
资产 |
Read |
| Get Asset Raw Data By Time Range |
资产 |
Read |
消费订阅数据
在创建数据订阅任务时，数据订阅任务关联的服务帐号必须已被授予资产数据的“Read”权限，否则订阅任务会认证失败，而不能成功订阅数据。