2.3. build

创建、列出、取消和获取存储库构建的状态/日志。

2.3.1. getRepoBuildStatus

返回构建 uuid 指定的构建状态。

GET /api/v1/repository/{repository}/build/{build_uuid}/status

授权: oauth2_implicit (存储库:read

路径参数
类型Name描述模式

path

build_uuid
required

构建的 UUID

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.3.2. getRepoBuildLogs

返回构建 uuid 指定的构建的构建日志。

GET /api/v1/repository/{repository}/build/{build_uuid}/logs

授权: oauth2_implicit (存储库:read

路径参数
类型Name描述模式

path

build_uuid
required

构建的 UUID

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.3.3. getRepoBuild

返回有关构建的信息。

GET /api/v1/repository/{repository}/build/{build_uuid}

授权: oauth2_implicit (存储库:read

路径参数
类型Name描述模式

path

build_uuid
required

构建的 UUID

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.3.4. cancelRepoBuild

取消存储库构建。

DELETE /api/v1/repository/{repository}/build/{build_uuid}

授权: oauth2_implicit (repo:admin)

路径参数
类型Name描述模式

path

build_uuid
required

构建的 UUID

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

响应
HTTP 代码描述模式

204

已删除

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.3.5. requestRepoBuild

请求构建存储库并从指定的输入推送。

POST /api/v1/repository/{repository}/build/

授权: oauth2_implicit (存储库:write

路径参数
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

请求正文模式(application/json)

新存储库构建的描述。

名称描述模式

file_id
optional

构建 spec 被上传时生成的文件 id

字符串

archive_url
optional

要构建的 .tar.gz 的 URL。必须使用 "http" 或 "https" 启动。

字符串

子目录
可选

可以在其中找到 Dockerfile 的子目录。您只能指定这个或 dockerfile_path

字符串

dockerfile_path
optional

dockerfile 的路径。您只能指定此或子目录。

字符串

上下文
可选

传递 dockerfile 的上下文。这是可选的。

字符串

pull_robot
optional

用作拉取凭证的 Quay 机器人帐户的用户名

字符串

docker_tags
optional

将推送到构建的镜像的标签。如果未指定,则使用"latest"。

字符串数组
非空 的唯一

响应
HTTP 代码描述模式

201

成功创建

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.3.6. getRepoBuilds

获取存储库构建列表。

GET /api/v1/repository/{repository}/build/

授权: oauth2_implicit (存储库:read

路径参数
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

查询参数
类型Name描述模式

query

因为
可选

返回自给定的 unix 时间码后的所有构建

整数

query

limit
optional

要返回的最大构建数

整数

响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError