服务账号所需权限¶
通过应用进行以下操作前，必须对应用的服务账号进行授权：
应用程序通过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 |
其他EnOS API服务¶
无特别的权限要求。
消费订阅数据¶
在创建数据订阅任务时，数据订阅任务关联的服务帐号必须已被授予资产数据的“Read”权限，否则订阅任务会认证失败，而不能成功订阅数据。