通过GenerateOTAUploadURL生成升级包文件上传到OSS的URL及详细信息

GenerateOTAUploadURL

生成升级包文件上传到OSS的URL及详细信息。

请求参数

名称

类型

是否必选

示例值

描述

Action

String

是

GenerateOTAUploadURL

系统规定参数。取值：GenerateOTAUploadURL。

FileSuffix

String

否

bin

升级包文件扩展名。可选扩展名：

bin（默认）
dav
apk
tar
gz
tar.gz
zip
gzip

重要

‼️ 注意：调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数。

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	Struct		调用成功时，返回的文件上传信息。详情见以下参数信息。
FirmwareUrl	String	https://oss-612ba0f1-2e08-4adb-9606-78390169**.oss-cn-hangzhou.aliyuncs.com/ota/firmware/bd65da39-cf24-4d9c-b306-6ac14ff5**.bin	文件的URL，即文件在对象存储（OSS）上的存储地址。升级包文件上传成功后，使用此参数调用CreateOTAFirmware接口创建升级包。
Host	String	https://oss-612ba0f1-2e08-4adb-9606-78390169****.oss-cn-hangzhou.aliyuncs.com	OSS的接入域名。
Key	String	ota/firmware/bd65da39-cf24-4d9c-b306-6ac14ff5****.bin	调用OSS的接口PostObject上传对象（即文件）的名称，包含OSS对象的完整路径。
OSSAccessKeyId	String	cS8uRRy54Rsz****	OSS Bucket拥有者的AccessKey ID。该OSS Bucket将存储文件。
ObjectStorage	String	OSS	对象存储类型。默认为OSS。
Policy	String	eyJleHBpcmF0aW9uIjoiMjAyNC0xMS0yMFQwMDoxMToxOC41NjBaIiwiY29uZGl0aW9ucyI6W1siY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsMTA0ODU3NjAwMF0sWyJzdGFydHMtd2l0aCIsIiRrZXkiLCJvdGEvZmlybXdhcmUvIl1d****	OSS通过该参数验证请求表单域的合法性。
Signature	String	BYKJX8ktrZ2mrTrFvI7mhPmP****	根据AccessKeySecret和Policy计算出的签名信息。调用OSS API时，OSS验证该签名信息，从而确认Post请求的合法性。
UtcCreate	String	2024-11-11T11:11:11.247Z	生成文件上传URL的时间，UTC格式。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
RequestId	String	74C2BB8D-1D6F-41F5-AE68-6B2310883F63	物联网平台为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=GenerateOTAUploadURL&SignatureNonce=9e6189124f5a4716ad2de849467be7c0&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A47%3A43Z&FileSuffix=bin&Signature=WJN0Ee8%2BX6pogcD3loLHIqQNEN0%3D'

正常返回示例

{
  "code": "",
  "data": {
    "firmwareUrl": "https://oss-612ba0f1-2e08-4adb-9606-78390169****.oss-cn-hangzhou.aliyuncs.com/ota/firmware/bd65da39-cf24-4d9c-b306-6ac14ff5****.bin",
    "host": "https://oss-612ba0f1-2e08-4adb-9606-78390169****.oss-cn-hangzhou.aliyuncs.com",
    "key": "ota/firmware/bd65da39-cf24-4d9c-b306-6ac14ff5****.bin",
    "OSSAccessKeyId": "LTAI5tHeD8bfRz5MbhUY****",
    "objectStorage": "OSS",
    "policy": "eyJleHBpcmF0aW9uIjoiMjAyNC0xMS0yMFQwMDoxMToxOC41NjBaIiwiY29uZGl0aW9ucyI6W1siY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsMTA0ODU3NjAwMF0sWyJzdGFydHMtd2l0aCIsIiRrZXkiLCJvdGEvZmlybXdhcmUvIl1d****",
    "signature": "BYKJX8ktrZ2mrTrFvI7mhPmP****",
    "utcCreate": "2024-11-20T00:11:17.560Z"
  },
  "requestId": "7da09949-babb-4f0f-a288-d6af2f3bfad7",
  "success": true
}