Skip to content

GetCommandExecutionResponse

Source code in docs_src/capo_iot/types/get_command_execution_response.py
class GetCommandExecutionResponse(TypedDict, closed=True):
    execution_id: NotRequired["capo_iot.types.command_execution_id.CommandExecutionId"]
    """<p>The unique identifier of the command execution.</p>"""
    command_arn: NotRequired["capo_iot.types.command_arn.CommandArn"]
    """<p>The Amazon Resource Number (ARN) of the command. For example, <code></code>arn:aws:iot:<region>:<accountid>:command/<commandId></p>"""
    target_arn: NotRequired["capo_iot.types.target_arn.TargetArn"]
    """<p>The Amazon Resource Number (ARN) of the device on which the command execution is being performed.</p>"""
    status: NotRequired[
        "capo_iot.types.command_execution_status.CommandExecutionStatus"
    ]
    """<p>The status of the command execution. After your devices receive the command and start performing the operations specified in the command, it can use the <code>UpdateCommandExecution</code> MQTT API to update the status information.</p>"""
    status_reason: NotRequired["capo_iot.types.status_reason.StatusReason"]
    """<p>Your devices can use this parameter to provide additional context about the status of a command execution using a reason code and description.</p>"""
    result: NotRequired[
        "capo_iot.types.command_execution_result_map.CommandExecutionResultMap"
    ]
    """<p>The result value for the current state of the command execution. The status provides information about the progress of the command execution. The device can use the result field to share additional details about the execution such as a return value of a remote function call.</p> <note> <p>If you use the <code>AWS-IoT-FleetWise</code> namespace, then this field is not applicable in the API response.</p> </note>"""
    parameters: NotRequired[
        "capo_iot.types.command_execution_parameter_map.CommandExecutionParameterMap"
    ]
    """<p>The list of parameters that the <code>StartCommandExecution</code> API used when performing the command on the device.</p>"""
    execution_timeout_seconds: NotRequired[
        "capo_iot.types.command_execution_timeout_in_seconds.CommandExecutionTimeoutInSeconds"
    ]
    """<p>Specifies the amount of time in seconds that the device can take to finish a command execution. A timer starts when 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>"""
    created_at: NotRequired["capo_iot.types.date_type.DateType"]
    """<p>The timestamp, when the command execution was created.</p>"""
    last_updated_at: NotRequired["capo_iot.types.date_type.DateType"]
    """<p>The timestamp, when the command execution was last updated.</p>"""
    started_at: NotRequired["capo_iot.types.date_type.DateType"]
    """<p>The timestamp, when the command execution was started.</p>"""
    completed_at: NotRequired["capo_iot.types.date_type.DateType"]
    """<p>The timestamp, when the command execution was completed.</p>"""
    time_to_live: NotRequired["capo_iot.types.date_type.DateType"]
    """<p>The time to live (TTL) parameter that indicates the duration for which executions will be retained in your account. The default value is six months.</p>"""

command_arn instance-attribute

command_arn: NotRequired[CommandArn]

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

completed_at instance-attribute

completed_at: NotRequired[DateType]

The timestamp, when the command execution was completed.

created_at instance-attribute

created_at: NotRequired[DateType]

The timestamp, when the command execution was created.

execution_id instance-attribute

execution_id: NotRequired[CommandExecutionId]

The unique identifier of the command execution.

execution_timeout_seconds instance-attribute

execution_timeout_seconds: NotRequired[CommandExecutionTimeoutInSeconds]

Specifies the amount of time in seconds that the device can take to finish a command execution. A timer starts when 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.

last_updated_at instance-attribute

last_updated_at: NotRequired[DateType]

The timestamp, when the command execution was last updated.

parameters instance-attribute

parameters: NotRequired[CommandExecutionParameterMap]

The list of parameters that the StartCommandExecution API used when performing the command on the device.

result instance-attribute

result: NotRequired[CommandExecutionResultMap]

The result value for the current state of the command execution. The status provides information about the progress of the command execution. The device can use the result field to share additional details about the execution such as a return value of a remote function call.

If you use the AWS-IoT-FleetWise namespace, then this field is not applicable in the API response.

started_at instance-attribute

started_at: NotRequired[DateType]

The timestamp, when the command execution was started.

status instance-attribute

status: NotRequired[CommandExecutionStatus]

The status of the command execution. After your devices receive the command and start performing the operations specified in the command, it can use the UpdateCommandExecution MQTT API to update the status information.

status_reason instance-attribute

status_reason: NotRequired[StatusReason]

Your devices can use this parameter to provide additional context about the status of a command execution using a reason code and description.

target_arn instance-attribute

target_arn: NotRequired[TargetArn]

The Amazon Resource Number (ARN) of the device on which the command execution is being performed.

time_to_live instance-attribute

time_to_live: NotRequired[DateType]

The time to live (TTL) parameter that indicates the duration for which executions will be retained in your account. The default value is six months.