启动注册

使用请求体中的安装码开始 `Agent` 注册。必须校验来源限制和安装码，不使用 Bearer 认证。响应包含敏感的短期会话。

POST/api/v1/lifecycle/managed-agent/enrollments

操作 ID

StartEnrollment

起始版本

1.3.0

执行模式

同步

认证信息

无需认证

请求参数

application/json

请求体字段

requestId
String必填
请求ID。
示例： 7a91f507-c563-42a7-8b42-cb6b2c12f319
enrollmentCode
String必填
邀请提供的必需一次性注册凭据。通过请求体发送，不得放入 URL、日志或命令行参数。
示例： {enrollmentCode}
platform
Object
资源。
- os
  String
  目标机器的操作系统发行版标识符，例如 `rocky` 或 `ubuntu`；与 `version` 和 `arch` 一起用于验证 `Agent` 发布版本的兼容性。
  示例： value
- version
  String
  版本号。
  示例： value
- arch
  String
  用于选择 `Agent` 安装包的目标机器 CPU 架构，例如 `x86_64`（`amd64`）或 `aarch64`（`arm64`）。
  示例： value

响应状态

200 OK

200 OK

该 API 成功时返回以下响应结构。

attemptId
String
资源。
示例： value
reservedAgentId
String
已预留代理ID。
示例： value
enrollmentSession
String
仅用于显式交付敏感信息；不得记录或跟踪此响应。
示例： value
agentPackage
Object
资源。
- agentVersion
  String
  代理版本。
  示例： value
- sha256
  String
  数据完整性校验值（SHA-256）。
  示例： value
- release
  String
  该资源的发布版本。
  示例： 10
- signatureKeyId
  String
  资源。
  示例： value
- signature
  String
  资源。
  示例： value

变更历史

查看全部变更历史

变更时间变更内容概要操作

变更时间
2026-09-17
新增响应字段 release已删除响应字段 releaseSequence
查看 API