更新时间:2025-09-23 GMT+08:00

查询单服务器的开放端口列表

功能介绍

查询单服务器的开放端口列表

URI

GET /v5/{project_id}/asset/ports

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户ID

表2 Query参数

参数

是否必选

参数类型

描述

host_id

String

主机id

host_name

String

主机名称

host_ip

String

主机ip

port

Integer

端口号

type

String

端口类型

enterprise_project_id

String

企业项目

limit

Integer

默认10

offset

Integer

默认是0

category

String

类别,默认为host,包含如下:

  • host:主机

  • container:容器

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

String

iam token

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

总数

data_list

Array of PortResponseInfo objects

端口信息列表

表5 PortResponseInfo

参数

参数类型

描述

host_id

String

主机id

laddr

String

监听ip

status

String

port status, normal, danger or unknow

  • "normal" : 正常

  • "danger" : 危险

  • "unknow" : 未知

port

Integer

端口号

type

String

类型

pid

Integer

进程ID

path

String

程序文件

请求示例

默认查询前10条host_id为dd91cd32-a238-4c0e-bc01-3b11653714ac的开放端口列表

GET https://{endpoint}/v5/{project_id}/asset/ports?hlimit=10&offset=0&host_id=dd91cd32-a238-4c0e-bc01-3b11653714ac

响应示例

状态码:200

端口信息列表

{
  "data_list" : [ {
    "agent_id" : "eb5d03f02fffd85aaf5d0ba5c992d97713244f420e0b076dcf6ae0574c78aa4b",
    "container_id" : "",
    "host_id" : "dd91cd32-a238-4c0e-bc01-3b11653714ac",
    "laddr" : "0.0.0.0",
    "path" : "/usr/sbin/dhclient",
    "pid" : 1507,
    "port" : 68,
    "status" : "unknow",
    "type" : "UDP"
  }, {
    "agent_id" : "eb5d03f02fffd85aaf5d0ba5c992d97713244f420e0b076dcf6ae0574c78aa4b",
    "container_id" : "",
    "host_id" : "dd91cd32-a238-4c0e-bc01-3b11653714ac",
    "laddr" : "127.0.0.1",
    "path" : "/usr/sbin/chronyd",
    "pid" : 493,
    "port" : 323,
    "status" : "unknow",
    "type" : "UDP"
  } ],
  "total_num" : 2
}

状态码

状态码

描述

200

端口信息列表

错误码

请参见错误码