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

Lista miniaturas de imagens anexadas a uma etapa.

Pode retornar qualquer um dos seguintes códigos de erro canônicos: - PERMISSION_DENIED - se o usuário não estiver autorizado a ler no projeto ou em qualquer uma das imagens - INVALID_MCC - se a solicitação estiver incorreta - NOT_FOUND - se a etapa não existir ou se alguma das imagens não existir

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
projectId

string

Um ID do projeto.

Obrigatório.

historyId

string

Um ID do histórico.

Obrigatório.

executionId

string

Um ID de execução.

Obrigatório.

stepId

string

Um ID de etapa.

Obrigatório.

Parâmetros de consulta

Parâmetros
pageToken

string

Um token de continuação para retomar a consulta no próximo item.

Opcional.

pageSize

integer

O número máximo de miniaturas a serem buscadas.

Valor padrão: 50. O servidor usará esse padrão se o campo não estiver definido ou tiver um valor zero.

Opcional.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma resposta contendo as miniaturas em uma etapa.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "thumbnails": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Campos
thumbnails[]

object (Image)

Uma lista de dados de imagem.

As imagens são retornadas em uma ordem determinística. eles são ordenados por esses fatores, em ordem de importância: * Primeiro, pelo caso de teste associado. Imagens sem caso de teste são consideradas maiores do que imagens com um. * Segundo, pelo horário de criação. As imagens sem horário de criação são maiores que as imagens com uma. * Terceiro, pela ordem em que foram adicionados à etapa (por chamadas para steps.create ou steps.patch).

nextPageToken

string

Um token de continuação para retomar a consulta no próximo item.

Se definido, indica que há mais miniaturas para ler, chamando list novamente com esse valor no campo pageToken.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Imagem

Uma imagem, com um link para a imagem principal e uma miniatura.

Representação 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

A etapa à qual a imagem está anexada.

Sempre definido.

sourceImage

object (ToolOutputReference)

Uma referência à imagem original em tamanho real.

É o mesmo que a entrada toolOutputs da imagem em sua etapa.

Sempre definido.

Campo de união thumbnail_or_error. Uma miniatura da imagem ou um erro explicando por que a miniatura não foi renderizada. thumbnail_or_error pode ser apenas de um dos tipos a seguir:
thumbnail

object (Thumbnail)

A miniatura.

error

object (Status)

Um erro que explica por que a miniatura não foi renderizada.

Miniatura

Uma única miniatura, com tamanho e formato.

Representação JSON
{
  "contentType": string,
  "heightPx": integer,
  "widthPx": integer,
  "data": string
}
Campos
contentType

string

O tipo de conteúdo da miniatura, por exemplo, "image/png".

Sempre definido.

heightPx

integer

A altura da miniatura, em pixels.

Sempre definido.

widthPx

integer

A largura da miniatura, em pixels.

Sempre definido.

data

string (bytes format)

O próprio arquivo de miniatura.

Ou seja, estes bytes são exatamente os bytes que compõem o arquivo de miniatura; eles podem ser veiculados como uma imagem no estado em que se encontram (com o tipo de conteúdo apropriado).

Sempre definido.

Uma string codificada em base64.

Status

O tipo Status define um modelo de erro lógico que é adequado a diferentes ambientes de programação, incluindo APIs REST e RPC. É usado por gRPC (em inglês). Cada mensagem Status contém três partes de dados: código do erro, mensagem de erro e detalhes do erro.

É possível descobrir mais sobre esse modelo de erro e como trabalhar com ele no Guia de design de API.

Representação JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campos
code

integer

O código de status, que precisa ser um valor de enumeração de google.rpc.Code.

message

string

Uma mensagem de erro em inglês para o desenvolvedor. Qualquer mensagem de erro para o usuário precisa ser localizada e enviada no campo google.rpc.Status.details, ou localizada pelo cliente.

details[]

object

Uma lista de mensagens com os detalhes do erro. Há um conjunto comum de tipos de mensagens para as APIs usarem.

Um objeto contendo campos de um tipo arbitrário. Um campo adicional "@type" contém uma URI que identifica o tipo. Exemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.