AWaws-samples
Client Device Tasks

Associate client devices with the provided core.

Changed on

Associates 1 or more client devices with an existing Greengrass V2 core. If the referenced thingName does not exist, an AWS IoT Thing is provisioned using the provided provisioningTemplate. The AWS IoT thing is then associated with the Greengrass V2 core. This is an asynchronous call, meaning that when submitted the call will return immediately with a taskId while the cores are being created in the background. Use the GET /deviceTasks/{taskId} to retrieve the status of the task.

post/cores/{thingName}/deviceTasks

Request

  • The document declares no server URL.
  • Auth
    none declared

Request body

taskIdstring

Unique ID of the task.

taskStatus'Waiting' | 'InProgress' | 'Success' | 'Failure'

The core task status.

statusMessagestring

Descriptive message regarding the status, such as an error message.

createdAtstring date-time

Date/time the task was created.

updatedAtstring date-time

Date/time the task was updated.

Response

Accepted

Changes