Querying the Server List of the Software
Function
This API is used to query the server list of the software.
Calling Method
For details, see Calling APIs.
URI
GET /v5/{project_id}/asset/apps
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
host_id |
No |
String |
Server ID |
host_name |
No |
String |
Server name |
app_name |
No |
String |
Software name |
host_ip |
No |
String |
Server IP address |
version |
No |
String |
Version number |
install_dir |
No |
String |
Installation directory |
enterprise_project_id |
No |
String |
Enterprise project |
limit |
No |
Integer |
Default value: 10 |
offset |
No |
Integer |
Default value: 0 |
category |
No |
String |
Type. The default value is host. The options are as follows:
|
part_match |
No |
Boolean |
Whether fuzzy match is used. The default value is false. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
x-auth-token |
Yes |
String |
iam token |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
total_num |
Integer |
Total number |
data_list |
Array of AppResponseInfo objects |
Software list |
Parameter |
Type |
Description |
---|---|---|
agent_id |
String |
agent_id |
host_id |
String |
Server ID |
host_name |
String |
Server name |
host_ip |
String |
Server IP address |
app_name |
String |
Software name |
version |
String |
Version number |
update_time |
Long |
Update time |
recent_scan_time |
Long |
Latest scan time |
container_id |
String |
Container ID |
container_name |
String |
Container name |
Example Requests
The first 10 servers whose software name is ACL are queried by default.
GET https://{endpoint}/v5/{project_id}/asset/apps?app_name=acl
Example Responses
Status code: 200
Applications installed on a host
{ "total_num" : 1, "data_list" : [ { "agent_id" : "c9bed5397db449ebdfba15e85fcfc36accee125c68954daf5cab0528bab59bd8", "host_id" : "55dac7fe-d81b-43bc-a4a7-4710fe673972", "host_name" : "xxxx", "host_ip" : "192.168.0.126", "app_name" : "acl", "version" : "2.2.51-14.eulerosv2r7", "update_time" : 1668150671981, "recent_scan_time" : 1668506044147, "container_id" : "ce794b8a6071f5fd7e4d142dab7b36bedf2c7a4f6083fb82e5bbc82709b50018", "container_name" : "hss_imagescan_W73V1WO6" } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
Applications installed on a host |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot