tencent cloud

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