tencent cloud

All product documents
IoT Hub
DocumentationIoT HubDeveloper ManualResource Management
Resource Management
Download PDF
Last updated: 2024-12-27 15:54:13
Resource Management
Last updated: 2024-12-27 15:54:13
Download PDF

Feature Overview

The resource management feature is mainly used to transfer resources between devices and the platform. The following two topics are required for this feature:
Data upstream topic (for publishing): $resource/up/service/${productid}/${devicename}
Data downstream topic (for subscribing): $resource/down/service/${productid}/${devicename}

Device Resource Upload

Step 1. Create a resource upload task on the device

1. The device sends a message in JSON format with the following content to $resource/up/service/${productid}/${devicename} to create a device resource upload task:
{
      "type":"create_upload_task",
      "size":100,
      "name":"zxc",
      "md5sum":"************",
}
2. After successful creation, the backend returns the resource upload URL through $resource/down/service/${productid}/${devicename} with a message in JSON format with the following content:
{
      "type":"create_upload_task_rsp",
      "size":100,
      "name":"zxc",
      "md5sum":"************",
      "url":"https://iothub.cos.ap-guangzhou.myqcloud.com/********"
}

Step 2. Report the resource upload progress

1. Resource upload uses HTTP PUT requests, so the Base64-encoded MD5 value needs to be added to the header. During the resource upload process, the device reports the resource upload progress through $resource/up/service/${productid}/${devicename} with a message in JSON format with the following content:
{
      "type":"report_upload_progress",
      "name":"zxc",
      "progress":{
             "state":"uploading",
             "percent":89,
             "result_code":0,
             "result_msg":""
         }
}
2. The response to progress reporting is sent to the device through $resource/down/service/${productid}/${devicename} with a message in JSON format with the following content:
{
      "type":"report_upload_progress_rsp",
      "result_code":0,
      "result_msg":"ok"
}

Platform Resource Delivery

Step 1. Query the resource download URL

1. The device sends a message in JSON format with the following content through $resource/up/service/${productid}/${devicename} to query the download task:
{
   "type":"get_download_task"
}
2. If there is a download task, the result will be delivered through $resource/down/service/${productid}/${devicename} with a message in JSON format with the following content:
{
      "type":"get_download_task_rsp",
      "size":372338,
      "name":"AAAA",
      "md5sum":"a567907174*****3bb9a2bb20716fd97",
      "url":"https://iothub.cos.ap-guangzhou.myqcloud.com/********"
}

Step 2. Report the resource download progress

1. The resource download progress is reported through $resource/up/service/${productid}/${devicename} with a message in JSON format with the following content:
{
      "type":"report_download_progress",
      "name":"zxc",
      "progress":{
             "state":"downloading",
             "percent":89,
             "result_code":0,
             "result_msg":""
         }
}
2. The response to progress reporting is sent to the device through $resource/down/service/${productid}/${devicename} with a message in JSON format with the following content:
{
      "type":"report_download_progress_rsp",
      "result_code":0,
      "result_msg":"ok"
}
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon