AggregationService 框级汇聚接口评审
本次评审目标：各聚合管理功能的北向 WebREST 路径与资源树路径。接口下属性、方法、信号的独立评审点本次不展开。
1. 背景
管理板（SMM）需要对框内多块节点 BMC 提供统一框级运维管理界面，例如通过管理板 Web 界面批量升级框内多块节点板固件和固件版本信息查询、一键式信息批量收集、多节点电源状态查询与设置、多节点BMC网络信息查询和配置等能力。管理板需要提供 WebREST 管理接口，以及框级聚合管理的资源树接口。
2. 整体方案
管理板提供聚合管理的 WebREST 接口，支持用户通过 Web 界面选择目标操作以及目标单板；产品组件实现聚合管理的资源树接口，将调用拆分至各目标 BMC 已有接口，并将聚合结果返回上层（Web）。
| 维度 | 说明 |
|---|---|
| 部署位置 | 管理板（框级） |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/ |
| WebREST 路径 | /UI/Rest/Chassis/AggregationService/（不带 Aggregates/${AggregateId}；当前机框由管理板上下文确定） |
资源树路径层级（机框，管理板 AggregationService，与 BMC 本地系统/管理路径隔离）
/bmc/kepler/AggregationService/Aggregates/${AggregateId} 汇聚组
├── CertificateService 证书
├── AccountService BMC账户管理
├── ConfigurationService 配置管理
├── LogService 日志收集
├── UpdateService 固件升级
├── SystemService 启动项
├── NetworkService BMC网络配置
├── PowerService 电源
├── AssetService 资产/健康
├── ChassisService 机框管理
└── IpmbEthBlades/${IpmbEthBladeId} 单板对象
WebREST 路径层级（框级，前缀 /UI/Rest/Chassis/AggregationService）
/UI/Rest/Chassis/AggregationService
├── AccountService BMC账户管理
├── Configuration 配置导入导出
│ ├── Actions/ImportConfig
│ ├── Actions/ExportConfig
│ └── ImportExportProgress
├── ConfigurationFiles 配置文件缓存
│ ├── ListExportFiles
│ ├── DownloadExportFile
│ └── DeleteExportFile
├── LogService 日志收集
│ ├── Actions/Dump
│ └── DumpProgress
├── Update 固件升级
│ ├── FirmwareInventory/:Id
│ ├── FirmwareInventory/UpdateProgress
│ ├── PendingFirmwares/:Id
│ └── Actions
│ ├── Update.StartActive
│ ├── Update.Reset
│ └── Update.SwitchImage
├── BootOptions 启动项
├── NetworkService BMC网络配置
├── PowerControl 电源
├── AssetInventory 资产
└── AssetHealthStatus 健康
3. 评审点清单
| 评审点编号 | 类别 | 评审对象 | 北向 WebREST 路径 | 资源树 Path | 实现接口 | 方法 | 详细 |
|---|---|---|---|---|---|---|---|
| AS-01 | 新增路径 | 汇聚组 | —（不提供 WebREST 集合 URL，仅资源树） | /bmc/kepler/AggregationService/Aggregates/${AggregateId} |
—（仅属性） | §4.1 | |
| AS-02 | 既有路径 | 证书 | /UI/Rest/Chassis/AggregationService/Certificate/Actions/Certificate.ExportCSR /UI/Rest/Chassis/AggregationService/Certificate/Actions/Certificate.ImportCertificate /UI/Rest/Chassis/AggregationService/Certificate/Actions/Certificate.ImportCACertificate | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/CertificateService |
bmc.kepler.AggregationService.Certificate（既有） |
— | §4.2 |
| AS-03 | 新增路径、新增 WebREST 接口 | BMC账户管理 | /UI/Rest/Chassis/AggregationService/AccountService |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/AccountService |
bmc.kepler.AggregationService.Account |
GetAccounts、NewAccount、ModifyAccount、DeleteAccount | §4.3 |
| AS-04 | 新增路径、新增 WebREST 接口 | 配置管理 | /UI/Rest/Chassis/AggregationService/Configuration/Actions/ImportConfig/UI/Rest/Chassis/AggregationService/Configuration/Actions/ExportConfig/UI/Rest/Chassis/AggregationService/Configuration/ImportExportProgress/UI/Rest/Chassis/AggregationService/ConfigurationFiles/ListExportFiles/UI/Rest/Chassis/AggregationService/ConfigurationFiles/DownloadExportFile/UI/Rest/Chassis/AggregationService/ConfigurationFiles/DeleteExportFile |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/ConfigurationService |
bmc.kepler.AggregationService.Configurationbmc.kepler.AggregationService.ConfigurationFile |
Import、Export、GetImportExportProgress ListExportFiles、DownloadExportFile、DeleteExportFile |
§4.4 |
| AS-05 | 新增路径、新增 WebREST 接口 | 日志收集 | /UI/Rest/Chassis/AggregationService/LogService/Actions/Dump/UI/Rest/Chassis/AggregationService/LogService/DumpProgress |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/LogService |
bmc.kepler.AggregationService.Dump |
Collect、Dump、GetProgress | §4.5 |
| AS-06 | 既有路径 | 固件升级 | /UI/Rest/Chassis/AggregationService/Update/FirmwareInventory/:Id/UI/Rest/Chassis/AggregationService/Update/FirmwareInventory/UpdateProgress/UI/Rest/Chassis/AggregationService/Update/PendingFirmwares/:Id/UI/Rest/Chassis/AggregationService/Update/Actions/Update.StartActive/UI/Rest/Chassis/AggregationService/Update/Actions/Update.Reset/UI/Rest/Chassis/AggregationService/Update/Actions/Update.SwitchImage |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/UpdateService |
bmc.kepler.AggregationService.Update |
StartUpdate、ParallelUpdate、GetUpdateProgress、GetPendingFirmwareList、StartActiveWithPolicy、GetFirmwareInventory、Rollback、Reset | §4.6 |
| AS-07 | 新增路径、新增 WebREST 接口 | 启动项 | /UI/Rest/Chassis/AggregationService/BootOptions |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/SystemService |
bmc.kepler.AggregationService.BootOptions |
GetBootOptions、SetBootOptions | §4.7 |
| AS-08 | 新增路径、新增 WebREST 接口 | BMC网络配置 | /UI/Rest/Chassis/AggregationService/NetworkService |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/NetworkService |
bmc.kepler.AggregationService.Network |
GetIpv4、GetIpv6、SetIpv4、SetIpv6 | §4.8 |
| AS-09 | 新增路径、新增 WebREST 接口 | 电源 | /UI/Rest/Chassis/AggregationService/PowerControl |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/PowerService |
bmc.kepler.AggregationService.PowerControl |
PowerCtrl、GetPowerState | §4.9 |
| AS-10 | 新增路径、新增 WebREST 接口 | 资产/健康 | /UI/Rest/Chassis/AggregationService/AssetInventory/UI/Rest/Chassis/AggregationService/AssetHealthStatus |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/AssetService |
bmc.kepler.AggregationService.AssetInventorybmc.kepler.AggregationService.AssetHealth |
GetAssetInventory GetHealthStatus |
§4.10 |
| AS-11 | 既有路径 | 机框管理 | /UI/Rest/Enclosure/Overview |
/bmc/kepler/AggregationService/Aggregates/${AggregateId}/ChassisService |
bmc.kepler.AggregationService.Chassisbmc.kepler.AggregationService.Backplane |
—（仅属性；已评审） | §4.11 |
| AS-12 | 新增路径 | 单板对象 | —（不提供 WebREST，仅资源树） | /bmc/kepler/AggregationService/Aggregates/AggregateId/IpmbEthBlades/AggregateId/IpmbEthBlades/{IpmbEthBladeId} |
bmc.kepler.AggregationService.IpmbEthBlade |
GetForwardingDetails（属性：Id、Presence、BladeType、HotSwapState） | §4.12 |
4. 详细评审点
4.1 [AS-01] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}
路径描述：汇聚组（框/chassis）根对象。用于标识一个机框聚合管理实例、枚举框内成员板，并作为各聚合功能 Service 路径的父节点。归属聚合管理功能域。部署在管理板，层级为机框，不区分 BMC 本地「系统」或「管理」路径。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | —（不提供 WebREST 集合 URL，仅资源树） |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId} |
WebREST 评审说明
不提供 WebREST 集合 URL。汇聚组仅资源树对象，Web 不单独暴露 Aggregates 集合。
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Aggregate |
实现汇聚组元数据（成员板列表、描述），提供框级聚合根对象 | 不涉及 CSR 配置，无影响 | 不涉及新增主键持久化；成员列表由汇聚层运行时枚举 | 需实现新增属性；首版无方法；不提供 WebREST |
评审状态：待评审
4.2 [AS-02] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/CertificateService
路径描述：框级证书管理挂载点。将既有证书能力挂到汇聚组下，供管理板侧证书相关协作。归属聚合管理-证书功能域。层级为机框、管理板；与 BMC 本地 CertificateService 路径隔离。本次聚合管理功能清单不申报对应 WebREST。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | —（本次不申报 WebREST，仅资源树） |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/CertificateService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
本次聚合管理功能清单不申报对应 WebREST。仅评审资源树路径挂载。
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Certificate |
既有证书接口，挂载于本新增路径，提供证书管理访问能力 | 不涉及 CSR 配置，无影响 | 不涉及本路径新增持久化 | 接口既有，本次仅评审新路径挂载 |
评审状态：待评审
4.3 [AS-03] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/AccountService
路径描述：框级 BMC 账户管理。Web 账户页经本路径转发至指定节点 BMC 账户接口。归属聚合管理-账户功能域。层级为机框、管理板。账户操作为单板（每次一个目标板）。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/AccountService |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/AccountService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
账户为资源 URI，不走 Actions。每次调用仅一个目标板（查询参数或 body 带 board / TargetBoard）。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/AccountService |
GET | 资源 | GetAccounts | 查询指定 BMC 账户列表 |
/UI/Rest/Chassis/AggregationService/AccountService |
POST | 资源 | NewAccount | 新建账户 |
/UI/Rest/Chassis/AggregationService/AccountService |
PATCH | 资源 | ModifyAccount | 修改账户 |
/UI/Rest/Chassis/AggregationService/AccountService |
DELETE | 资源 | DeleteAccount | 删除账户 |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Account |
实现框内指定 BMC 的账户查询与增删改（GetAccounts、NewAccount、ModifyAccount、DeleteAccount），转发至 BMC AccountService | 不涉及 CSR 配置，无影响 | 账户数据持久化在目标 BMC，汇聚层不持久化 | 需实现新增方法；权限与 BMC AccountService 一致 |
评审状态：待评审
4.4 [AS-04] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/ConfigurationService
路径描述：框级配置管理。导入/导出（含进度）与管理板配置文件缓存分属两个接口，挂在同一资源树路径，不新增独立 Path。归属聚合管理-配置功能域。层级为机框、管理板。
| 接口 | 职责 | 方法 | 北向 WebREST |
|---|---|---|---|
bmc.kepler.AggregationService.Configuration |
向各节点 BMC fan-out 配置导入/导出，并查询汇聚任务进度 | Import、Export、GetImportExportProgress | /UI/Rest/Chassis/AggregationService/Configuration/Actions/ImportConfig/UI/Rest/Chassis/AggregationService/Configuration/Actions/ExportConfig/UI/Rest/Chassis/AggregationService/Configuration/ImportExportProgress |
bmc.kepler.AggregationService.ConfigurationFile |
管理板本地导出缓存：按板查询、下载、独立删除（每板仅最新一份） | ListExportFiles、DownloadExportFile、DeleteExportFile | /UI/Rest/Chassis/AggregationService/ConfigurationFiles/ListExportFiles/UI/Rest/Chassis/AggregationService/ConfigurationFiles/DownloadExportFile/UI/Rest/Chassis/AggregationService/ConfigurationFiles/DeleteExportFile |
Export 成功后由汇聚层写入缓存；ConfigurationFile 只操作该缓存，不 fan-out BMC。
WebREST 评审说明
导入/导出为 Action（POST .../Actions/<Name>）。进度、列表、下载、删除为资源 URI，不走 Actions。北向按接口拆分前缀：Configuration / ConfigurationFiles。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/Configuration/Actions/ImportConfig |
POST | Action | Configuration.Import | 配置导入，返回 TaskId |
/UI/Rest/Chassis/AggregationService/Configuration/Actions/ExportConfig |
POST | Action | Configuration.Export | 配置导出，返回 TaskId |
/UI/Rest/Chassis/AggregationService/Configuration/ImportExportProgress |
GET | 资源 | Configuration.GetImportExportProgress | 查询参数 taskId；含 BoardTasks |
/UI/Rest/Chassis/AggregationService/ConfigurationFiles/ListExportFiles |
GET | 资源 | ConfigurationFile.ListExportFiles | 查询已有导出文件的单板 |
/UI/Rest/Chassis/AggregationService/ConfigurationFiles/DownloadExportFile |
GET | 资源 | ConfigurationFile.DownloadExportFile | 下载该板缓存文件 |
/UI/Rest/Chassis/AggregationService/ConfigurationFiles/DeleteExportFile |
DELETE | 资源 | ConfigurationFile.DeleteExportFile | 按板独立删除缓存 |
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | 见上表，按接口拆分 URI 前缀：Configuration / ConfigurationFiles |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/ConfigurationService |
| 层级 | 汇聚组下 2 级 Service |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Configuration |
实现配置导入/导出及进度查询，转发至 BMC Managers.Configurations | 不涉及 CSR 配置，无影响 | 任务状态运行时维护，不涉及本路径新增主键持久化 | 需实现新增方法；与 LogService 路径严格分离 |
bmc.kepler.AggregationService.ConfigurationFile |
实现管理板导出缓存的列表、下载、按板独立删除 | 不涉及 CSR 配置，无影响 | 导出文件在管理板缓存区按板保留最新一份，非接口主键持久化 | 需实现新增方法；不新增 ExportFiles 资源树 Path |
评审状态：待评审
4.5 [AS-05] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/LogService
路径描述：框级日志一键收集。Web 日志导出经本路径 fan-out 至各节点 BMC 日志接口。归属聚合管理-日志功能域。层级为机框、管理板。收集启动为 Action；进度查询为资源 GET，不新增独立资源树 Path，映射 Dump.GetProgress。
WebREST 评审说明
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/LogService/Actions/Dump |
POST | Action | Collect / Dump | 启动收集，返回 TaskId |
/UI/Rest/Chassis/AggregationService/LogService/DumpProgress |
GET | 资源 | GetProgress(TaskId) | 查询参数 taskId；不走 Actions |
进度响应 MUST 含 BoardTasks（boardTasks）。Dump 的每板子项须呈现：
| 展示项 | 字段 | 说明 |
|---|---|---|
| 单板名称 | BoardName | 展示名；TargetBoard 仍为 FRU/Slot ID |
| 收集进度 | Percent、State | Percent 0–100；State 为该板子任务状态 |
| 日志文件名称 | FileName | 该板成功且文件可用后必填；进行中可空。OutputFilePath 供网关下载 |
| 时间 | GeneratedTime | ISO8601。成功时为文件生成时间；进行中可为最近更新时间或省略 |
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/LogService/Actions/Dump（收集 Action）；/UI/Rest/Chassis/AggregationService/LogService/DumpProgress（进度 GET，不走 Actions） |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/LogService |
| 层级 | 汇聚组下 2 级 Service |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Dump |
实现多板日志收集与进度查询（Collect、Dump、GetProgress），转发至 BMC LogServices | 不涉及 CSR 配置，无影响 | 日志包落盘路径由任务结果返回，不涉及接口主键持久化 | 需实现新增方法；Dump 为 WebREST Action 名，Collect 为资源树方法；进度走 DumpProgress；旧称 LogCollectionService 仅作文档别名，不作为本路径 |
评审状态：待评审
4.6 [AS-06] 既有资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/UpdateService
路径描述：框级固件升级。提供框内指定单板（含主备管理板）串行/并行升级、升级进度查询、固件版本查询、待生效查询、一键生效、回滚与复位。归属聚合管理-固件升级功能域。层级为机框、管理板。北向 WebREST 前缀为 Update（不是 UpdateService）。路径、接口与既有 WebREST 已在 支持主备升级新增北向接口评审 申报；本帖新增进度查询 WebREST FirmwareInventory/UpdateProgress。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/Update/FirmwareInventory/:Id/UI/Rest/Chassis/AggregationService/Update/FirmwareInventory/UpdateProgress/UI/Rest/Chassis/AggregationService/Update/PendingFirmwares/:Id/UI/Rest/Chassis/AggregationService/Update/Actions/Update.StartActive/UI/Rest/Chassis/AggregationService/Update/Actions/Update.Reset/UI/Rest/Chassis/AggregationService/Update/Actions/Update.SwitchImage |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/UpdateService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
查询为资源 GET；生效、复位、回滚为 Action（POST .../Actions/Update.<Name>）。:Id 为单板标识（如 HMM1、HMM2）。UpdateProgress 不带单板 Id，一次返回框内所有单板进度。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/Update/FirmwareInventory/:Id |
GET | 资源 | GetFirmwareInventory | 查询指定单板固件版本信息 |
/UI/Rest/Chassis/AggregationService/Update/FirmwareInventory/UpdateProgress |
GET | 资源 | GetUpdateProgress | 查询框内所有单板升级进度，响应为单板进度数组 |
/UI/Rest/Chassis/AggregationService/Update/PendingFirmwares/:Id |
GET | 资源 | GetPendingFirmwareList | 查询指定单板待生效固件 |
/UI/Rest/Chassis/AggregationService/Update/Actions/Update.StartActive |
POST | Action | StartActiveWithPolicy | 一键触发生效，返回任务 URI |
/UI/Rest/Chassis/AggregationService/Update/Actions/Update.Reset |
POST | Action | Reset | 复位指定单板 |
/UI/Rest/Chassis/AggregationService/Update/Actions/Update.SwitchImage |
POST | Action | Rollback | 指定单板固件回滚 |
串行/并行升级（StartUpdate、ParallelUpdate）为资源树方法，WebREST 申报见另帖。
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Update |
框级固件升级：StartUpdate、ParallelUpdate、GetUpdateProgress、GetPendingFirmwareList、StartActiveWithPolicy、GetFirmwareInventory、Rollback、Reset | 不涉及 CSR 配置，无影响 | 不涉及新增主键持久化 | 路径与既有方法另帖评审；本帖新增 UpdateProgress 的 WebREST |
评审状态：路径/接口另帖评审（见 topic/6886）；UpdateProgress WebREST 待评审
4.7 [AS-07] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/SystemService
路径描述：框级启动项管理。Web 启动项页经本路径批量读写各板引导配置。归属聚合管理-系统/启动项功能域。层级为机框、管理板。启动项挂在 SystemService，不单独建 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/BootOptionsService。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/BootOptions |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/SystemService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
启动项为同步资源读写，不走 Actions，不纳入汇聚任务模型。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/BootOptions |
GET | 资源 | GetBootOptions | 批量读各板启动项 |
/UI/Rest/Chassis/AggregationService/BootOptions |
PUT | 资源 | SetBootOptions | 批量设置各板启动项 |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.BootOptions |
实现多板启动项查询与设置（GetBootOptions、SetBootOptions），转发至 BMC Systems.BootOptions | 不涉及 CSR 配置，无影响 | 启动项持久化在目标 BMC，汇聚层不持久化 | 需实现新增方法；同步操作，不纳入汇聚任务模型 |
评审状态：待评审
4.8 [AS-08] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/NetworkService
路径描述：框级 BMC 网络配置。Web 网络页经本路径批量查询、按板设置节点 BMC IPv4/IPv6。归属聚合管理-网络功能域。层级为机框、管理板。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/NetworkService |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/NetworkService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
网络配置为资源 URI，不走 Actions。Get 支持多板；Set 为单板。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/NetworkService |
GET | 资源 | GetIpv4 / GetIpv6 | 批量读 IPv4/IPv6 |
/UI/Rest/Chassis/AggregationService/NetworkService |
PUT | 资源 | SetIpv4 / SetIpv6 | 设置指定单板 IPv4/IPv6 |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Network |
实现框内 BMC IPv4/IPv6 查询与设置（GetIpv4、GetIpv6、SetIpv4、SetIpv6），转发至 BMC EthernetInterfaces | 不涉及 CSR 配置，无影响 | 网络配置持久化在目标 BMC，汇聚层不持久化 | 需实现新增方法 |
评审状态：待评审
4.9 [AS-09] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/PowerService
路径描述：框级电源控制。Web 电源菜单经本路径批量上下电、查询电源状态。归属聚合管理-电源功能域。层级为机框、管理板。电源控制挂在 PowerService，不单独建 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/PowerControlService。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/PowerControl |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/PowerService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
电源为资源 URI，不走 Actions。GET 查询状态，PATCH 下发电源动作。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/PowerControl |
GET | 资源 | GetPowerState | 批量查询 PowerState |
/UI/Rest/Chassis/AggregationService/PowerControl |
PATCH | 资源 | PowerCtrl | 批量电源控制 |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.PowerControl |
实现多板电源控制与电源状态查询（PowerCtrl、GetPowerState），转发至 BMC FruCtrl | 不涉及 CSR 配置，无影响 | 不涉及本路径新增持久化 | 需实现新增方法；不改变 BMC FruCtrl 语义 |
评审状态：待评审
4.10 [AS-10] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/AssetService
路径描述：框级资产清单与健康状态。资产、健康共用同一资源树路径、不同接口；北向 WebREST 按功能拆 URI。归属聚合管理-资产功能域。层级为机框、管理板。机框/背板信息不挂在本路径下，见 AS-11。单板对象见 AS-12。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Chassis/AggregationService/AssetInventory（资产清单）；/UI/Rest/Chassis/AggregationService/AssetHealthStatus（健康状态） |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/AssetService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
资产、健康为资源 GET，不走 Actions。两条北向 URI 映射同一资源树路径上的不同接口。
| 北向 URI | HTTP | 类型 | 映射资源树方法 | 说明 |
|---|---|---|---|---|
/UI/Rest/Chassis/AggregationService/AssetInventory |
GET | 资源 | AssetInventory.GetAssetInventory | 框级资产清单 |
/UI/Rest/Chassis/AggregationService/AssetHealthStatus |
GET | 资源 | AssetHealth.GetHealthStatus | 框级健康状态 |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.AssetInventory |
实现框内资产清单汇聚（GetAssetInventory），转发至 BMC Inventory/FRU 等 | 不涉及 CSR 配置，无影响 | 不涉及本路径新增持久化 | 需实现新增方法 |
bmc.kepler.AggregationService.AssetHealth |
实现框内健康状态汇聚（GetHealthStatus） | 不涉及 CSR 配置，无影响 | 不涉及持久化，无影响 | 需实现新增方法；健康用 Status，不用 State |
评审状态：待评审
4.11 [AS-11] 既有资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/ChassisService
路径描述：机框信息与背板信息管理。Chassis、Backplane 共用同一资源树路径 ChassisService，不挂在 AssetService 下。北向 WebREST 为机框概览。归属机框信息管理功能域。层级为机框、管理板。接口与属性已在 CLI&Rest&IPMI&资源树新增机框信息管理接口及属性 评审通过，本次仅纳入聚合管理路径总表，不重复评审属性。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | /UI/Rest/Enclosure/Overview |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/${AggregateId}/ChassisService |
| 层级 | 汇聚组下 2 级 Service |
WebREST 评审说明
机框概览为资源 GET，不走 Actions。用于前端首页展示系统高速背板类型、电源低速背板类型。
| 北向 URI | HTTP | 类型 | 映射资源树 | 说明 |
|---|---|---|---|---|
/UI/Rest/Enclosure/Overview |
GET | 资源 | Backplane 属性 | Chassis.HighSpeedBackplaneType、PowerBackplaneType（只读） |
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.Chassis |
机框信息（ChassisId、ChassisLocation、ChassisName），支持框内分发 | 不涉及 CSR 配置，无影响 | 不持久化 | 已评审；仅属性，无方法 |
bmc.kepler.AggregationService.Backplane |
背板信息（HighSpeedBackplaneType、PowerBackplaneType），支持框内分发 | 不涉及 CSR 配置，无影响 | 不持久化 | 已评审；仅属性，无方法；与 Chassis 同路径 |
评审状态：已评审（见 topic/6935）
4.12 [AS-12] 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/${AggregateId}/IpmbEthBlades/${IpmbEthBladeId}
路径描述：框内节点单板对象。按板提供在位、刀片类型、热插拔状态及内部通信转发信息。归属聚合管理-单板对象功能域。层级为机框、管理板。相对 ${AggregateId}/<ServiceName> 的 2 级约定，本路径为单板对象例外，独立于 AssetService，不提供 WebREST。
| 项 | 内容 |
|---|---|
| 北向 WebREST 路径 | —（不提供 WebREST，仅资源树） |
| 资源树路径 | /bmc/kepler/AggregationService/Aggregates/AggregateId/IpmbEthBlades/AggregateId/IpmbEthBlades/{IpmbEthBladeId} |
| 层级 | 汇聚组下单板对象（例外） |
WebREST 评审说明
不提供 WebREST。属性查询与 GetForwardingDetails 仅资源树，不对外暴露北向 URI。
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
bmc.kepler.AggregationService.IpmbEthBlade |
实现单板属性 Id、Presence、BladeType、HotSwapState 及方法 GetForwardingDetails（内部通信 IP 与 token） | 不涉及 CSR 配置，无影响 | token 为 ephemeral，禁止作持久属性；不涉及新增主键持久化 | 需实现新增属性与方法；不提供 WebREST |
评审状态：待评审