REST Resource: projects.histories

Recurso: histórico

Um histórico representa uma lista classificada de execuções ordenadas pelo campo start_timestamp_millis (decrescente). Ele pode ser usado para agrupar todas as execuções de um build contínuo.

A ordenação só opera em uma dimensão. Se um repositório tiver várias ramificações, isso significa que será preciso usar vários históricos para ordenar as execuções por ramificação.

Representação JSON 
{
  "historyId": string,
  "name": string,
  "displayName": string,
  "testPlatform": enum (TestPlatform)
}
Campos
historyId

string

Identificador exclusivo em um projeto para esse histórico.

Retorna INVALID_MCC se este campo for definido ou substituído pelo autor da chamada.

  • Sempre definir como resposta
  • Na solicitação de criação: nunca definido
name

string

Um nome para identificar exclusivamente um histórico em um projeto. Máximo de 200 caracteres.

  • Sempre definir como resposta
  • Na solicitação de criação: sempre definido
displayName

string

Um nome curto legível por humanos (texto simples) a ser exibido na interface. Máximo de 100 caracteres.

  • Em resposta: presente se definido durante a criação.
  • Na solicitação de criação: opcional
testPlatform

enum (TestPlatform)

A plataforma do histórico de testes.

  • Em resposta: sempre definido. Retorna a plataforma da última execução, se for desconhecida.

Plataforma de teste

A plataforma do teste.

Enums
unknownPlatform
android
ios

Métodos

create

 Cria um histórico.

get

 Recebe um histórico.

list

 Lista os históricos de um determinado projeto.