V2.1 Delete File¶
删除单个产品的文件。
该 API 支持在 EnOS 2.1.0 及以上环境中使用。
操作权限¶
确保已获取调用该 API 的权限。更多信息，参见 获取 API 调用权限。
请求格式¶
POST https://{integration-address}/connect-service/v2.1/files?action=delete
备注
{integration-address}：消息集成服务网关地址。该信息可登录 EnOS 应用门户 > 开发者控制台，在 帮助 > 环境信息 > HTTP 消息集成通道 中获取。
请求参数（URI）¶
备注
必须在请求参数中使用以下任意一个参数或参数组合以指定文件。
assetId以指定一个设备或一个逻辑文件。productKey+deviceKey以指定一个设备。
名称 |
位置（Path/Query） |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|---|
orgId |
Query |
必需 |
String |
文件所属的 OU ID。如何获取 orgId 信息>> |
fileUri |
Query |
必需 |
String |
文件下载uri，格式：enos-connect://xxxx 。 |
assetId |
Query |
可选（见上述注解） |
String |
文件 ID。如何获取 assetId 信息>> |
productKey |
Query |
可选（见上述注解） |
String |
设备的 product key，需与 |
deviceKey |
Query |
可选（见上述注解） |
String |
设备的 device key，需与 |
请求参数（Header）¶
名称 |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|
apim-accesstoken |
必需 |
String |
通过 token 认证获取的 access token。获取方法，参见 获取 Access Token。 |
示例¶
请求示例¶
url: https://{integration-address}/connect-service/v2.1/files?action=delete&orgId=yourOrgId&fileUri=yourFileUri&assetId=yourAssetId
method: POST
requestHeader:
{
"apim-accesstoken":"xxxxaaaxxxx"
}
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "6a02a5a5-49f0-4df1-b364-496ad2079033",
"data": {}
}