create_task

create_task(**kwargs)

Instructs one or more devices to start a task, such as unlocking or rebooting.

See also: AWS API Documentation

Request Syntax

response = client.create_task(
    clientToken='string',
    command={
        'reboot': {}
        ,
        'unlock': {}

    },
    description='string',
    tags={
        'string': 'string'
    },
    targets=[
        'string',
    ]
)
Parameters
  • clientToken (string) --

    A token ensuring that the action is called only once with the specified details.

    This field is autopopulated if not provided.

  • command (dict) --

    [REQUIRED]

    The task to be performed. Only one task is executed on a device at a time.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: reboot, unlock.

    • reboot (dict) --

      Reboots the device.

    • unlock (dict) --

      Unlocks the device.

  • description (string) -- A description of the task and its targets.
  • tags (dict) --

    Optional metadata that you assign to a resource. You can use tags to categorize a resource in different ways, such as by purpose, owner, or environment.

    • (string) --
      • (string) --
  • targets (list) --

    [REQUIRED]

    A list of managed device IDs.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'taskArn': 'string',
    'taskId': 'string'
}

Response Structure

  • (dict) --

    • taskArn (string) --

      The Amazon Resource Name (ARN) of the task that you created.

    • taskId (string) --

      The ID of the task that you created.

Exceptions

  • SnowDeviceManagement.Client.exceptions.ServiceQuotaExceededException
  • SnowDeviceManagement.Client.exceptions.ThrottlingException
  • SnowDeviceManagement.Client.exceptions.InternalServerException
  • SnowDeviceManagement.Client.exceptions.ResourceNotFoundException
  • SnowDeviceManagement.Client.exceptions.ValidationException
  • SnowDeviceManagement.Client.exceptions.AccessDeniedException