Method: projects.histories.list

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

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

可能返回以下任何规范错误代码：

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

HTTP请求

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

URL 使用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

有关详细信息，请参阅身份验证概述。