ListCheckRuns - 查询运行检查列表_云效(Apsara Devops)-阿里云帮助中心

通过OpenAPI分页查询指定某个ref的所有check run。

适用版本

企业标准版

服务接入点与授权信息

获取服务接入点，替换 API 请求语法中的 <domain> ：服务接入点（domain）。
获取个人访问令牌，具体操作，请参见获取个人访问令牌。

产品	资源	所需权限
代码管理	运行检查	只读

请求语法

GET https://{domain}/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/checkRuns

请求头

参数	类型	是否必填	描述	示例值
x-yunxiao-token	string	是	个人访问令牌。	pt-0fh3**0fbG_35af**0484

请求参数

参数	类型	位置	是否必填	描述	示例值
organizationId	string	path	是	组织 ID。	5ebbc0228123212b59xxxxx
repositoryId	string	path	是	代码库 ID 或者 URL-Encoder 编码的全路径。	2835387
ref	string	query	是	提交 ID、分支名称或者标签名称。	40f4ccfe019cdd4a62d4acb0c57130106fc7e1be
page	integer	query	否	页码，默认从1开始，一般不要超过150页。	1
perPage	integer	query	否	每页大小，默认20，取值范围【1，100】。	20

请求示例

curl -X 'GET' \
  'https://test.rdc.aliyuncs.com/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/checkRuns?ref=<ref>&page=<page>&perPage=<perPage>' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

返回参数

参数	类型	描述	示例值
-	array
-	object
annotations	array	注解信息。
-	object
annotationLevel	string	检查注解的等级：notice - 轻微；warning - 警告；failure - 严重。	warning
createdAt	string	创建时间。	2022-01-14T21:08:26+08:00
endColumn	integer	结束列，当且仅当 startLine=endLine 时，该字段值有效。	4
endLine	integer	结束行。	2
id	integer	检查注解 ID，唯一标识。	1
message	string	摘要信息。	""
path	string	文件路径。	demo/test.txt
rawDetails	string	详情信息，限制64KB 以内。	""
startColumn	integer	起始列，当且仅当 startLine=endLine 时，该字段值有效。	3
startLine	integer	起始行，需要用户自行确认文件行数的有效性，否则无法展示，其余类似。	1
title	string	检查注解的标题。	""
updatedAt	string	更新时间。	2022-01-14T21:08:26+08:00
checkSuite	object	检查套件信息。
id	integer	唯一标识。	1
completedAt	string	三方检查的完成时间。	2023-03-15T08:00:00Z
conclusion	string	结论：cancelled - 已取消；failure - 失败；neutral - 中立状态，算作成功状态；success - 成功；skipped - 跳过，算作成功状态；timed_out - 超时。	success
createdAt	string	回写记录的创建时间。	2023-03-15T08:00:00Z
detailsUrl	string	三方交互系统的链接地址，由用户自行决定，平台仅提供跳转能力。	xxx
externalId	string	外部系统 ID。	42
headSha	string	提交 ID。	40f4ccfe019cdd4a62d4acb0c57130106fc7e1be
id	integer	唯一标识。	5240
name	string	check run 的名称。	my-check-ci
output	object	页面展示信息。
images	array	可展示的图片，不超过3张。
-	object
alt	string	alt 文本信息。	test-image-alt
caption	string	图片信息的简要描述。	test
imageUrl	string	图片地址，须确保能够有效访问，否则页面无法加载。	xxx
summary	string	摘要信息，支持 MarkDown 格式，最大字符长度为64KB，即65535个字符。	""
text	string	详情信息，支持 MarkDown 格式，最大字符长度为64KB，即65535个字符。	""
title	string	标题。	Mighty Readme report
startedAt	string	三方检查的开始时间。	2023-03-15T08:00:00Z
status	string	状态：queued - 队列中；in_progress - 运行中；completed - 完成。	completed
updatedAt	string	回写记录的更新时间。	2022-01-14T21:08:26+08:00
writer	object	写入人信息。	""
id	string	用户 ID。	xxx
logoUrl	string	用户头像地址。	xxx
name	string	用户名称。	test-codeup
slug	string	用户登录名。	test-codeup
type	string	写入人类型：User - 用户；Bot - 应用（暂无）。	User

返回示例

[
   {
      "annotations": [
          {
              "annotationLevel": "notice",
              "createdAt": "2022-01-14T21:08:26+08:00",
              "endColumn": 5,
              "endLine": 2,
              "id": 524836,
              "message": "",
              "path": "demo/test.txt",
              "rawDetails": "",
              "startColumn": 3,
              "startLine": 1,
              "title": "",
              "updatedAt": "2022-01-14T21:08:26+08:00"
          }
      ],
      "checkSuite": {
          "id": 1
      },
      "completedAt": "2023-03-15T08:00:00Z",
      "conclusion": "success",
      "createdAt": "2022-01-14T21:08:26+08:00",
      "detailsUrl": "xxx",
      "externalId": "42",
      "headSha": "40f4ccfe019cdd4a62d4acb0c57130106fc7e1be",
      "id": 524836,
      "name": "my-check-ci",
      "output": {
          "images": [
              {
                  "alt": "test-image-alt",
                  "caption": "test",
                  "imageUrl": "xxx"
              }
          ],
          "summary": "",
          "text": "",
          "title": "Mighty Readme report"
      },
      "startedAt": "2023-03-15T08:00:00Z",
      "status": "completed",
      "updatedAt": "2022-01-14T21:08:26+08:00",
      "writer": {
          "id": "xxx",
          "logoUrl": "xxx",
          "name": "test-codeup",
          "slug": "test-codeup",
          "type": "User"
      }
   }
]

响应头

参数	描述	示例值
x-next-page	下一页。	2
x-page	当前页。	1
x-per-page	每页大小。	20
x-prev-page	前一页。	0
x-request-id	请求 ID。	37294673-00CA-5B8B-914F-A8B35511E90A
x-total	总数。	10
x-total-pages	总分页数。	1

错误码

访问错误码中心查看 API 相关错误码。