更新时间：2026-01-08 GMT+08:00
查询开放端口统计信息
功能介绍
查询开放端口列表，支持通过传入端口或协议类型查询服务器数
URI
GET /v5/{project_id}/asset/port/statistics
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| port | 否 | Integer | 端口号，精确匹配 |
| port_string | 否 | String | 端口字符串，用来进行模糊匹配 |
| type | 否 | String | 端口类型 |
| enterprise_project_id | 否 | String | 企业项目ID，查询所有企业项目时填写：all_granted_eps |
| sort_key | 否 | String | 排序的key值，目前支持按照端口号port排序 |
| sort_dir | 否 | String | 升序还是降序，默认升序，asc |
| limit | 否 | Integer | 每页显示数量 |
| offset | 否 | Integer | 偏移量：指定返回记录的开始位置 |
| category | 否 | String | 类别，默认为host，包含如下：
|
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total_num | Integer | 开放端口总数 |
| data_list | Array of PortStatisticResponseInfo objects | 开放端口统计信息列表 |
请求示例
默认查询前10条端口为123，类别为主机的开放端口列表
GET https://{endpoint}/v5/{project_id}/asset/port/statistics?port=123&category=host 响应示例
状态码：200
请求已成功
{
"total_num" : 1,
"data_list" : [ {
"num" : 4,
"port" : 123,
"type" : "UDP",
"status" : "danger"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
错误码
请参见错误码。
父主题： 资产管理
