Method: projects.histories.list

列出给定项目的历史记录。

这些历史记录按修改时间降序排序。historyId 键将用于对具有相同修改时间的历史记录进行排序。

系统可能会返回以下任一规范错误代码：

  • PERMISSION_DENIED - 如果用户无权读取项目
  • INVALID_ARGUMENT - 如果请求格式错误
  • NOT_FOUND - 如果历史记录不存在

HTTP 请求

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

网址采用 gRPC 转码语法。

路径参数

参数
projectId

string

项目 ID。

必填。

查询参数

参数
pageToken

string

用于在下一项中继续查询的延续令牌。

可选。
pageSize

integer

要获取的历史记录数量上限。

默认值：20。如果此字段未设置或值为 0，服务器将使用此默认值。任何大于 100 的值将被视为 100。

可选。
filterByName

string

如果设置，则仅返回具有给定名称的历史记录。

可选。

请求正文

请求正文必须为空。

响应正文

HistoryService.List 的响应消息

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
字段
histories[]

object (History)

历史记录。
nextPageToken

string

用于在下一项中继续查询的延续令牌。

仅当有更多历史记录可供提取时才会设置。

令牌在第一个列表请求后的一小时内有效。例如，如果您在下午 1 点发出列表请求，并在 10 分钟后使用第一个请求中的令牌，则第二个响应中的令牌仅在 50 分钟内有效。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅身份验证概览。