2.7. logs
访问机构或存储库的使用情况日志。
2.7.1. getAggregateUserLogs
返回当前用户的聚合日志。
GET /api/v1/user/aggregatelogs
授权: oauth2_implicit (user:admin)
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
执行 | 过滤日志的用户名。 | 字符串 |
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X GET \ -H "Authorization: Bearer <bearer_token>" \ -H "Accept: application/json" \ "<quay-server.example.com>/api/v1/user/aggregatelogs?performer=<username>&starttime=<MM/DD/YYYY>&endtime=<MM/DD/YYYY>"
2.7.2. exportUserLogs
返回当前用户的聚合日志。
POST /api/v1/user/exportlogs
授权: oauth2_implicit (user:admin)
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
请求正文模式(application/json)
配置导出日志操作
名称 | 描述 | 模式 |
---|---|---|
callback_url | 使用到导出日志的链接调用的回调 URL | 字符串 |
callback_email | 通过电子邮件发送到导出日志的链接的电子邮件地址 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
201 | 成功创建 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X POST \ -H "Authorization: Bearer <bearer_token>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "starttime": "<MM/DD/YYYY>", "endtime": "<MM/DD/YYYY>", "callback_email": "your.email@example.com" }' \ "http://<quay-server.example.com>/api/v1/user/exportlogs"
2.7.3. listUserLogs
列出当前用户的日志。
GET /api/v1/user/logs
授权: oauth2_implicit (user:admin)
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
next_page | 下一页面的页面令牌 | 字符串 |
query |
执行 | 过滤日志的用户名。 | 字符串 |
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X GET -H "Authorization: Bearer <bearer_token>" -H "Accept: application/json" "<quay-server.example.com>/api/v1/user/logs"
2.7.4. getAggregateOrgLogs
获取指定机构的聚合日志。
GET /api/v1/organization/{orgname}/aggregatelogs
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要OrgName | 机构名称 | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
执行 | 过滤日志的用户名。 | 字符串 |
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X GET \ -H "Authorization: Bearer <bearer_token>" \ -H "Accept: application/json" \ "<quay-server.example.com>/api/v1/organization/{orgname}/aggregatelogs"
2.7.5. exportOrgLogs
导出指定机构的日志。
POST /api/v1/organization/{orgname}/exportlogs
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要OrgName | 机构名称 | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
请求正文模式(application/json)
配置导出日志操作
名称 | 描述 | 模式 |
---|---|---|
callback_url | 使用到导出日志的链接调用的回调 URL | 字符串 |
callback_email | 通过电子邮件发送到导出日志的链接的电子邮件地址 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
201 | 成功创建 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X POST \ -H "Authorization: Bearer <bearer_token>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "starttime": "<MM/DD/YYYY>", "endtime": "<MM/DD/YYYY>", "callback_email": "org.logs@example.com" }' \ "http://<quay-server.example.com>/api/v1/organization/{orgname}/exportlogs"
2.7.6. listOrgLogs
列出指定机构的日志。
GET /api/v1/organization/{orgname}/logs
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要OrgName | 机构名称 | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
next_page | 下一页面的页面令牌 | 字符串 |
query |
执行 | 过滤日志的用户名。 | 字符串 |
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X GET \ -H "Authorization: Bearer <bearer_token>" \ -H "Accept: application/json" \ "http://<quay-server.example.com>/api/v1/organization/{orgname}/logs"
2.7.7. getAggregateRepoLogs
返回指定存储库的聚合日志。
GET /api/v1/repository/{repository}/aggregatelogs
授权: oauth2_implicit (repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X GET \ -H "Authorization: Bearer <bearer_token>" \ -H "Accept: application/json" \ "<quay-server.example.com>/api/v1/repository/<repository_name>/<namespace>/aggregatelogs?starttime=2024-01-01&endtime=2024-06-18""
2.7.8. exportRepoLogs
对指定存储库的日志导出排队。
POST /api/v1/repository/{repository}/exportlogs
授权: oauth2_implicit (repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
请求正文模式(application/json)
配置导出日志操作
名称 | 描述 | 模式 |
---|---|---|
callback_url | 使用到导出日志的链接调用的回调 URL | 字符串 |
callback_email | 通过电子邮件发送到导出日志的链接的电子邮件地址 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
201 | 成功创建 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X POST \ -H "Authorization: Bearer <bearer_token>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "starttime": "2024-01-01", "endtime": "2024-06-18", "callback_url": "http://your-callback-url.example.com" }' \ "http://<quay-server.example.com>/api/v1/repository/{repository}/exportlogs"
2.7.9. listRepoLogs
列出指定存储库的日志。
GET /api/v1/repository/{repository}/logs
授权: oauth2_implicit (repo:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
next_page | 下一页面的页面令牌 | 字符串 |
query |
ENDTIME | 日志的最新时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
query |
startTime | 日志的最早时间。格式: UTC 为 "%m/%d/%Y"。 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
示例命令
$ curl -X GET \ -H "Authorization: Bearer <bearer_token>" \ -H "Accept: application/json" \ "http://<quay-server.example.com>/api/v1/repository/{repository}/logs"