Updated on 2025-11-19 GMT+08:00

Obtaining the Component List (V2)

Function

This API is used to obtain the component list.

URI

GET /v2/cmdb/apps/get-apps

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

business_id

No

Long

Application ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

x-business-id

Yes

Long

Application ID.

X-Auth-Token

Yes

String

User token obtained from IAM.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

apps

Array of AppNodeModel objects

Component information list.

Table 4 AppNodeModel

Parameter

Type

Description

id

Long

Component ID.

gmt_create

String

Creation time.

gmt_modify

String

Update time.

name

String

Component name.

business_id

Long

Application ID.

sub_business_id

Long

Sub-application ID.

inner_domain_id

Integer

Tenant ID.

data_source

String

Data source.

Example Requests

Obtain the component list based on the application ID.

/v2/cmdb/apps/get-apps?business_id=108903

{
  "business_id" : "108903"
}

Example Responses

Status code: 200

OK: The request is successful.

{
  "apps" : [ {
    "id" : 139775,
    "name" : "apm-access",
    "business_id" : 108903,
    "sub_business_id" : 278718,
    "data_source" : "APM"
  }, {
    "id" : 350758,
    "name" : "springcloudgateway",
    "business_id" : 108903,
    "data_source" : "APM"
  } ]
}

Status Codes

Status Code

Description

200

OK: The request is successful.

400

Bad Request: Semantic or parameter error.

401

Unauthorized: No permissions.

403

Forbidden: Access forbidden.

404

Not Found: The requested resource is not found.

Error Codes

See Error Codes.