Skip to content

StartCommandExecutionRequest

Source code in docs_src/capo_iot_jobs_data_plane/types/start_command_execution_request.py
class StartCommandExecutionRequest(TypedDict, closed=True):
    target_arn: "capo_iot_jobs_data_plane.types.target_arn.TargetArn"
    """<p>The Amazon Resource Number (ARN) of the device where the command execution is occurring.</p>"""
    command_arn: "capo_iot_jobs_data_plane.types.command_arn.CommandArn"
    """<p>The Amazon Resource Number (ARN) of the command. For example, <code>arn:aws:iot:<region>:<accountid>:command/<commandName></code> </p>"""
    parameters: NotRequired[
        "capo_iot_jobs_data_plane.types.command_execution_parameter_map.CommandExecutionParameterMap"
    ]
    """<p>A list of parameters that are required by the <code>StartCommandExecution</code> API when performing the command on a device.</p>"""
    execution_timeout_seconds: NotRequired[
        "capo_iot_jobs_data_plane.types.command_execution_timeout_in_seconds.CommandExecutionTimeoutInSeconds"
    ]
    """<p>Specifies the amount of time in second the device has to finish the command execution. A timer is started as soon as the command execution is created. If the command execution status is not set to another terminal state before the timer expires, it will automatically update to <code>TIMED_OUT</code>.</p>"""
    client_token: NotRequired[
        "capo_iot_jobs_data_plane.types.client_request_token_v2.ClientRequestTokenV2"
    ]
    """<p>The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you retry the request using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, Amazon Web Services SDKs will automatically generate a unique client request.</p>"""

client_token instance-attribute

client_token: NotRequired[ClientRequestTokenV2]

The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you retry the request using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, Amazon Web Services SDKs will automatically generate a unique client request.

command_arn instance-attribute

command_arn: CommandArn

The Amazon Resource Number (ARN) of the command. For example, arn:aws:iot:::command/

execution_timeout_seconds instance-attribute

execution_timeout_seconds: NotRequired[CommandExecutionTimeoutInSeconds]

Specifies the amount of time in second the device has to finish the command execution. A timer is started as soon as the command execution is created. If the command execution status is not set to another terminal state before the timer expires, it will automatically update to TIMED_OUT.

parameters instance-attribute

parameters: NotRequired[CommandExecutionParameterMap]

A list of parameters that are required by the StartCommandExecution API when performing the command on a device.

target_arn instance-attribute

target_arn: TargetArn

The Amazon Resource Number (ARN) of the device where the command execution is occurring.