V2.1 Delete File


删除单个资产的文件。

该 API 支持在 EnOS 2.1.0 及以上环境中使用。

操作权限


使用此 API 前,确保服务账号已被授予包含下列服务和操作权限的策略。有关授权服务账号的更多信息,参见 管理服务账号


需授权的服务 所需操作权限
资产 Write

请求格式

POST https://{integration-address}/connect-service/v2.1/files?action=delete

注解

{integration-address}:消息集成服务网关地址。该信息可登录 EnOS 管理控制台 ,在 帮助 > 环境信息 > HTTP 消息集成通道 中获取。

请求参数(URI)

注解

必须在请求参数中使用以下任意一个参数或参数组合以指定资产:

  • assetId 以指定一个设备或一个逻辑资产。
  • productKey + deviceKey 以指定一个设备。
名称 位置(Path/Query) 必需/可选 数据类型 描述
orgId Query 必需 String 资产所属的组织 ID。如何获取 orgId 信息>>
fileUri Query 必需 String 文件下载uri,格式:enos-connect://xxxx 。
assetId Query 可选(见上述注解) String 资产 ID。如何获取 assetId 信息>>
productKey Query 可选(见上述注解) String 设备的 product key,需与 deviceKey 一起使用。
deviceKey Query 可选(见上述注解) String 设备的 device key,需与 productKey 一起使用。

示例

请求示例

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": {}
}

SDK 示例


你可以在 Github 上获取接入服务的 SDK 示例: