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

有關詳細信息，請參閱身份驗證概述。