Method: projects.histories.list

Listet Historien für ein bestimmtes Projekt auf.

Die Historien sind nach Änderungszeitpunkt in absteigender Reihenfolge sortiert. Der Schlüssel „historyId“ wird verwendet, um den Verlauf mit derselben Änderungszeit zu ordnen.

Kann einen der folgenden kanonischen Fehlercodes zurückgeben:

  • PERMISSION_DENIED – wenn der Benutzer nicht berechtigt ist, das Projekt zu lesen
  • INVALID_ARGUMENT – wenn die Anfrage fehlerhaft ist
  • NOT_FOUND – wenn der Verlauf nicht existiert

HTTP-Anfrage

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

Die URL verwendet die gRPC-Transcoding -Syntax.

Pfadparameter

Parameter
projectId

string

Eine Projekt-ID.

Erforderlich.

Abfrageparameter

Parameter
pageToken

string

Ein Fortsetzungstoken, um die Abfrage beim nächsten Element fortzusetzen.

Optional.

pageSize

integer

Die maximale Anzahl der abzurufenden Historien.

Standardwert: 20. Der Server verwendet diesen Standardwert, wenn das Feld nicht festgelegt ist oder den Wert 0 hat. Jeder Wert größer als 100 wird als 100 behandelt.

Optional.

filterByName

string

Wenn festgelegt, werden nur Historien mit dem angegebenen Namen zurückgegeben.

Optional.

Anforderungstext

Der Anfragetext muss leer sein.

Antwortkörper

Antwortnachricht für HistoryService.List

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
Felder
histories[]

object ( History )

Geschichten.

nextPageToken

string

Ein Fortsetzungstoken, um die Abfrage beim nächsten Element fortzusetzen.

Wird nur gesetzt, wenn weitere Historien abzurufen sind.

Tokens sind ab dem Zeitpunkt der ersten Listenanfrage bis zu einer Stunde gültig. Wenn Sie beispielsweise um 13:00 Uhr eine Listenanfrage stellen und das Token aus dieser ersten Anfrage 10 Minuten später verwenden, ist das Token aus dieser zweiten Antwort nur 50 Minuten lang gültig.

Berechtigungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht .