IoT Platform：GenerateOTAUploadURL

使用說明

該介面與其他介面結合使用完成升級包建立。建立升級包的步驟：

1. 調用本介面產生升級包檔案上傳到Object Storage Service的資訊。

本介面的返回參數包含：

• 調用OSS PostObject上傳升級包檔案的請求參數：Host、Key、OSSAccessKeyId、Signature和Policy。
• 調用CreateOTAFirmware建立升級包的請求參數FirmwareUrl。

2. 請在本介面返回結果後的1分鐘之內，使用OSS SDK調用PostObject介面上傳升級包檔案。上傳檔案的程式碼範例，請參見下文“返回參數的用途”章節。

3. 升級包上傳完成後，請在60分鐘內，調用物聯網平台API CreateOTAFirmware介面建立升級包。

如果上傳了升級包，但未調用CreateOTAFirmware介面建立升級包，上傳的檔案將被系統定期自動清理。

QPS限制

單個阿里雲帳號調用該介面的每秒請求數（QPS）最大限制為10。

請求參數

調用API時，除了本文介紹的該API的特有請求參數，還需傳入公用請求參數。公用請求參數說明，請參見公用參數文檔。

返回資料

返回參數的用途

調用OSS PostObject介面時，使用本介面的返回參數值作為請求參數值，將您編輯好的升級包檔案上傳到Object Storage Service。

以下是向Object Storage Service上傳檔案的Java程式碼範例。範例程式碼詳細內容，請參見表單上傳。

• 在pom.xml中添加以下依賴。

  <dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.3</version>
  </dependency>
  <dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpmime</artifactId>
    <version>4.5.10</version>
  </dependency>
  

• 上傳升級包檔案的代碼如下。

  public static boolean postObject(String key,
                                    String host,
                                    String policy,
                                    String ossAccessKeyId,
                                    String signature,
                                    String data) throws IOException {
    CloseableHttpClient httpClient = HttpClients.createDefault();
    HttpPost uploadFile = new HttpPost(host);
    MultipartEntityBuilder builder = MultipartEntityBuilder.create();
    builder.addTextBody("key", key, ContentType.TEXT_PLAIN);
    builder.addTextBody("policy", policy, ContentType.TEXT_PLAIN);
    builder.addTextBody("OSSAccessKeyId", ossAccessKeyId, ContentType.TEXT_PLAIN);
    builder.addTextBody("signature", signature, ContentType.TEXT_PLAIN);
    builder.addTextBody("success_action_status", "200", ContentType.TEXT_PLAIN);
    builder.addBinaryBody("file", data.getBytes());
    HttpEntity multipart = builder.build();
    uploadFile.setEntity(multipart);
    CloseableHttpResponse response = httpClient.execute(uploadFile);
    if (response.getStatusLine().getStatusCode() == 200) {
      return true;
    }
    return false;
  }
  

樣本

請求樣本

https://iot.cn-shanghai.aliyuncs.com/?Action=GenerateOTAUploadURL
&<公用請求參數>

正常返回樣本

XML格式

<GenerateOTAUploadURLResponse>
    <Data>
        <Key>ota/65dfcda0473be29836dfde585472****/ck2nfzljo00023g7kysg0****.bin</Key>
        <Host>https://iotx-ota.oss-cn-shanghai.aliyuncs.com</Host>
        <Policy>eyJleHBpcmF****</Policy>
        <OSSAccessKeyId>cS8uRRy54Rsz****</OSSAccessKeyId>
        <ObjectStorage>OSS</ObjectStorage>
        <UtcCreate>2019-11-04T06:21:54.607Z</UtcCreate>
        <Signature>PKmRTy40QxqIUUWy325SCT/****</Signature>
        <FirmwareUrl>https://iotx-ota.oss-cn-shanghai.aliyuncs.com/ota/65dfcda0473be29836dfde585472****/ck2nfzljo00023g7kysg0****.bin</FirmwareUrl>
    </Data>
    <RequestId>B6E77674-09C4-4647-BF85-59CB72A72E4B</RequestId>
    <Success>true</Success>
</GenerateOTAUploadURLResponse>

JSON格式

{
    "Data": {
        "Key": "ota/65dfcda0473be29836dfde585472****/ck2nfzljo00023g7kysg0****.bin",
        "Host": "https://iotx-ota.oss-cn-shanghai.aliyuncs.com",
        "Policy": "eyJleHBpcmF****",
        "OSSAccessKeyId": "cS8uRRy54Rsz****",
        "ObjectStorage": "OSS",
        "UtcCreate": "2019-11-04T06:21:54.607Z",
        "Signature": "PKmRTy40QxqIUUWy325SCT/****",
        "FirmwareUrl": "https://iotx-ota.oss-cn-shanghai.aliyuncs.com/ota/65dfcda0473be29836dfde585472****/ck2nfzljo00023g7kysg0****.bin"
    },
    "RequestId": "B6E77674-09C4-4647-BF85-59CB72A72E4B",
    "Success": true
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。