GetOptimizeRun

Updated at:

Queries the status, errors, execution progress, type-related results, and artifact references of a specified run.

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 /agentspace/{agentSpace}/optimizetasks/{optimizeTaskName}/runs/{optimizeRunId} HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

agentSpace

string

No

The name of the AgentSpace.

my-agent-space

optimizeTaskName

string

No

The name of the optimization task.

efficiency-analysis

optimizeRunId

string

No

The ID of the execution instance.

or-20260812-0001

Request parameters

Parameter

Type

Required

Description

Example

No parameters required.

Response elements

Element

Type

Description

Example

object

The execution details of the optimization task.

attemptCount

integer

The number of executed attempts.

1

createTime

string

The creation time.

2026-08-12T10:00:00Z

currentStage

string

The current execution stage.

attribution

errorCode

string

The error code.

InternalError

errorMessage

string

The error message.

The optimize run failed.

extra

object

The type-related information and immutable result references. For efficiency analysis, frozen outputBindings and tokenPublication release receipts are returned.

any

The value of a single field in the run type-related information. For example, preview indicates whether the run is a pre-run.

false

finishTime

string

The completion time.

2026-08-12T10:01:00Z

maxAttempts

integer

The maximum number of attempts.

3

optimizeRunId

string

The ID of the execution instance.

or-20260812-0001

optimizeTaskName

string

The name of the optimization task.

efficiency-analysis

progress

object

The current execution progress. The fields are defined by the task type.

any

The value of a single field in the current execution progress. The fields are defined by the task type. This object can be empty if no progress information is provided.

{}

requestId

string

The request ID.

9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M

startTime

string

The initial start time.

2026-08-12T10:00:01Z

status

string

The execution status.

Succeeded

trajectoryCount

integer

The number of analysis trajectories.

100

triggerType

string

The trigger type.

Scheduled

type

string

The task type snapshot.

EfficiencyAnalysis

windowEndTime

integer

The end time of the analysis window, in UNIX seconds.

1786432690000

windowStartTime

integer

The start time of the analysis window, in UNIX seconds.

1786432688000

Examples

Success response

JSON format

{
  "attemptCount": 1,
  "createTime": "2026-08-12T10:00:00Z",
  "currentStage": "attribution",
  "errorCode": "InternalError",
  "errorMessage": "The optimize run failed.",
  "extra": {
    "key": "false"
  },
  "finishTime": "2026-08-12T10:01:00Z",
  "maxAttempts": 3,
  "optimizeRunId": "or-20260812-0001",
  "optimizeTaskName": "efficiency-analysis",
  "progress": {
    "key": "{}"
  },
  "requestId": "9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M",
  "startTime": "2026-08-12T10:00:01Z",
  "status": "Succeeded",
  "trajectoryCount": 100,
  "triggerType": "Scheduled",
  "type": "EfficiencyAnalysis",
  "windowEndTime": 1786432690000,
  "windowStartTime": 1786432688000
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.