Download File¶
下载单个资产的文件。
操作权限¶
需授权的资源 |
所需操作权限 |
|---|---|
资产 |
Read |
请求格式¶
GET https://{integration-address}/connect-service/v2.1/files?action=download
备注
{integration-address}：消息集成服务网关地址。该信息可登陆 EnOS 管理控制台 ，在 帮助 > 环境信息 > HTTP消息集成通道 中获取。
请求参数（URI）¶
备注
必须在请求参数中使用以下任意一个参数或参数组合以指定资产：
assetId以指定一个设备或一个逻辑资产productKey+deviceKey以指定一个设备
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织ID。如何获取orgId信息>> |
fileUri |
Query |
必需 |
String |
文件下载uri，格式：enos-connect://xxxx 。 |
category |
Query |
必需 |
String |
需要下载的文件类别。模型功能相关的文件，如属性、测点、事件，值为 |
assetId |
Query |
可选 |
String |
资产ID。 |
productKey |
Query |
可选 |
String |
设备资产的product key。 |
deviceKey |
Query |
可选 |
String |
设备资产的device key。 |
请求参数(Header)¶
名称 |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|
apim-accesstoken |
必需 |
String |
通过Token认证获取的access token。获取方法，参见 获取Access Token>> |
响应参数¶
名称 |
数据类型 |
描述 |
|---|---|---|
文件的二进制数据流 |
output stream |
返回文件输出流。 |
示例¶
请求示例¶
url: https://{integration-address}/connect-service/v2.1/files?action=download&orgId=yourOrgId&fileUri=yourFileUri&assetId=yourAssetId&category=feature
method: GET
requestHeader: {"apim-accesstoken":"yourAccessToken"}