更新时间:2026-01-08 GMT+08:00

查询自启动项的服务列表

功能介绍

查询自启动项的服务列表

URI

GET /v5/{project_id}/asset/auto-launchs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

host_id

String

主机id

host_name

String

主机名称

name

String

自启动项名称

host_ip

String

主机ip

type

String

自启动项类型

  • 0 :自启动服务

  • 1 :定时任务

  • 2 :预加载动态库

  • 3 :Run注册表键

  • 4 :开机启动文件夹

enterprise_project_id

String

企业项目ID,查询所有企业项目时填写:all_granted_eps

limit

Integer

每页显示数量

offset

Integer

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

part_match

Boolean

是否模糊匹配,默认false表示精确匹配

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

自启动项总数

data_list

Array of AutoLauchResponseInfo objects

自启动项列表

表5 AutoLauchResponseInfo

参数

参数类型

描述

agent_id

String

Agent ID

host_id

String

主机id

host_name

String

服务器名称

host_ip

String

服务器ip

name

String

自启动项名称

type

Integer

自启动项类型

  • 0 :自启动服务

  • 1 :定时任务

  • 2 :预加载动态库

  • 3 :Run注册表键

  • 4 :开机启动文件夹

path

String

自启动项的路径

hash

String

采用sha256算法生成的文件hash值

run_user

String

运行用户

recent_scan_time

Long

最近扫描时间

请求示例

默认查询前10条自启动项名称为S50multi-queue的服务列表

GET https://{endpoint}/v5/{project_id}/asset/auto-launchs?name=S50multi-queue

响应示例

状态码:200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "agent_id" : "9e742932bff2894e3d0869d03989b05cefb27a6cbc201d98c4465296xxxxxxxx",
    "host_id" : "3d0581a5-03b9-4311-9149-c026b0726a7e",
    "host_name" : "name",
    "host_ip" : "3d0581a5-03b9-4311-9149-c026b0726a7e",
    "name" : "S12hostguard",
    "type" : 0,
    "path" : "/etc/hostguard",
    "hash" : "xxxxxxxx227bffa0c04425ba6c8e0024046caa38dfbca6281b40109axxxxxxxx",
    "run_user" : "user",
    "recent_scan_time" : 1668240858425
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码