Help Center/ CodeArts Deploy/ API Reference (Ally Region)/ APIs/ Managing Applications/ Obtaining an Application List (Recommended)
Updated on 2026-01-15 GMT+08:00

Obtaining an Application List (Recommended)

Function

This API is used to query an application list in a project.

Calling Method

For details, see Calling APIs.

URI

POST /v1/applications/list

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Definition:

Type (or format) of the message body.

Constraints:

N/A.

Value range:

N/A.

Default value:

N/A.

X-Auth-Token

Yes

String

Definition:

User token. Obtain a token (the value of the X-Subject-Token response header) by calling the IAM API used for.

Constraints:

N/A.

Value range:

String. Max. 20,000 characters.

Default value:

N/A.

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description:

Project ID. For details, see Obtaining a Project ID.

Constraints:

N/A

Value range:

The value consists of 32 characters. Only letters and digits are allowed.

Default value:

N/A

page

Yes

Integer

Parameter description:

Page number, which means the query starts from this page.

Constraints:

N/A

Value range:

1-99,999

Default value:

N/A

size

Yes

Integer

Parameter description:

Number of items displayed on each page.

Constraints:

N/A

Value range:

1-100

Default value:

N/A

sort_name

No

String

Parameter description:

Sort field name.

Constraints:

N/A

Value range:

  • name: Application name.

  • startTime: Start time.

Default value:

N/A

sort_by

No

String

Parameter description:

Sorting sequence.

Constraints:

N/A

Value range:

  • ASC: Ascending

  • asc: Ascending

  • DESC: Descending

  • desc: Descending

Default value:

N/A

states

No

Array of strings

Parameter description:

Application status list.

Constraints:

N/A

Value range:

  • abort: Deployment suspended

  • failed: Deployment failed

  • not_started: Execution canceled

  • pending: Queuing

  • running: Deployment in progress

  • succeeded: Deployment succeeded

  • timeout: Deployment times out

  • not_executed: Deployment not executed

Default value:

N/A

group_id

No

String

Parameter description:

Application group ID. Enter no_grouped to query ungrouped applications.

Constraints:

N/A

Value range:

The value consists of 32 characters. Only letters and digits are allowed or the no_grouped value is transferred.

Default value:

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

total_num

Integer

Parameter description:

Total number of applications.

Value range:

N/A

result

Array of AppExecutionInfo objects

Parameter description:

Application list array.

Table 4 AppExecutionInfo

Parameter

Type

Description

id

String

Parameter description:

Application ID.

Value range:

The value consists of 32 characters. Letters and digits are allowed.

name

String

Parameter description:

Application name.

Value range:

The value consists of 3-128 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed.

duration

String

Definition:

Last deployment duration. Format: HH:mm:ss.

Value range:

N/A.

is_disable

Boolean

Parameter description:

Whether the application is disabled.

Value range:

  • true: Disabled

  • false: Not disabled

project_id

String

Parameter description:

Project ID.

Value range:

The value consists of 32 characters. Letters and digits are allowed.

project_name

String

Parameter description:

Project name.

Value range:

The value consists of 3 to 128 characters.

is_care

Boolean

Definition:

Whether you have favorited the application.

Value range:

  • true: Yes.

  • false: No.

can_modify

Boolean

Definition:

Whether you have the edit permission.

Value range:

  • true: Yes.

  • false: No.

can_delete

Boolean

Definition:

Whether you have the delete permission.

Value range:

  • true: Yes.

  • false: No.

can_view

Boolean

Definition:

Whether you have the view permission.

Value range:

  • true: Yes.

  • false: No.

can_execute

Boolean

Definition:

Whether you have the deployment permission.

Value range:

  • true: Yes.

  • false: No.

can_copy

Boolean

Definition:

Whether you have the copy permission.

Value range:

  • true: Yes.

  • false: No.

can_manage

Boolean

Definition:

Whether you have permission to edit the application permission matrix.

Value range:

  • true: Yes.

  • false: No.

can_create_env

Boolean

Definition:

Whether you have permission to create an environment.

Value range:

  • true: Yes.

  • false: No.

can_disable

Boolean

Definition:

Whether you have permission to disable applications.

Value range:

  • true: Yes.

  • false: No.

deploy_system

String

Parameter description:

Deployment mode.

Value range:

  • deployTemplate: Deployment template

create_user_id

String

Parameter description:

ID of the application creator.

Value range:

The value consists of 1-32 characters. Letters and digits are allowed.

create_tenant_id

String

Parameter description:

Tenant ID of the application creator.

Value range:

The value consists of 1-32 characters. Letters and digits are allowed.

create_time

String

Parameter description:

Creation time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27.

Value range:

N/A

update_time

String

Parameter description:

Modification time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27.

Value range:

N/A

execution_time

String

Parameter description:

Last deployment time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27.

Value range:

N/A

end_time

String

Definition:

End time of the last deployment. Format: yyyy-MM-dd HH:mm:ss. Example: 2021-02-25 10:37:27.

Value range:

N/A.

execution_state

String

Definition:

Deployment status.

Value range:

  • abort: Deployment stopped.

  • failed: Deployment failed.

  • not_started: Execution canceled.

  • pending: Queuing.

  • running: Deployment in progress.

  • succeeded: Deployment succeeded.

release_id

Integer

Parameter description:

Deployment record sequence number.

Value range:

N/A

executor_id

String

Definition:

ID of the last deployer.

Value range:

1 to 32 characters, including letters and digits.

executor_nick_name

String

Definition:

Nickname of the last deployer.

Value range:

N/A.

arrange_infos

Array of TaskBaseResponseBody objects

Parameter description:

Deployment task information.

Table 5 TaskBaseResponseBody

Parameter

Type

Description

id

String

Parameter description:

Deployment application ID.

Value range:

The value consists of 32 characters. Letters and digits are allowed.

state

String

Definition:

Deployment application status.

Value range:

  • Available: Executable status.

  • Draft: Draft status.

  • initialized: Initialization status.

deploy_system

String

Parameter description:

Deployment mode.

Value range:

  • deployTemplate: Deployment template

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code

error_msg

String

Error description

Status code: 403

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code

error_msg

String

Error description

Example Requests

This API is used to obtain an application list.

https://{endpoint}/v1/applications/list

{
  "project_id" : "6039d4480efc4dddb178abff98719913",
  "page" : 1,
  "size" : 10
}

Example Responses

Status code: 200

OK: The request is successful.

{
  "result" : [ {
    "id" : "cb439d016d8641c8a44c177a121fad15",
    "name" : "Test",
    "duration" : "00:00:17",
    "is_disable" : true,
    "project_id" : "1ff8aa6dda4643bd9cbdbb588fb24bde",
    "project_name" : "Project 1",
    "is_care" : false,
    "can_modify" : true,
    "can_delete" : true,
    "can_view" : true,
    "can_execute" : true,
    "can_copy" : true,
    "can_manage" : false,
    "can_create_env" : false,
    "can_disable" : false,
    "create_user_id" : "04ec4661a8df4359b50980a9c958c86d",
    "create_tenant_id" : "208fbb09068e4820b9209ef9ff4da73d",
    "create_time" : "2023-07-05 20:34:40.0",
    "update_time" : "2023-08-02 14:20:30.0",
    "execution_time" : "2023-08-18 09:40:16",
    "end_time" : "2023-08-18 09:40:33",
    "execution_state" : "failed",
    "release_id" : 4,
    "executor_id" : "6baa7454109d47c192f22078fe6cda20",
    "executor_nick_name" : "Test Account",
    "arrange_infos" : [ {
      "id" : "e700f15965694253940502911220d76b",
      "state" : "Draft",
      "deploy_system" : "deployTemplate"
    } ]
  } ],
  "total_num" : 1
}

Status code: 400

Bad Request

{
  "error_code" : "Deploy.00015002",
  "error_msg" : "Invalid request parameter."
}

Status code: 403

Forbidden

{
  "error_code" : "Deploy.00011154",
  "error_msg" : "You do not have permissions to perform this operation."
}

Status Codes

Status Code

Description

200

OK: The request is successful.

400

Bad Request

403

Forbidden

Error Codes

See Error Codes.