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

前提条件

已在OSS中创建存储空间（Bucket）。具体操作，请参见创建存储空间。

背景信息

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

若设备将文件上传至您自己的OSS存储空间，可方便您直接访问OSS空间文件并使用，在使用该能力前，需要在产品粒度新增文件上传的Bucket配置。

重要 上传至您自己OSS存储空间的设备文件，不支持在物联网平台控制台管理。

使用限制

  • 目前仅华东2（上海）、华南1（深圳）、华北2（北京）地域支持设备将文件上传至您自己的OSS空间存储。
  • 单个产品下，最多添加10个配置项，使用产品粒度唯一的自定义业务ID区分。不同的业务ID下，可对应相同的Bucket。
  • 新增、更新、删除文件上传的配置后，对于设备端上传文件的请求，需1分钟后生效。
  • 设备端通过MQTT协议上传的单个文件大小不能超过16 MB。
  • 对于上传至您自己OSS空间的文件，没有文件数量及文件总大小的限制。
重要 OSS Bucket必须为设备所属用户所有，Bucket地域必须与设备所属地域相同。

配置设备文件上传至Bucket

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

  1. 登录物联网平台控制台。
  2. 在实例概览页面，选择目标环境，找到对应的实例，单击实例ID或备注名称。
    重要 目前仅开通企业版实例服务的地域下，执行此步骤。其他地域，请跳过此步骤。地域及实例的支持说明，请参见实例概述。
    实例概览
  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和数据格式。