Help Center/ CodeArts PerfTest/ API Reference/ API/ Report Management/ Querying the Case List of a Task Report

Updated on 2026-02-09 GMT+08:00

View PDF

Querying the Case List of a Task Report

Function

This API is used to query the case list of a task report.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
codeartsperftest:cpts:getPerfTestTask	Read	cpts *	g:ResourceTag/<tag-key>	-	-

URI

GET /v2/{project_id}/task-run-infos/{task_run_id}/cases

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
task_run_id	Yes	Integer	ID of a running task, that is, the report ID. When a task API (for updating task status or starting or stopping tasks in batches) is called, the running task ID is returned.
project_id	Yes	String	Project ID. For details, see Method of obtaining instructions.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
code	String	Status code.
message	String	Response.
extend	Object	Extended information.
result	CaseReportSummary object	Test report case list.

**Table 3** CaseReportSummary
Parameter	Type	Description
case_aw_info_list	Array of CaseAwInfo objects	Case and AW information view.
err_message	String	Error message.

**Table 4** CaseAwInfo
Parameter	Type	Description
aw	Array of AwInfoDTO objects	AW information.
awList	Array of DetailItem objects	List of detailed AW information.
caseAwId	String	Primary key ID in the dc_case_aw table in the database.
caseUri	String	case_uri in the dc_testcase table in the database.
case_uri_i	String	case_uri_iteration in the dc_testcase table in the database.
datumType	Integer	Data type (case/AW/transaction).
id	String	Primary key ID in the dc_case_aw table in the database.
name	String	Case name.
taskExecId	String	testcase_id in the dc_testcase table in the database.
taskId	String	Task ID.
testcaseId	String	testcase_id in the dc_testcase table in the database.
transactionList	Array of DetailItem objects	List of detailed transaction information.

**Table 5** AwInfoDTO
Parameter	Type	Description
name	String	AW name.
id	String	Primary key ID in the dc_case_aw table in the database.
datumType	Integer	Data type (case/AW/transaction).

**Table 6** DetailItem
Parameter	Type	Description
caseAwId	String	Primary key ID in the dc_case_aw table in the database.
datumType	Integer	Data type (case/AW/transaction).
name	String	Case, AW, or transaction name.
transactionId	String	Transaction ID, which is the value of tempId in the response body of the API for creating a transaction.
awList	Array of DetailItem objects	AW list.

Example Requests

Querying the case list of a task whose task ID is 1.

/v2/{project_id}/task-run-infos/1/cases

Example Responses

Status code: 200

Response object for the task case list.

{
  "code" : "SVCSTG.CPTS.0000000",
  "message" : "success",
  "extend" : null,
  "result" : {
    "case_aw_info_list" : [ {
      "aw" : [ {
        "datumType" : 0,
        "id" : "7053151331402211329",
        "name" : "request-example"
      } ],
      "awList" : [ {
        "awList" : null,
        "caseAwId" : "7053151331402211329",
        "datumType" : 0,
        "name" : "request-example",
        "transactionId" : null
      } ],
      "caseAwId" : "7053151331402211328",
      "caseUri" : null,
      "case_uri_i" : "83820",
      "datumType" : 1,
      "id" : "7053151331402211328",
      "name" : "test-case",
      "taskExecId" : "5206012",
      "taskId" : "az-4-69824",
      "testcaseId" : "5206012",
      "transactionList" : [ ]
    } ],
    "err_message" : null
  }
}