IoTSiteWise / Client / update_task

update_task

IoTSiteWise.Client.update_task(**kwargs)

Updates an existing task in the specified workspace. Only the fields provided in the request are updated; fields not included in the request are preserved unchanged.

See also: AWS API Documentation

Request Syntax

response = client.update_task(
    workspaceName='string',
    taskName='string',
    description='string',
    taskConfiguration={
        'containerTaskConfiguration': {
            'ecrUri': 'string',
            'taskExecutionRole': 'string',
            'processingType': 'GENERIC_COMPUTE_PROCESSING'|'HARDWARE_ACCELERATED_PROCESSING',
            'processingUnit': 'UNITS_2'|'UNITS_4'|'UNITS_8'|'UNITS_12'|'UNITS_16'|'UNITS_24'|'UNITS_32'|'UNITS_36'|'UNITS_48'|'UNITS_60'|'UNITS_64'|'UNITS_72'|'UNITS_84'|'UNITS_96',
            'command': [
                'string',
            ],
            'timeoutSeconds': 123,
            'environmentVariables': {
                'string': 'string'
            }
        }
    }
)
Parameters:

  • workspaceName (string) –

    [REQUIRED]

    The name of the workspace.

  • taskName (string) –

    [REQUIRED]

    The name of the task to update.

  • description (string) – A new description for the task.

  • taskConfiguration (dict) –

    The updated task execution configuration.

    Note

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

    • containerTaskConfiguration (dict) –

      Configuration for running a custom container image on managed compute.

      • ecrUri (string) – [REQUIRED]

        The Amazon ECR image URI for the task container.

      • taskExecutionRole (string) – [REQUIRED]

        The ARN of the IAM role that grants the containerized workload permissions to access AWS resources.

      • processingType (string) – [REQUIRED]

        The processing type for compute resources.

      • processingUnit (string) – [REQUIRED]

        The processing unit allocation that determines the vCPU, memory, and GPU resources.

      • command (list) –

        The command to execute in the container.

        • (string) –

      • timeoutSeconds (integer) –

        The timeout in seconds for task execution. Default: 3600 (1 hour).

      • environmentVariables (dict) –

        Environment variables passed to the container at runtime.

        • (string) –

          Environment variable name following POSIX naming rules Must not start with AWS_ prefix (case-insensitive)

          • (string) –

            Environment variable value

Return type:

dict

Returns:

Response Syntax

{
    'version': 'string',
    'status': {
        'error': {
            'code': 'VALIDATION_ERROR'|'INTERNAL_FAILURE',
            'message': 'string'
        },
        'state': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'FAILED'
    }
}

Response Structure

  • (dict) –

    Response structure for UpdateTask operation.

    • version (string) –

      The new version of the task created by this update.

    • status (dict) –

      The current lifecycle status of the task.

      • error (dict) –

        Contains associated error information, if any.

        • code (string) –

          The error code.

        • message (string) –

          The error message.

      • state (string) –

        The current status of the resource.

Exceptions