Method: projects.histories.executions.steps.thumbnails.list

列出附加到步驟的圖像的縮圖。

可能會傳回以下任何規範錯誤代碼： - PERMISSION_DENIED - 如果使用者無權從專案或任何映像讀取 - INVALID_ARGUMENT - 如果要求格式錯誤 - NOT_FOUND - 如果步驟不存在，或者如果任何映像不存在

HTTP請求

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails

URL 使用gRPC 轉碼語法。

路徑參數

參數
projectId

string

項目 ID。

必需的。

historyId

string

歷史記錄 ID。

必需的。

executionId

string

執行 ID。

必需的。

stepId

string

步驟 ID。

必需的。

查詢參數

參數
pageToken

string

用於在下一項處恢復查詢的繼續標記。

選修的。

pageSize

integer

要取得的最大縮圖數。

預設值：50。如果該欄位未設定或值為 0，伺服器將使用此預設值。

選修的。

請求正文

請求內文必須為空。

響應體

包含步驟中縮圖的回應。

如果成功，回應正文包含具有以下結構的資料：

JSON 表示
{
  "thumbnails": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
領域
thumbnails[]

object ( Image )

圖像資料列表。

影像按確定的順序返回；它們按這些因素按重要性排序： * 首先，按相關的測試案例。沒有測試案例的圖像被認為比有測試案例的圖像更大。 * 其次，依建立時間。沒有創建時間的圖像比有創建時間的圖像更重要。 * 第三，按它們加入步驟的順序（透過呼叫steps.create或steps.patch）。

nextPageToken

string

用於在下一項處恢復查詢的繼續標記。

如果設置，則表示有更多縮圖可供讀取，方法是使用 pageToken 欄位中的該值再次呼叫 list。

授權範圍

需要以下 OAuth 範圍：

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

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

影像

一張圖像，帶有主圖像的連結和縮圖。

JSON 表示
{
  "stepId": string,
  "sourceImage": {
    object (ToolOutputReference)
  },

  // Union field thumbnail_or_error can be only one of the following:
  "thumbnail": {
    object (Thumbnail)
  },
  "error": {
    object (Status)
  }
  // End of list of possible types for union field thumbnail_or_error.
}
領域
stepId

string

附加影像的步驟。

始終設定。

sourceImage

object ( ToolOutputReference )

對全尺寸原始影像的參考。

這與其步驟下圖像的 toolOutputs 條目相同。

始終設定。

聯合字段thumbnail_or_error 。圖像的縮圖，或解釋無法呈現縮圖的原因的錯誤。 thumbnail_or_error只能是以下之一：
thumbnail

object ( Thumbnail )

縮圖。

error

object ( Status )

解釋為何無法呈現縮圖的錯誤。

縮圖

單一縮圖及其大小和格式。

JSON 表示
{
  "contentType": string,
  "heightPx": integer,
  "widthPx": integer,
  "data": string
}
領域
contentType

string

縮圖的內容類型，即“image/png”。

始終設定。

heightPx

integer

縮圖的高度（以像素為單位）。

始終設定。

widthPx

integer

縮圖的寬度（以像素為單位）。

始終設定。

data

string ( bytes format)

縮圖文件本身。

也就是說，這裡的位元組正是組成縮圖檔案的位元組；它們可以按原樣作為圖像（具有適當的內容類型）。

始終設定。

Base64 編碼的字串。

地位

Status類型定義了適合不同程式設計環境的邏輯錯誤模型，包括REST API和RPC API。它由gRPC使用。每條Status訊息包含三部分資料：錯誤代碼、錯誤訊息和錯誤詳細資料。

您可以在API 設計指南中找到有關此錯誤模型以及如何使用它的更多資訊。

JSON 表示
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
領域
code

integer

狀態碼，應該是google.rpc.Code的枚舉值。

message

string

面向開發人員的錯誤訊息，應為英文。任何面向使用者的錯誤訊息都應本地化並在google.rpc.Status.details欄位中發送，或由客戶端本地化。

details[]

object

包含錯誤詳細資訊的訊息清單。有一組通用的訊息類型可供 API 使用。

包含任意類型欄位的物件。附加欄位"@type"包含標識類型的 URI。範例： { "id": 1234, "@type": "types.example.com/standard/id" } 。