用途:本技能用于手动触发扫描器执行,从配置好的外部平台发现服务,并查看扫描结果,包括所有已发现服务。适合需要手动运行扫描或审查发现内容的场景。
前置条件:需要已存在的扫描器配置、未过期的有效连接凭证、有效的授权令牌,以及所在组织的扫描执行权限。
主要步骤:
- 执行扫描器:调用 executeWorkflowFromConfiguration,传入 organizationId 和 scannerConfigurationId。扫描异步启动,返回 202 Accepted;若 409 表示该配置已有扫描在运行,404 表示配置不存在,503 表示服务暂不可用。
- 获取运行历史:调用 getScannerRunHistory,传入 organizationId、scannerId,以及 page(从 0 开始)和 size 分页参数,可读取 scanRunId、scanStatus(RUNNING、COMPLETED、FAILED、ABORTED)、startedAt、endedAt。
- 查看已发现服务:扫描完成后调用 getStagingAssetsByScanRunId,传入 scannerId 和 scanRunId,page 为 0、size 为 0 可获取全部结果,返回 assetId、name、stagingStatus(NEW、EXISTING、PUBLISHED、FAILED等)、operationPerformed(CREATE、UPDATE、DELETE、SKIP)。
适用场景:需要手动触发扫描、监控扫描状态、审查待发布到 Exchange 的服务。建议长时间扫描时每 30–60 秒轮询一次状态。
限制与注意:扫描为异步执行;状态可能长时间处于 RUNNING;无结果可能源于源平台无服务、凭证缺少读权限或过滤条件;失败时可检查配置的 lastRunStatusDetail 并测试连接。以上为实现要点,具体界面与权限细节暂未提供。