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

Muestra una lista de las miniaturas de imágenes adjuntas a un paso.

Puede mostrar cualquiera de los siguientes códigos de error canónicos: - PERMISSION_DENIED - si el usuario no tiene autorización para leer desde el proyecto o desde ninguna de las imágenes - INVALID_ARGUMENT - si la solicitud tiene un formato incorrecto - NOT_FOUND - si el paso no existe o si alguna de las imágenes no existe

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
projectId

string

Un ID del proyecto

Obligatorio.
historyId

string

Es un ID de historial.

Obligatorio.
executionId

string

Un ID de ejecución

Obligatorio.
stepId

string

Un ID de paso.

Obligatorio.

Parámetros de consulta

Parámetros
pageToken

string

Un token de continuación para reanudar la consulta en el siguiente elemento.

Opcional.
pageSize

integer

La cantidad máxima de miniaturas que se recuperarán.

Valor predeterminado: 50. El servidor usará este valor predeterminado si el campo no está configurado o tiene un valor de 0.

Opcional.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una respuesta que contiene las miniaturas de un paso.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "thumbnails": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Campos
thumbnails[]

object (Image)

Es una lista de datos de imágenes.

Las imágenes se muestran en un orden determinista. se ordenan según estos factores, en orden de importancia: * Primero, por caso de prueba asociado. Las imágenes sin caso de prueba se consideran más grandes que las imágenes con uno. * En segundo lugar, por su hora de creación. Las imágenes sin una hora de creación son mayores que las imágenes con una. * En tercer lugar, por el orden en el que se agregaron al paso (mediante llamadas a steps.create o steps.patch).
nextPageToken

string

Un token de continuación para reanudar la consulta en el siguiente elemento.

Si se establece, indica que hay más miniaturas para leer, llamando nuevamente a list con este valor en el campo pageToken.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

Imagen

Una imagen con un vínculo a la imagen principal y una miniatura.

Representación 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.
}
Campos
stepId

string

El paso al que se adjunta la imagen.

Siempre establecido.
sourceImage

object (ToolOutputReference)

Es una referencia a la imagen original de tamaño original.

Esto es lo mismo que la entrada toolOutputs para la imagen en su paso.

Siempre establecido.
Campo de unión thumbnail_or_error. Una miniatura de la imagen o un error que explique por qué no se pudo renderizar la miniatura. thumbnail_or_error puede ser solo uno de los siguientes:
thumbnail

object (Thumbnail)

La miniatura
error

object (Status)

Un error que explica por qué no se pudo renderizar la miniatura.

Miniatura

Una sola miniatura, con su tamaño y formato.

Representación JSON 
{
  "contentType": string,
  "heightPx": integer,
  "widthPx": integer,
  "data": string
}
Campos
contentType

string

El tipo de contenido de la miniatura, p.ej., “imagen/png”.

Siempre establecido.
heightPx

integer

La altura de la miniatura en píxeles.

Siempre establecido.
widthPx

integer

Ancho de la miniatura en píxeles.

Siempre establecido.
data

string (bytes format)

El archivo de la miniatura en sí.

Es decir, aquí los bytes son precisamente los que conforman el archivo de la miniatura; se pueden mostrar como una imagen tal como están (con el tipo de contenido adecuado).

Siempre establecido.

String codificada en base64.

Estado

El tipo de Status define un modelo de error lógico que es adecuado para entornos de programación diferentes, incluidas las API de REST y las API de RPC. Lo usa gRPC. Cada mensaje Status contiene tres datos: código de error, mensaje de error y detalles del error.

Puedes obtener más información sobre este modelo de error y cómo trabajar con él en la guía de diseño de API.

Representación JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campos
code

integer

El código de estado, que debe ser un valor enum de google.rpc.Code.
message

string

Un mensaje de error dirigido al desarrollador, que debe estar en inglés. Cualquier mensaje de error dirigido al usuario debe localizarse y enviarse al campo google.rpc.Status.details; o el cliente debe localizarlo.
details[]

object

Una lista de mensajes que contienen los detalles del error. Hay un conjunto común de tipos de mensajes para que usen las API.

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.