Call the DescribeInvocationResults operation to view the execution results of one or more tasks.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string required Sample value: DescribeInvocationResults

The action that you want to perform. Value: DescribeInvocationResults.

Version string required Sample value: 2020-04-01

The API version. Value: 2020-04-01.

InvocationId string required Sample value: ivk-hz0jdfwd9f****

The job ID. You can call the DescribeInvocations operation to query and obtain the job ID.

InstanceId string Optional Sample value: i-bp1i7m****

The instance ID.

CommandId string Optional Sample value: cmd-hz0jdfwcsr****

The command ID.

InvocationResultStatus string Optional Sample value: Running

The execution status of the command in one instance. Valid values:

Pending: Initial status, indicating command execution is waiting for scheduling.

Running: Command is being executed.

Success: Command execution completes successfully.

Failed: Command execution completes but fails.

Timeout: Command execution times out.

PageNumber integer Optional Sample value: 1

The current page number.

Starting value: 1.

Default value: 1

PageSize integer Optional Sample value: 10

The number of entries returned on each page in a pagination query.

Value range: 1–100.

Default value: 10.

Response parameters

Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.

PageNumber integer Sample value: 1

The current page number.

PageSize integer Sample value: 10

The number of entries returned on each page in a pagination query.

TotalCount integer Sample value: 100

The total number of execution results.

InvocationResults object[] Sample value: --

The information on command execution results that meet the conditions.

ErrorMessage string Sample value: Task execution timeout

The error code of command execution failure.

InvocationResultId string Sample value: ivr-ycidmmvbm****

The ID of the task execution result.

InvocationId string Sample value: ivk-ycidmmvbm9l8j****

The ID of the executed task.

CommandId string Sample value: cmd-ybtvqkikdih96z8****

The command ID.

InstanceId string Sample value: i-ychq95dknz5pk****

The instance ID.

InvocationResultStatus string Sample value: Running

The status of the command progress in one instance.

Username string Sample value: root

The username for command execution in the instance.

Output string Sample value: success

The output when a Base64-encoded command is executed.

tip

Returned Base64-encoded command execution information, up to 16 KB.

ExitCode integer Sample value: 0

The exit status code after the script is executed.

tip

In a Linux instance, the exit code of a Shell command is its exit status.

ErrorCode string Sample value: TaskExecutionTimeout

Error codes displayed when command execution fails. Value:

TaskDeliveryTimeout: Indicates that command delivery times out.

TaskExecutionTimeout: Indicates that command execution times out.

TaskExecutionFailed: Indicates that command execution fails.

StartTime string Sample value: 2023-06-30T09:00:45Z

The time when the command execution begins in the instance.

EndTime string Sample value: 2023-07-01T09:00:45Z

The time when the command execution is completed.

Sample request

Sample response

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error code	Error message	Description
400	MissingParameter.AccountId	The required parameter AccountId is not supplied.	The user ID cannot be empty.
400	MissingParameter.InvocationId	The required InvocationId is not supplied.	The job ID cannot be empty.
400	InvalidInvocationResultStatus.Malformed	The specified InvocationResultStatus is malformed.	The specified execution status of the command in the instance is invalid.
500	InternalError	An internal error has occurred.	An internal error occurred. Try again. If multiple attempts fail, submit a ticket.

Elastic Compute Service