Asset Fingerprints - Port - Server List

Function

Servers or containers having the port

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/asset/ports/detail

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Enterprise project
host_name	No	String	Server name
host_ip	No	String	Server IP address
port	Yes	Integer	Port number
type	No	String	Port type
category	No	String	Type. The default value is host. The options are as follows: host container
limit	No	Integer	Default value: 10
offset	No	Integer	Default value: 0

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
x-auth-token	Yes	String	iam token

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
total_num	Integer	Total servers
data_list	Array of PortHostResponseInfo objects	Server information list

**Table 5** PortHostResponseInfo
Parameter	Type	Description
container_id	String	Image ID
host_id	String	Server ID
host_ip	String	Server IP address
host_name	String	Server name
laddr	String	Listening IP address
path	String	Program file path
pid	Integer	pid
port	Integer	Port
status	String	Status
type	String	Type
container_name	String	Container name
agent_id	String	agent id

Example Requests

The first 10 servers whose port number is 22 are queried by default.

GET https://{endpoint}/v5/{project_id}/asset/ports/detail?port=22

Example Responses

Status code: 200

Servers having the port

{
  "total_num" : 1,
  "data_list" : [ {
    "host_id" : "03117200-xxxx-xxxx-xxxx-a89a10e66dbe",
    "host_ip" : "192.168.0.1",
    "host_name" : "ecs-eule",
    "laddr" : "0.0.0.0",
    "path" : "C:\\Windows\\system32\\svchost.exe",
    "process_path" : "/CloudResetPwdUpdateAgent/bin/wrapper",
    "port" : 888,
    "status" : "unknow",
    "type" : "UDP",
    "container_id" : "ce794b8a6-xxxx-xxxx-xxxxx-36bedf2c7a4f6083fb82e5bbc82709b50018",
    "container_name" : "hss_imagescan_W73V1WO6",
    "agent_id" : "03jjj-xxxx-xxxx-wwwsedf"
  } ]
}