• 获取作业产物
• 下载产物归档文件
• 按作业 ID 下载单个产物文件
• 从特定标签或分支下载单个产物文件
• 保留产物
• 删除作业产物
• 删除项目产物

作业产物 API

获取作业产物

在极狐GitLab 专业版 9.5 中引入 CI_JOB_TOKEN 在产物下载 API 中的使用。

获取项目的作业产物的压缩存档文件。

GET /projects/:id/jobs/:job_id/artifacts

使用带有 PRIVATE-TOKEN 的标头请求示例：

curl --location --output artifacts.zip --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/42/artifacts"

在 .gitlab-ci.yml 里面使用 script 定义，您可以使用：

• 带有极狐GitLab 提供的 CI_JOB_TOKEN 变量的 JOB-TOKEN 标头。 示例，以下作业下载 ID 为 42 的作业的产物。该命令用单引号括起来，因为它包含一个冒号 (:)：

  artifact_download:
    stage: test
    script:
      - 'curl --location --output artifacts.zip --header "JOB-TOKEN: $CI_JOB_TOKEN" "https://gitlab.example.com/api/v4/projects/1/jobs/42/artifacts"'
  

• 或者带有极狐GitLab 提供的 CI_JOB_TOKEN 变量的 job_token 属性。 示例，以下作业下载 ID 为 42 的作业的产物。

  artifact_download:
    stage: test
    script:
      - 'curl --location --output artifacts.zip "https://gitlab.example.com/api/v4/projects/1/jobs/42/artifacts?job_token=$CI_JOB_TOKEN"'
  

可能的响应状态代码：

下载产物归档文件

在极狐GitLab 专业版 9.5 中引入 CI_JOB_TOKEN 在产物下载 API 中的使用。

从给定参考名称和作业的最新成功流水线下载产物归档文件，前提是作业成功完成。这与获取作业的产物相同，但通过定义作业的名称而不是其 ID。

GET /projects/:id/jobs/artifacts/:ref_name/download?job=name

参数：

使用 PRIVATE-TOKEN 标头的请求示例：

curl --location --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/artifacts/main/download?job=test"

在 .gitlab-ci.yml 里面使用 script 定义，您可以使用：

• 带有极狐GitLab 提供的 CI_JOB_TOKEN 变量的 JOB-TOKEN 标头。 示例，以下 test 作业下载的是 main 分支的产物。该命令用单引号括起来，因为它包含一个冒号 (:)：

  artifact_download:
    stage: test
    script:
      - 'curl --location --output artifacts.zip --header "JOB-TOKEN: $CI_JOB_TOKEN" "https://gitlab.example.com/api/v4/projects/$CI_PROJECT_ID/jobs/artifacts/main/download?job=test"'
  

• 或者带有极狐GitLab 提供的 CI_JOB_TOKEN 变量的 job_token 属性。 示例，以下 test 作业下载的是 main 分支的产物。

  artifact_download:
    stage: test
    script:
      - 'curl --location --output artifacts.zip "https://gitlab.example.com/api/v4/projects/$CI_PROJECT_ID/jobs/artifacts/main/download?job=test&job_token=$CI_JOB_TOKEN"'
  

可能的响应状态代码：

按作业 ID 下载单个产物文件

• 引入于 13.10 版本。
• 在极狐GitLab 专业版 13.10 中引入 CI_JOB_TOKEN 在产物下载 API 中的使用。

从作业的产物压缩存档中下载具有指定 ID 的作业的单个产物文件。该文件从存档中提取并流式传输到客户端。

GET /projects/:id/jobs/:job_id/artifacts/*artifact_path

参数：

请求示例:

curl --location --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/5/artifacts/some/release/file.pdf"

可能的响应状态代码：

从特定标签或分支下载单个产物文件

• 引入于 13.10 版本。
• 在极狐GitLab 专业版 13.10 中引入 CI_JOB_TOKEN 在产物下载 API 中的使用。

从作业的产物存档中为给定参考名称的最新成功流水线的特定作业中下载单个产物文件。该文件从存档中提取并流式传输到客户端。

产物文件提供了比 CSV 导出中可用的更多的详细信息。

在 13.5 及更高版本中，父级流水线和子流水线的产物按从父到子的层次顺序进行搜索。例如，如果父级流水线和子流水线都有同名的作业，则返回父级流水线中的产物。

GET /projects/:id/jobs/artifacts/:ref_name/raw/*artifact_path?job=name

参数：

请求示例：

curl --location --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/artifacts/main/raw/some/release/file.pdf?job=pdf"

可能的响应状态代码：

保留产物

防止产物被过期设置删除。

POST /projects/:id/jobs/:job_id/artifacts/keep

参数：

请求示例:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/1/artifacts/keep"

响应示例:

{
  "commit": {
    "author_email": "admin@example.com",
    "author_name": "Administrator",
    "created_at": "2015-12-24T16:51:14.000+01:00",
    "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
    "message": "Test the CI integration.",
    "short_id": "0ff3ae19",
    "title": "Test the CI integration."
  },
  "coverage": null,
  "allow_failure": false,
  "download_url": null,
  "id": 42,
  "name": "rubocop",
  "ref": "main",
  "artifacts": [],
  "runner": null,
  "stage": "test",
  "created_at": "2016-01-11T10:13:33.506Z",
  "started_at": "2016-01-11T10:13:33.506Z",
  "finished_at": "2016-01-11T10:15:10.506Z",
  "duration": 97.0,
  "status": "failed",
  "failure_reason": "script_failure",
  "tag": false,
  "web_url": "https://example.com/foo/bar/-/jobs/42",
  "user": null
}

删除作业产物

引入于极狐GitLab 13.10。

删除作业产物。

先决条件：

• 至少具有项目的维护者角色。

DELETE /projects/:id/jobs/:job_id/artifacts

请求示例:

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/1/artifacts"

如果产物被成功删除，则返回带有 204 No Content 状态的响应代码。

删除项目产物

• 在极狐GitLab 14.7 中引入，带有一个名为 bulk_expire_project_artifacts 的标志。在私有化部署版和 Jihulab.com 上默认启用。
• 在极狐GitLab 14.10 中删除了功能标志。

删除可以删除的项目的产物。

默认情况下，来自每个 ref 的最近成功流水线的产物被保留。

DELETE /projects/:id/artifacts

请求示例:

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/artifacts"

安排 worker 将所有可以删除的产物的到期时间更新到当前时间。返回带有状态 202 Accepted 的响应代码。