列出给定项目的历史记录。
历史记录按修改时间降序排列。 HistoryId 键将用于对具有相同修改时间的历史进行排序。
可能返回以下任何规范错误代码:
- PERMISSION_DENIED - 如果用户无权读取项目
- INVALID_ARGUMENT - 如果请求格式错误
- NOT_FOUND - 如果历史记录不存在
HTTP请求
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
URL 使用gRPC 转码语法。
路径参数
参数 | |
---|---|
projectId | 项目 ID。 必需的。 |
查询参数
参数 | |
---|---|
pageToken | 用于在下一项处恢复查询的继续标记。 选修的。 |
pageSize | 要获取的最大历史记录数。 默认值:20。如果该字段未设置或值为 0,服务器将使用此默认值。任何大于 100 的值都将被视为 100。 选修的。 |
filterByName | 如果设置,则仅返回具有给定名称的历史记录。 选修的。 |
请求正文
请求正文必须为空。
响应体
HistoryService.List 的响应消息
如果成功,响应正文包含具有以下结构的数据:
JSON 表示 |
---|
{
"histories": [
{
object ( |
领域 | |
---|---|
histories[] | 历史。 |
nextPageToken | 用于在下一项处恢复查询的继续标记。 仅当有更多历史记录需要获取时才会设置。 令牌的有效期从第一次列表请求时起最多一小时。例如,如果您在下午 1 点发出列表请求,并在 10 分钟后使用第一个请求中的令牌,则第二个响应中的令牌仅在 50 分钟内有效。 |
授权范围
需要以下 OAuth 范围:
-
https://www.googleapis.com/auth/cloud-platform
有关详细信息,请参阅身份验证概述。