All Products
Search
Document Center

Cloud Phone:DescribeScheduledTaskExecutions

Last Updated:Aug 28, 2026

Queries the execution records of an agent scheduled task.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

ScheduledId

string

Yes

The ID of the scheduled task.

sch-260705-agb*****

InstanceId

string

No

The instance ID.

acp-axxkuuxahbu1*****

Status

string

No

The status of the scheduled task.

COMPLETED

StartTime

string

No

The start time of the time range in ISO 8601 format.

2026-06-01T00:00:00

EndTime

string

No

The end time of the time range in ISO 8601 format.

2026-06-12T23:59:59

NextToken

string

No

The pagination token. Leave this parameter empty for the first request.

AAAAAV3MpHK1AP0pfERHZN5pu6kU****

MaxResults

integer

No

The maximum number of results to return per request. Default value: 20. Maximum value: 100.

20

Response elements

Element

Type

Description

Example

object

ApiResponse

RequestId

string

The request ID.

9A51B1DF-96FF-3BCC-B08C-783161D3****

Code

string

The status code of the operation.

200

Message

string

The response message.

Success.

TotalCount

integer

The number of results returned.

10

NextToken

string

The pagination token for the next page.

AAAAAV3MpHK1AP0pfERHZN5pu6kU****

Executions

array<object>

The list of task execution records.

array<object>

The scheduled task execution record information.

TaskId

string

The ID of the scheduled task execution record.

t-260703-gby*****

ScheduledId

string

The ID of the scheduled task.

sch-260705-agb*****

InstanceId

string

The instance ID.

acp-axxkuuxahbu1*****

Status

string

The execution status.

COMPLETED

StartedAt

string

The start time.

2026-06-12T00:00:00

CompletedAt

string

The end time.

2026-06-12T00:05:30

ConfigSnapshot

string

The configuration snapshot in JSON format.

{"maxSteps":10}

DurationMs

integer

The execution duration in milliseconds.

330000

Output

string

The execution output in JSON format.

{"result":"ok"}

ErrorCode

string

The error code.

TaskTimeout

ErrorMessage

string

The error message.

task timeout after 600s

ArtifactCount

integer

The number of task artifacts.

2

Artifacts

array<object>

The list of uploaded task artifacts.

object

The artifact information.

Name

string

The file name.

screenshot.png

Size

integer

The file size in bytes.

1024

ContentType

string

The MIME type.

image/png

DownloadUrl

string

The OSS pre-signed download URL.

https://bucket.oss-cn-hangzhou.aliyuncs.com/...

UpdatedTime

string

The upload time in ISO 8601 format.

2026-08-05T10:00:00+08:00

MaxResults

integer

The maximum number of results returned in this request.

20

Examples

Success response

JSON format

{
  "RequestId": "9A51B1DF-96FF-3BCC-B08C-783161D3****",
  "Code": "200",
  "Message": "Success.",
  "TotalCount": 10,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU****",
  "Executions": [
    {
      "TaskId": "t-260703-gby*****",
      "ScheduledId": "sch-260705-agb*****",
      "InstanceId": "acp-axxkuuxahbu1*****",
      "Status": "COMPLETED",
      "StartedAt": "2026-06-12T00:00:00",
      "CompletedAt": "2026-06-12T00:05:30",
      "ConfigSnapshot": "{\"maxSteps\":10}",
      "DurationMs": 330000,
      "Output": "{\"result\":\"ok\"}",
      "ErrorCode": "TaskTimeout",
      "ErrorMessage": "task timeout after 600s",
      "ArtifactCount": 2,
      "Artifacts": [
        {
          "Name": "screenshot.png",
          "Size": 1024,
          "ContentType": "image/png",
          "DownloadUrl": "https://bucket.oss-cn-hangzhou.aliyuncs.com/...",
          "UpdatedTime": "2026-08-05T10:00:00+08:00"
        }
      ]
    }
  ],
  "MaxResults": 20
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.