2.15. repositorynotification
列出、创建和管理存储库事件/通知。
2.15.1. testRepoNotification
为这个存储库队列测试通知。
POST /api/v1/repository/{repository}/notification/{uuid}/test
Authorizations: oauth2_implicit(repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
UUID | 通知的 UUID | 字符串 |
path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
201 | 成功创建 | |
400 | 错误请求 | |
401 | 必需的会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.15.2. getRepoNotification
获取指定通知的信息。
GET /api/v1/repository/{repository}/notification/{uuid}
Authorizations: oauth2_implicit(repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
UUID | 通知的 UUID | 字符串 |
path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 必需的会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.15.3. deleteRepoNotification
删除指定的通知。
DELETE /api/v1/repository/{repository}/notification/{uuid}
Authorizations: oauth2_implicit(repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
UUID | 通知的 UUID | 字符串 |
path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 必需的会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.15.4. resetRepositoryNotificationFailures
将存储库通知重置为 0 个失败。
POST /api/v1/repository/{repository}/notification/{uuid}
Authorizations: oauth2_implicit(repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
UUID | 通知的 UUID | 字符串 |
path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
201 | 成功创建 | |
400 | 错误请求 | |
401 | 必需的会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.15.5. listRepoNotifications
列出指定存储库的通知。
GET /api/v1/repository/{repository}/notification/
Authorizations: oauth2_implicit(repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 必需的会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.15.6. createRepoNotification
POST /api/v1/repository/{repository}/notification/
Authorizations: oauth2_implicit(repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
请求正文模式(application/json)
在存储库中创建通知的信息
名称 | 描述 | 模式 |
---|---|---|
event | 通知将响应的事件 | 字符串 |
method | 通知方法(如电子邮件或 Web 回调) | 字符串 |
config | 通知方法的 JSON 配置信息 | 对象 |
eventConfig | 通知特定事件的 JSON 配置信息 | 对象 |
title | 通知的人类可读标题 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
201 | 成功创建 | |
400 | 错误请求 | |
401 | 必需的会话 | |
403 | 未授权访问 | |
404 | 未找到 |