物联网平台支持设备通过MQTT协议,将文件上传至用户的OSS空间或者物联网平台文件存储空间,以减少硬件资源的开销,并降低开发成本。本文介绍通过配置C Link SDK,帮助设备实现文件上传功能。
前提条件
定制SDK时,在SDK定制页面的高级能力区域,选中文件上传。
背景信息
物联网平台文件管理功能的更多信息,请参见文件管理。
设备将文件上传至物联网平台后,可调用云端API管理文件。更多信息,请参见:
功能原理
设备的应用程序通过MQTT协议上传文件至物联网平台:
该功能API的详细信息,请参见aiot_mqtt_upload_api.h。
文件上传功能基于MQTT连接,更多信息,请参见MQTT接入。
如下功能时序图,以设备的应用程序./demos/mqtt_upload_basic_demo.c为例,介绍应用程序实现该功能的流程。
使用说明
仅中国的华东2(上海)、华北2(北京)和华南1(深圳)地域下,支持设备通过MQTT协议上传文件。
上传文件的名称限制如下:
支持数字、英文字母、下划线(_)和英文句点(.)。
首字符仅支持数字和英文字母。
长度不超过100字节。
文件上传功能支持多个文件上传。
一个实例下,可存储的文件总大小不能超过1 GB。
一个设备下,可存储的文件数量不能超过1,000个。
单个文件不超过16 MB。
设备向物联网平台发送上传文件请求时,物联网平台根据文件名,执行以下策略。
若物联网平台不存在同名文件,直接创建文件的上传任务。
若物联网平台存在同名文件,则根据所设置的同名文件处理策略,执行以下对应操作。示例代码及说明,请参见步骤四:请求上传文件。
处理策略(conflictStrategy)
说明
覆盖模式(overwrite)
默认模式,删除已存在的同名文件,仅保留最新上传的文件。
文件追加模式(append)
发起上传文件请求后,物联网平台返回已存在的同名文件信息,设备端可根据业务需要,选择以下操作:
如果已存在的同名文件为未完成上传的文件,则设备继续执行上传任务。
说明物联网平台仅在24小时内保留未完成上传的文件。
如果已存在的同名文件为已完成上传的文件,则设备选择覆盖模式或重命名文件后,重新上传文件。
拒绝模式(reject)
物联网平台返回文件已存在的错误码,并拒绝再次上传该文件。