如何确定Xray REST API Artifact Summary调用的paths参数格式？

核心结论 #

通过SHA256校验和可正常查询，但使用Artifactory UI显示路径报错，本质是路径参数格式未匹配Xray的索引规则，以下是两种正确的参数格式：

格式1：完整路径（含仓库名） #

将UI中显示的完整路径直接放入paths数组，注意开头不要加斜杠：

{
  "paths": ["REPO_NAME/os/ubuntu20/ubuntu20/20.04.5/manifest.json"]
}

格式2：拆分仓库与相对路径 #

单独指定repo参数，paths仅传入仓库内的相对路径：

{
  "repo": "REPO_NAME",
  "paths": ["os/ubuntu20/ubuntu20/20.04.5/manifest.json"]
}

关键排查点 #

• 严格匹配路径大小写：Artifactory和Xray默认对路径大小写敏感，需与UI显示完全一致
• 确认工件已被索引：新上传的工件需等待Xray完成索引任务，未索引的工件无法通过路径查询
• 保证参数格式正确：paths必须是数组类型，单个路径也要用["路径内容"]包裹，不能直接传字符串

内容的提问来源于stack exchange，提问作者renderitchaos