7.24. 触发器

7.24.1. activateBuildTrigger
复制链接

激活指定的构建触发器。

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/activate

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	trigger_uuid required	构建触发器的 UUID	字符串
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

请求正文模式(application/json)

Expand

名称	描述	模式
需要配置	任意 json。	对象
pull_robot optional	用于拉取镜像的机器人名称。	字符串

响应

Expand

HTTP 代码	描述	模式
201	成功创建
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/activate" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{

$ curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/activate" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "branch": "main"
    },
    "pull_robot": "example+robot"
  }'

Copy to Clipboard

Toggle word wrap

7.24.2. listTriggerRecentBuilds
复制链接

列出指定触发器启动的构建。

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}/builds

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	trigger_uuid required	构建触发器的 UUID	字符串
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

查询参数

Expand

类型	Name	描述	模式
query	限制可选	要返回的最大构建数	整数

响应

Expand

HTTP 代码	描述	模式
200	成功调用
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/builds?limit=10" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/builds?limit=10" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.3. manuallyStartBuildTrigger
复制链接

从指定的触发器手动启动构建。

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/start

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	trigger_uuid required	构建触发器的 UUID	字符串
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

请求正文模式(application/json)

用于激活构建触发器的可选运行参数

Expand

名称	描述	模式
branch_name 可选	（仅SCM）如果指定，则构建的分支名称。	字符串
commit_sha optional	（仅限客户）如果指定，用于签出 git 存储库的 ref/SHA1。	字符串
refs 可选	（仅SCM）如果指定，则要构建的 ref。

响应

Expand

HTTP 代码	描述	模式
201	成功创建
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/start" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{

$ curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/start" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "branch_name": "main",
    "commit_sha": "abcdef1234567890",
    "refs": "refs/heads/main"
  }'

Copy to Clipboard

Toggle word wrap

7.24.4. getBuildTrigger
复制链接

获取指定构建触发器的信息。

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	trigger_uuid required	构建触发器的 UUID	字符串
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

响应

Expand

HTTP 代码	描述	模式
200	成功调用
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.5. updateBuildTrigger
复制链接

更新指定的构建触发器。

PUT /api/v1/repository/{repository}/trigger/{trigger_uuid}

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	trigger_uuid required	构建触发器的 UUID	字符串
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

请求正文模式(application/json)

更新构建触发器的选项

Expand

名称	描述	模式
需要启用	是否启用构建触发器	布尔值

响应

Expand

HTTP 代码	描述	模式
200	成功调用
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X PUT "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

$ curl -X PUT "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

Copy to Clipboard

Toggle word wrap

7.24.6. deleteBuildTrigger
复制链接

删除指定的构建触发器。

DELETE /api/v1/repository/{repository}/trigger/{trigger_uuid}

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	trigger_uuid required	构建触发器的 UUID	字符串
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

响应

Expand

HTTP 代码	描述	模式
204	已删除
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X DELETE "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X DELETE "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.7. listBuildTriggers
复制链接

列出指定存储库的触发器。

GET /api/v1/repository/{repository}/trigger/

授权： oauth2_implicit (repo:admin)

路径参数

Expand

类型	Name	描述	模式
path	需要仓库	存储库的完整路径。例如 namespace/name	字符串

响应

Expand

HTTP 代码	描述	模式
200	成功调用
400	错误请求	ApiError
401	需要会话	ApiError
403	未授权访问	ApiError
404	未找到	ApiError

示例命令

curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.1. activateBuildTrigger复制链接链接已复制到粘贴板!

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/activate

路径参数

请求正文模式(application/json)

响应

示例命令

7.24.2. listTriggerRecentBuilds复制链接链接已复制到粘贴板!

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}/builds

路径参数

查询参数

响应

示例命令

7.24.3. manuallyStartBuildTrigger复制链接链接已复制到粘贴板!

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/start

路径参数

请求正文模式(application/json)

响应

示例命令

7.24.4. getBuildTrigger复制链接链接已复制到粘贴板!

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}

路径参数

响应

示例命令

7.24.5. updateBuildTrigger复制链接链接已复制到粘贴板!

PUT /api/v1/repository/{repository}/trigger/{trigger_uuid}

路径参数

请求正文模式(application/json)

响应

示例命令

7.24.6. deleteBuildTrigger复制链接链接已复制到粘贴板!

DELETE /api/v1/repository/{repository}/trigger/{trigger_uuid}

路径参数

响应

示例命令

7.24.7. listBuildTriggers复制链接链接已复制到粘贴板!

GET /api/v1/repository/{repository}/trigger/

路径参数

响应

示例命令

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.24.1. activateBuildTrigger
复制链接

7.24.2. listTriggerRecentBuilds
复制链接

7.24.3. manuallyStartBuildTrigger
复制链接

7.24.4. getBuildTrigger
复制链接

7.24.5. updateBuildTrigger
复制链接

7.24.6. deleteBuildTrigger
复制链接

7.24.7. listBuildTriggers
复制链接