文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 下载 agent 的地址 - AgentDownloadURL
更新时间:2026-09-18 GMT+08:00

下载 agent 的地址 - AgentDownloadURL

功能介绍

下载 agent 的地址

调用方法

请参见如何调用API。

URI

GET /v5/{project_id}/pipelines/{pipeline_id}/{pipeline_run_id}/{job_run_id}/agent-runs/agent/download

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方式请参见获取项目ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

pipeline_id

是

String

参数解释:

流水线ID,可以通过查询流水线列表接口获取,其中pipelines.pipelineId即为流水线ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

pipeline_run_id

是

String

参数解释:

流水线运行实例ID,启动流水线接口的返回值即为流水线运行实例ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

job_run_id

是

String

参数解释:

job运行id。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

arch

是

String

参数解释:

执行机cpu架构。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

version

是

String

参数解释:

agent版本。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

参数解释:

错误信息,接口正常无报错时不返回error字段。

取值范围:

不涉及。

result

Object

参数解释:

返回结果。

取值范围:

不涉及。

status

String

参数解释:

状态值。

取值范围:

不涉及。

表4 ErrorInfo

参数

参数类型

描述

code

String

参数解释:

错误码。

取值范围:

不涉及。

message

String

参数解释:

错误信息。

取值范围:

不涉及。

请求示例

无

响应示例

状态码:200

{
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。