REST Resource: projects.histories

Ressource: Geschichte

Ein Verlauf stellt eine sortierte Liste von Ausführungen dar, sortiert nach dem Feld start_timestamp_millis (absteigend). Es kann verwendet werden, um alle Ausführungen eines kontinuierlichen Builds zu gruppieren.

Beachten Sie, dass die Reihenfolge nur eindimensional funktioniert. Wenn ein Repository über mehrere Zweige verfügt, bedeutet dies, dass mehrere Historien verwendet werden müssen, um die Ausführungen pro Zweig zu ordnen.

JSON-Darstellung
{
  "historyId": string,
  "name": string,
  "displayName": string,
  "testPlatform": enum (TestPlatform)
}
Felder
historyId

string

Eine eindeutige Kennung innerhalb eines Projekts für diesen Verlauf.

Gibt INVALID_ARGUMENT zurück, wenn dieses Feld vom Aufrufer festgelegt oder überschrieben wird.

  • Als Antwort immer gesetzt
  • In der Erstellungsanforderung: nie festgelegt
name

string

Ein Name zur eindeutigen Identifizierung eines Verlaufs innerhalb eines Projekts. Maximal 200 Zeichen.

  • Als Antwort immer gesetzt
  • In Anforderung erstellen: immer festlegen
displayName

string

Ein kurzer, für Menschen lesbarer Name (einfacher Text), der in der Benutzeroberfläche angezeigt wird. Maximal 100 Zeichen.

  • Als Antwort: vorhanden, wenn beim Erstellen festgelegt.
  • In der Erstellungsanfrage: optional
testPlatform

enum ( TestPlatform )

Die Plattform der Testhistorie.

  • Als Antwort: immer gesetzt. Gibt die Plattform der letzten Ausführung zurück, falls unbekannt.

Testplattform

Die Plattform des Tests.

Aufzählungen
unknownPlatform
android
ios

Methoden

create

 Erstellt einen Verlauf.

get

 Ruft einen Verlauf ab.

list

 Listet Historien für ein bestimmtes Projekt auf.