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

Elenca le miniature delle immagini allegate a un passaggio.

Può restituire uno dei seguenti codici di errore canonici: - PERMISSION_DENIED - se l'utente non è autorizzato a leggere dal progetto o da una qualsiasi delle immagini - INVALID_ARGUMENT - se la richiesta non è valida - NOT_FOUND - se il passaggio non esiste, oppure se una qualsiasi delle immagini non esiste

Richiesta HTTP

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

L'URL usa la sintassi di transcodifica gRPC .

Parametri del percorso

Parametri
projectId

string

Un ID progetto.

Necessario.

historyId

string

Un ID storico.

Necessario.

executionId

string

Un ID di esecuzione.

Necessario.

stepId

string

Un ID passaggio.

Necessario.

Parametri di query

Parametri
pageToken

string

Un token di continuazione per riprendere la query dall'elemento successivo.

Opzionale.

pageSize

integer

Il numero massimo di miniature da recuperare.

Valore predefinito: 50. Il server utilizzerà questo valore predefinito se il campo non è impostato o ha un valore pari a 0.

Opzionale.

Richiedi corpo

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta contenente le miniature in un passaggio.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "thumbnails": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Campi
thumbnails[]

object ( Image )

Un elenco di dati di immagine.

Le immagini vengono restituite in ordine deterministico; sono ordinati in base a questi fattori, in ordine di importanza: * Primo, in base al caso di test associato. Le immagini senza un caso di test sono considerate più grandi delle immagini con uno. * In secondo luogo, in base all'ora di creazione. Le immagini senza un tempo di creazione sono maggiori delle immagini con uno. * In terzo luogo, dall'ordine in cui sono stati aggiunti allo step (tramite chiamate a passaggi.create o passaggi.patch).

nextPageToken

string

Un token di continuazione per riprendere la query dall'elemento successivo.

Se impostato, indica che ci sono più miniature da leggere, richiamando nuovamente list con questo valore nel campo pageToken.

Ambiti autorizzativi

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, vedere la panoramica sull'autenticazione .

Immagine

Un'immagine, con un collegamento all'immagine principale e una miniatura.

Rappresentazione 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.
}
Campi
stepId

string

Il passaggio a cui è allegata l'immagine.

Sempre impostato.

sourceImage

object ( ToolOutputReference )

Un riferimento all'immagine originale a grandezza naturale.

È uguale alla voce toolOutputs per l'immagine sotto il suo Step.

Sempre impostato.

Campo di unione thumbnail_or_error . Una miniatura dell'immagine o un errore che spiega il motivo per cui non è stato possibile eseguire il rendering della miniatura. thumbnail_or_error può essere solo uno dei seguenti:
thumbnail

object ( Thumbnail )

La miniatura.

error

object ( Status )

Un errore che spiega perché non è stato possibile eseguire il rendering della miniatura.

Miniatura

Una singola miniatura, con le sue dimensioni e il suo formato.

Rappresentazione JSON
{
  "contentType": string,
  "heightPx": integer,
  "widthPx": integer,
  "data": string
}
Campi
contentType

string

Il tipo di contenuto della miniatura, ad esempio "immagine/png".

Sempre impostato.

heightPx

integer

L'altezza della miniatura, in pixel.

Sempre impostato.

widthPx

integer

La larghezza della miniatura, in pixel.

Sempre impostato.

data

string ( bytes format)

Il file di miniatura stesso.

Cioè, i byte qui sono esattamente i byte che compongono il file di anteprima; possono essere offerti come immagini così come sono (con il tipo di contenuto appropriato).

Sempre impostato.

Una stringa con codifica base64.

Stato

Il tipo Status definisce un modello di errore logico adatto a diversi ambienti di programmazione, incluse le API REST e le API RPC. Viene utilizzato da gRPC . Ogni messaggio Status contiene tre dati: codice di errore, messaggio di errore e dettagli dell'errore.

Puoi trovare ulteriori informazioni su questo modello di errore e su come utilizzarlo nella Guida alla progettazione dell'API .

Rappresentazione JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campi
code

integer

Il codice di stato, che dovrebbe essere un valore enum di google.rpc.Code .

message

string

Un messaggio di errore rivolto agli sviluppatori, che dovrebbe essere in inglese. Qualsiasi messaggio di errore rivolto all'utente deve essere localizzato e inviato nel campo google.rpc.Status.details o localizzato dal client.

details[]

object

Un elenco di messaggi che contengono i dettagli dell'errore. Esiste un set comune di tipi di messaggio che le API possono utilizzare.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" } .