View a markdown version of this page

Ejecución de trabajo - AWS IoT Core

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejecución de trabajo

«El dispositivo puede completar la ejecución de un trabajo»

Este caso de prueba te ayuda a comprobar si tu dispositivo puede recibir actualizaciones mediante AWS IoT Jobs y a publicar el estado de las actualizaciones realizadas correctamente. Para obtener más información sobre AWS IoT Jobs, consulte Jobs.

Para ejecutar correctamente este caso de prueba, hay dos temas de AWS reservados a los que debe asignar el rol de dispositivo. Para suscribirse a los mensajes relacionados con la actividad de trabajos, utilice los temas notify y notify-next. Su función de dispositivo debe permitir la acción PUBLISH en los siguientes temas:

  • $aws/things/ThingName /jobs/ jobs/ JobId /get

  • $/ThingName /jobs/ jobs/ jobId /update aws/things

Se recomienda conceder las acciones SUBSCRIBE y RECEIVE para los siguientes temas:

  • $aws/things/ThingName jobs/get///aceptado

  • $aws/things/ThingName /jobs/ jobs/ jobId/get/rejected

  • $/ThingName /jobs/ jobs/ jobId/aws/thingsupdate/accepted

  • $/ThingName /jobs/ jobs/ jobId/aws/thingsupdate/rejected

Se recomienda conceder la acción SUBSCRIBE para el siguiente tema:

  • $/ThingName/-siguiente aws/things jobs/notify

Para obtener más información sobre estos temas reservados, consulte los temas reservados de AWS IoT Jobs.

En este momento, no WebSocket se admite MQTT over.

Definición de caso de prueba de API:

nota

EXECUTION_TIMEOUT tiene un valor predeterminado de 5 minutos. Se recomienda un valor de tiempo de espera de 3 minutos. En función del documento de AWS IoT trabajo o de la fuente proporcionada, ajuste el valor del tiempo de espera (por ejemplo, si un trabajo va a tardar mucho en ejecutarse, defina un valor de tiempo de espera mayor para el caso de prueba). Para ejecutar la prueba, se requiere un documento de AWS IoT trabajo válido o un identificador de trabajo ya existente. Se puede proporcionar un documento de AWS IoT trabajo como un documento JSON o como un enlace de S3. Si se proporciona un documento de trabajo, proporcionar un identificador de trabajo es opcional. Si se proporciona un identificador de trabajo, Device Advisor usará ese identificador al crear el AWS IoT trabajo en su nombre. Si no se proporciona el documento de trabajo, puede proporcionar un ID existente que se encuentre en la misma región en la que está ejecutando el caso de prueba. En este caso, Device Advisor utilizará ese AWS IoT trabajo mientras ejecuta el caso de prueba.

"tests": [
   {
      "name":"my_job_execution",
      "configuration": {
         // optional:
         // Test case will create a job task by using either JOB_DOCUMENT or JOB_DOCUMENT_SOURCE.
         // If you manage the job task on your own, leave it empty and provide the JOB_JOBID (self-managed job task).
         // JOB_DOCUMENT is a JSON formatted string
         "JOB_DOCUMENT": "{
            \"operation\":\"reboot\",
            \"files\" : {
               \"fileName\" : \"install.py\",
               \"url\" : \"${aws:iot:s3-presigned-url:https://s3.amazonaws.com/bucket-name/key}\"
            }
         }",
         // JOB_DOCUMENT_SOURCE is an S3 link to the job document. It will be used only if JOB_DOCUMENT is not provided.
         "JOB_DOCUMENT_SOURCE": "https://s3.amazonaws.com/bucket-name/key",
         // JOB_JOBID is mandatory, only if neither document nor document source is provided. (Test case needs to know the self-managed job task id).
         "JOB_JOBID": "String",
         // JOB_PRESIGN_ROLE_ARN is used for the presign Url, which will replace the placeholder in the JOB_DOCUMENT field
         "JOB_PRESIGN_ROLE_ARN": "String",
         // Presigned Url expiration time. It must be between 60 and 3600 seconds, with the default value being 3600.
         "JOB_PRESIGN_EXPIRES_IN_SEC": "Long"   
         "EXECUTION_TIMEOUT": "300", // in seconds         
      },
      "test": {
         "id": "Job_Execution",
         "version": "0.0.0"
      }
   }
]

Para obtener más información sobre la creación y el uso de documentos de trabajo, consulte Documento de trabajo.