Cree un trabajo a partir de plantillas AWS gestionadas mediante el AWS CLI - AWS IoT Core
Enumeración de plantillas administradasObtención de detalles sobre una plantilla administradaCreación de un trabajo mediante plantillas administradasCreación de una plantilla de trabajo personalizada a partir de plantillas administradas

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.

Cree un trabajo a partir de plantillas AWS gestionadas mediante el AWS CLI

Utilice el AWS CLI para obtener información sobre las plantillas AWS gestionadas y crear un trabajo con estas plantillas. A continuación, puede guardar el trabajo como una plantilla y crear su propia plantilla personalizada.

Enumeración de plantillas administradas

El list-managed-job-templates AWS CLI comando muestra todas las plantillas de trabajo de su Cuenta de AWS.


 aws iot list-managed-job-templates

De forma predeterminada, al ejecutar este comando, se muestran todas las plantillas AWS gestionadas disponibles y sus detalles.

{
    "managedJobTemplates": [
        {
            "templateArn": "arn:aws:iot:region::jobtemplate/AWS-Reboot:1.0",
            "templateName": "AWS-Reboot",
            "description": "A managed job template for rebooting the device.",
            "environments": [
                "LINUX"
            ],
            "templateVersion": "1.0"
        },
        {
            "templateArn": "arn:aws:iot:region::jobtemplate/AWS-Remove-Application:1.0",
            "templateName": "AWS-Remove-Application",
            "description": "A managed job template for uninstalling one or more applications.",
            "environments": [
                "LINUX"
            ],
            "templateVersion": "1.0"
        },
        {
            "templateArn": "arn:aws:iot:region::jobtemplate/AWS-Stop-Application:1.0",
            "templateName": "AWS-Stop-Application",
            "description": "A managed job template for stopping one or more system services.",
            "environments": [
                "LINUX"
            ],
            "templateVersion": "1.0"
        },

        ...

        {
            "templateArn": "arn:aws:iot:us-east-1::jobtemplate/AWS-Restart-Application:1.0",
            "templateName": "AWS-Restart-Application",
            "description": "A managed job template for restarting one or more system services.",
            "environments": [
                "LINUX"
            ],
            "templateVersion": "1.0"
        }
    ]
}

Para obtener más información, consulte ListManagedJobTemplates.

Obtención de detalles sobre una plantilla administrada

El describe-managed-job-template AWS CLI comando obtiene detalles sobre una plantilla de trabajo específica. Especifique el nombre de la plantilla de trabajo y, opcionalmente, su versión. Si no se especifica la versión de la plantilla, se devuelve la versión predeterminada predefinida. A continuación se muestra un ejemplo de ejecución del comando para obtener los detalles de la plantilla AWS-Download-File.

aws iot describe-managed-job-template \
    --template-name AWS-Download-File

El comando muestra los detalles de la plantillaARN, su documento de trabajo y el documentParameters parámetro, que es una lista de pares clave-valor de los parámetros de entrada de la plantilla. Para obtener información sobre las diferentes plantillas y parámetros de entrada, consulte Acciones remotas y documentos de trabajo de plantillas administradas.

nota

El documentParameters objeto devuelto al usarla solo API debe usarse al crear trabajos a partir de plantillas AWS gestionadas. El objeto no debe usarse para plantillas de trabajo personalizadas. Para ver un ejemplo que muestra cómo utilizar este parámetro, consulte Creación de un trabajo mediante plantillas administradas.

{
    "templateName": "AWS-Download-File",
    "templateArn": "arn:aws:iot:region::jobtemplate/AWS-Download-File:1.0",
    "description": "A managed job template for downloading a file.",
    "templateVersion": "1.0",
    "environments": [
        "LINUX"
    ],
    "documentParameters": [
        {
            "key": "downloadUrl",
            "description": "URL of file to download.",
            "regex": "(.*?)",
            "example": "http://www.example.com/index.html",
            "optional": false
        },
        {
            "key": "filePath",
            "description": "Path on the device where downloaded file is written.",
            "regex": "(.*?)",
            "example": "/path/to/file",
            "optional": false
        },
        {
            "key": "runAsUser",
            "description": "Execute handler as another user. If not specified, then handler is executed as the same user as device client.",
            "regex": "(.){0,256}",
            "example": "user1",
            "optional": true
        },
        {
            "key": "pathToHandler",
            "description": "Path to handler on the device. If not specified, then device client will use the current working directory.",
            "regex": "(.){0,4096}",
            "example": "/path/to/handler/script",
            "optional": true
        }
    ],
    "document": "{\"version\":\"1.0\",\"steps\":[{\"action\":{\"name\":\"Download-File\",\"type\":\"runHandler\",\"input\":{\"handler\":\"download-file.sh\",\"args\":[\"${aws:iot:parameter:downloadUrl}\",\"${aws:iot:parameter:filePath}\"],\"path\":\"${aws:iot:parameter:pathToHandler}\"},\"runAsUser\":\"${aws:iot:parameter:runAsUser}\"}}]}"
}

Para obtener más información, consulte DescribeManagedJobTemplate.

Creación de un trabajo mediante plantillas administradas

El create-job AWS CLI comando se puede utilizar para crear un trabajo a partir de una plantilla de trabajo. Se dirige a un dispositivo denominado thingOne y especifica el nombre del recurso de Amazon (ARN) de la plantilla gestionada que se utilizará como base para el trabajo. Puede anular las configuraciones avanzadas, como las configuraciones del tiempo de espera y de cancelación, omitiendo los parámetros correspondientes del comando create-job.

En el ejemplo se muestra cómo crear un trabajo que utiliza la plantilla AWS-Download-File. También muestra cómo especificar los parámetros de entrada de la plantilla mediante el parámetro document-parameters.

nota

Utilice el document-parameters objeto únicamente con plantillas AWS gestionadas. Este objeto no debe usarse con plantillas de trabajo personalizadas.

aws iot create-job \
   --targets arn:aws:iot:region:account-id:thing/thingOne \ 
   --job-id "new-managed-template-job" \ 
   --job-template-arn arn:aws:iot:region::jobtemplate/AWS-Download-File:1.0 \
   --document-parameters downloadUrl=https://example.com/index.html,filePath=path/to/file

donde:

  • region es el Región de AWS.

  • account-id es el Cuenta de AWS número único.

  • thingOne es el nombre del objeto de IoT al que se dirige el trabajo.

  • AWS-Download-File:1.0 es el nombre de la plantilla gestionada.

  • https://example.com/index.htmles la fuente desde la URL que se debe descargar el archivo.

  • https://pathto/file/index es la ruta en el dispositivo para almacenar el archivo descargado.

Ejecute el siguiente comando para crear un trabajo para la plantilla, AWS-Download-File.

{
    "jobArn": "arn:aws:iot:region:account-id:job/new-managed-template-job",
    "jobId": "new-managed-template-job",
    "description": "A managed job template for downloading a file."
}

Creación de una plantilla de trabajo personalizada a partir de plantillas administradas

  1. Cree un trabajo mediante una plantilla administrada tal y como se describe en la sección anterior.

  2. Cree una plantilla de trabajo personalizada utilizando la ARN del trabajo que ha creado. Para obtener más información, consulte Creación de una plantilla de trabajo a partir de un trabajo existente.