用途:通过 REST API 管理 SAP Automation Pilot 中的命令执行,覆盖触发、监控、控制与排障。
前置条件:需设置环境变量 AUTOPI_HOSTNAME、AUTOPI_USERNAME、AUTOPI_PASSWORD、AUTOPI_DEFAULT_CATALOG,并确保环境中有 curl。
执行状态:RUNNING、PAUSED、INPUT_REQUIRED、FAILED 为活动状态;FINISHED、ABORTED、SUSPENDED 为终态。终态执行可重新触发或删除。
主要操作:所有操作走 POST /api/v1/executions/{id}/actions,包括 PAUSE、RESUME、RETRY、RESET、ABORT、COMMENT。操作需匹配当前状态,否则返回 HTTP 409。COMMENT 每次执行最多 10 条。
触发执行:POST /api/v1/executions,传 commandId、inputValues 和 tags。inputValues 所有值在传输时须为字符串。加 "feature:dryRun": "" 可空跑;加 "feature:logs": "" 才能事后取日志,该标签不可追溯添加。
监控与日志:可列出执行(支持 status、commandId、startedAfter 等过滤,limit 1-1000)、获取详情、摘要、输入输出(输出仅 FINISHED 可用)、分页日志及指定执行器日志。
事件触发:支持 /api/v1/triggers/generic-event 与 /api/v1/triggers/ans-event。
权限:读取需 Read,删除需 Write,触发与操作需 Execute。
限制:仅已完成执行可删除;RESET 不适用于直接执行提供的命令;日志需触发时开启标签。常见错误码含 401、403、404、409、413、429。