IoT Platform:GenerateOTAUploadURL

Notes d'utilisation

Utilisez cette opération conjointement avec d’autres pour créer un package de mise à jour. Procédure :

1. Appelez cette opération d’API pour générer les détails du fichier de package de mise à jour que vous souhaitez télécharger sur OSS.

La section suivante décrit les paramètres de réponse de cette opération d’API :

• Les paramètres de requête suivants de l’opération OSS PostObject utilisée pour télécharger le fichier de package de mise à jour : Host,Key, OSSAccessKeyId, Signature et Policy.

• Le paramètre de requête suivant de l’opération CreateOTAFirmware utilisée pour créer le package de mise à jour : FirmwareUrl.

2. Utilisez un SDK OSS pour appeler l’opération PostObject afin de télécharger le fichier de package de mise à jour. Pour plus d’informations sur l’exemple de code, consultez la section « Utilisation des paramètres de réponse ».

3. Une fois le fichier de package de mise à jour téléchargé, appelez l’opération CreateOTAFirmware pour créer un package de mise à jour dans un délai de 60 minutes.

Si des fichiers de package de mise à jour sont téléchargés mais que vous n’appelez pas l’opération CreateOTAFirmware pour créer les packages correspondants, le système supprime automatiquement les fichiers téléchargés périodiquement.

Limites QPS

Chaque compte Alibaba Cloud peut effectuer jusqu’à 10 requêtes par seconde (QPS).

Paramètres de requête

En plus des paramètres de requête spécifiques à l’opération mentionnés ci-dessus, vous devez spécifier les paramètres de requête communs lorsque vous appelez cette opération. Pour plus d’informations, consultez les Paramètres de requête communs.

Paramètres de réponse

Utilisations des paramètres de réponse

Lorsque vous appelez l’opération OSS PostObject pour télécharger le fichier de package de mise à jour vers OSS, spécifiez les paramètres de requête en utilisant les valeurs renvoyées par l’opération GenerateOTAUploadURL.

L’exemple de code Java suivant montre comment télécharger le fichier de package de mise à jour vers OSS. Pour plus d’informations sur l’exemple de code, consultez la section Téléchargement de formulaires.

• Ajoutez les dépendances suivantes au fichier 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>
                      

• Exemple de code :

  
  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;
  }
                      

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=GenerateOTAUploadURL
&<Common request parameters>

Exemple de réponse en cas de succès

Format 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>

Format 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
}

Codes d’erreur

Pour obtenir la liste des codes d’erreur, visitez le Centre d’erreurs API.