IoT Platform:GenerateOTAUploadURL

Notas de uso

Esta operación puede usarse junto con otras para crear un paquete de actualización. Procedimiento:

1. Llame a esta operación de API para generar los detalles del archivo de paquete de actualización que desea cargar en OSS.

A continuación se describen los parámetros de respuesta de esta operación de API:

• Los siguientes parámetros de solicitud de la operación PostObject de OSS, que se usa para cargar el archivo del paquete de actualización: Host,Key, OSSAccessKeyId, Signature y Policy.

• El siguiente parámetro de solicitud de la operación CreateOTAFirmware, que se usa para crear el paquete de actualización: FirmwareUrl.

1. Use un SDK de OSS para llamar a la operación PostObject y cargar el archivo del paquete de actualización. Para obtener más información sobre el código de ejemplo, consulte la sección "Uso de los parámetros de respuesta".

   Importante

   La información de los parámetros que devuelve esta operación tiene una validez de 1 minuto. Debe cargar el archivo del paquete de actualización dentro de ese minuto. El tamaño máximo del archivo de paquete de actualización cargado es de 1,000 MB.

2. Una vez cargado el archivo del paquete de actualización, llame a la operación CreateOTAFirmware para crear un paquete de actualización dentro de un plazo de 60 minutos.

Si se cargan archivos de paquetes de actualización pero no se llama a la operación CreateOTAFirmware para crear los paquetes correspondientes, el sistema eliminará automáticamente dichos archivos de forma periódica.

Límites de QPS

Cada cuenta de Alibaba Cloud puede ejecutar hasta 10 consultas por segundo (QPS).

Parámetros de solicitud

Además de los parámetros de solicitud específicos de la operación mencionados anteriormente, debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte Parámetros de solicitud comunes.

Parámetros de respuesta

Uso de los parámetros de respuesta

Cuando llame a la operación PostObject de OSS para cargar el archivo del paquete de actualización en OSS, especifique los parámetros de solicitud con los valores devueltos por la operación GenerateOTAUploadURL.

El siguiente código de ejemplo escrito en Java muestra cómo cargar el archivo del paquete de actualización en OSS. Para obtener más información sobre el código de ejemplo, consulte Carga de formularios.

• Agregue las siguientes dependencias al archivo 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>
                      

• Código de ejemplo:

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

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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

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

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.