Querying the Software List
Function
This API is used to query the software list. The number of servers can be queried by software name.
URI
GET /v5/{project_id}/asset/app/statistics
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
app_name | No | String | Software name |
enterprise_project_id | No | String | Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps. |
limit | No | Integer | Number of records on each page |
offset | No | Integer | Offset, which specifies the start position of the record to be returned. |
category | No | String | Type. The default value is host. The options are as follows:
|
Request Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a user token. |
Response Parameters
Status code: 200
Parameter | Type | Description |
---|---|---|
total_num | Integer | Total number of process statistics |
data_list | Array of AppStatisticResponseInfo objects | Process statistics list |
Parameter | Type | Description |
---|---|---|
app_name | String | Software name |
num | Integer | Number of processes |
Example Requests
The first 10 software lists whose type is host are queried by default.
GET https://{endpoint}/v5/{project_id}/asset/app/statistics?category=host
Example Responses
Status code: 200
Request succeeded.
{"total_num" : 1,"data_list" : [ {"app_name" : "kernel","num" : 13} ]}
Status Codes
Status Code | Description |
---|---|
200 | Request succeeded. |
Error Codes
See Error Codes.
- URI