上传文件配置

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

物联网平台支持设备将文件上传至您自己的OSS存储空间(Bucket),帮助您便捷地使用设备上传的文件。本文介绍设备文件上传至您自己OSS空间所需要的完整配置流程。

前提条件

已在OSS中创建存储空间(Bucket)。具体操作,请参见创建存储空间

背景信息

当设备将文件上传到阿里云物联网平台后,您可以在物联网平台控制台查看、下载、删除文件。具体操作,请参见文件管理

当设备将文件上传至您自己的OSS存储空间后,您可以直接访问和使用OSS空间文件,但是需要先进行上传文件的Bucket配置。

重要

上传至您自己OSS存储空间的设备文件,不支持在物联网平台控制台管理,例如删除。

使用限制

  • 单个产品下,最多添加10个配置项,使用产品粒度唯一的自定义业务ID区分。不同的业务ID,可对应相同的Bucket。

  • 新增、更新、删除文件上传的配置后,对于设备端上传文件的请求,需1分钟后生效。

  • 设备端通过MQTT协议上传的单个文件大小不能超过16 MB。

  • 对于上传至您自己OSS空间的文件,单个文件最大为16 MB,不限制文件数量或文件总大小。

重要 OSS Bucket必须为设备所属用户所有,Bucket地域必须与设备所属地域相同。

配置设备文件上传至Bucket

将设备文件保存至目标OSS Bucket前,需完成Bucket授权和配置。

  1. 登录物联网平台控制台
  2. 实例概览页签的全部环境下,找到对应的实例,单击实例卡片。

  3. 在左侧导航栏,选择设备管理 > 产品,然后单击产品对应操作列的查看

  4. 产品详情页面,单击文件上传配置页签,然后单击新增OSS Bucket配置

  5. 在弹出的对话框中,单击角色未创建右侧的创建

    若角色已创建,跳过此步骤。服务关联角色说明,请参见设备文件上传服务关联角色

    重要

    配置Bucket列表前,需先在您的阿里云账号中创建一个服务关联角色,用于授权物联网平台将设备上传的文件保存至您的OSS存储空间。

    配置Bucket

  6. 按照以下操作,完成目标Bucket配置。

    1. 输入自定义的业务ID。该ID必须在产品下唯一。配置成功后,不可修改。

      业务ID支持大小写字母、数字和特殊字符英文句点(.)、下划线(_),首字符不能为特殊字符,长度限制为4~32个字符。

    2. 单击Bucket下拉框,选择目标Bucket或直接输入已创建的Bucket名称。

      Bucket命名说明,请参见存储空间命名

      您可在设置Bucket后,添加说明内容。输入内容不能超过500个字符。

    3. 单击确定,物联网平台服务端会校验Bucket值的有效性,包括是否属于当前账号、地域,是否符合OSS标准存储类型等。

      若校验失败,配置Bucket会失败。您需根据页面提示,重新配置Bucket。

管理Bucket配置

新增OSS Bucket配置成功后,在文件上传配置页签找到OSS Bucket对应的业务ID,可执行以下操作。

操作

步骤

编辑

您可修改Bucket和说明信息。

  1. 单击业务ID对应操作列的编辑

  2. 编辑OSS Bucket配置对话框,修改Bucket说明

  3. 单击确定

删除

警告

删除OSS Bucket配置后,设备无法申请将文件上传至该Bucket空间。请谨慎操作。

  1. 单击业务ID对应操作列的删除

  2. 单击确定

后续步骤

在设备端开发上传文件至您自己的OSS存储空间的能力。具体操作,请参见示例三:MQTT文件上传至用户OSS空间

设备端上传文件的详细说明,请参见文件上传的Topic和数据格式

相关文档

添加云产品数据源:如果需要对设备上传的文件进行进一步加工处理和分析,可将OSS Bucket中数据导入物联网平台的数据服务中。