文档首页/ 企业主机安全 HSS/ API参考/ API说明/ asset/ AI组件详细信息 - ListAiComponentDetail
更新时间:2026-05-11 GMT+08:00
分享

AI组件详细信息 - ListAiComponentDetail

功能介绍

查询AI组件详细信息

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/asset/ai-component/detail

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

参数解释:

每页显示个数

约束限制:

不涉及

取值范围:

取值10-200

默认取值:

10

offset

Integer

参数解释:

偏移量:指定返回记录的开始位置

约束限制:

不涉及

取值范围:

最小值0,最大值2000000

默认取值:

默认为0

category

String

参数解释:

资产类别

约束限制:

不涉及

取值范围:

  • host:主机资产

  • container:容器资产

默认取值:

host

catalogue

String

参数解释:

AI组件类别

约束限制:

不涉及

取值范围:

  • app:应用

  • tool:工具

默认取值:

不涉及

server_name

String

参数解释:

category==host时 表示服务器名称

category==container时 表示节点名称

category==serverless时 表示实例名称

约束限制:

不涉及

取值范围:

字符长度0-256位

默认取值:

不涉及

server_ip

String

参数解释:

category==host时 表示服务器IP地址

category==container时 表示节点IP地址

category==serverless时 表示实例IP地址

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

ai_application

String

参数解释:

AI应用名称

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

host_id

String

参数解释:

服务器ID

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

ai_tool

String

参数解释:

AI工具名称

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

type

String

参数解释:

AI应用类型

约束限制:

不涉及

取值范围:

字符长度0-64位

默认取值:

不涉及

version

String

参数解释:

AI版本

约束限制:

不涉及

取值范围:

字符长度0-32位

默认取值:

不涉及

installation_path

String

参数解释:

安装路径

约束限制:

不涉及

取值范围:

字符长度0-512位

默认取值:

不涉及

first_scan_time

Long

参数解释:

首次扫描时间,时间单位毫秒(ms)

约束限制:

不涉及

取值范围:

取值0-9223372036854775807

默认取值:

不涉及

latest_scan_time

Long

参数解释:

最近扫描时间,时间单位毫秒(ms)

约束限制:

不涉及

取值范围:

取值0-9223372036854775807

默认取值:

不涉及

container_name

String

参数解释:

容器名称

约束限制:

不涉及

取值范围:

字符长度0-256位

默认取值:

不涉及

container_id

String

参数解释:

容器ID

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

image_name

String

参数解释:

镜像名称

约束限制:

不涉及

取值范围:

字符长度0-256位

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,包含了用户的身份、权限等信息,在调用API接口时,可通过Token进行身份认证。获取方式请参见获取用户Token

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

参数解释

AI组件详情列表总数

data_list

Array of AIDetailInfoResponseInfo objects

参数解释

AI组件列表

表5 AIDetailInfoResponseInfo

参数

参数类型

描述

server_name

String

参数解释

category==host时 表示服务器名称

category==container时 表示节点名称

category==serverless时 表示实例名称

取值范围

字符长度1-256位

server_ip

String

参数解释

category==host时 表示服务器IP地址

category==container时 表示节点IP地址

category==serverless时 表示实例IP地址

取值范围

字符长度1-128位

ai_application

String

参数解释

AI应用名称

取值范围

字符长度1-256位

ai_tool

String

参数解释

AI工具名称

取值范围

字符长度1-256位

type

String

参数解释

AI应用类型

取值范围

字符长度1-256位

version

String

参数解释

版本号

取值范围

字符长度1-64位

startup_path

String

参数解释

应用启动路径

取值范围

字符长度1-512位

startup_time

Long

参数解释

应用启动时间

取值范围

时间戳,毫秒级

install_path

String

参数解释

安装路径

取值范围

字符长度1-512位

cmdline

String

参数解释

应用启动命令行

取值范围

字符长度1-512位

first_scan_time

Long

参数解释

首次扫描时间

取值范围

时间戳,毫秒级

latest_scan_time

Long

参数解释

最近一次扫描时间

取值范围

时间戳,毫秒级

container_name

String

参数解释

容器名称

取值范围

字符长度1-256位

container_id

String

参数解释

容器ID

取值范围

字符长度1-128位

host_id

String

参数解释

服务器ID,查看服务器详情使用

取值范围

字符长度1-128位

pid

Integer

参数解释

应用进程PID

取值范围

取值0-2147483647

ppid

Integer

参数解释

应用进程的父进程PID

取值范围

取值0-2147483647

user

String

参数解释

应用运行用户

取值范围

字符长度1-128位

net_info

Array of AIProcessNetInfo objects

参数解释

应用进程监听网络信息

表6 AIProcessNetInfo

参数

参数类型

描述

listen_ip

String

参数解释

应用进程监听IP

取值范围

取值0-2147483647

listen_protocol

String

参数解释

应用进程监听对应的网络协议

取值范围

  • tcp:tcp协议

  • udp:udp协议

listen_port

Long

参数解释

应用进程监听端口

取值范围

取值0-2147483647

listen_status

String

参数解释

应用进程监听状态

取值范围

  • established:已建立连接

  • closed:连接已关闭

  • listening:监听中

  • other:连接中间态

请求示例

默认查询前10条类别为主机,目录为工具的AI组件统计信息列表

GET https://{endpoint}/v5/{project_id}/asset/ai-component/detail?limit=10&offset=0&category=host&catalogue=app&name=pytorch

响应示例

状态码:200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "server_name" : "ecs_test"
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档