Method: projects.locations.connections.gitRepositoryLinks.fetchCommitList

Liste der Commits über einen Git-Repository-Link abrufen

HTTP-Anfrage

GET https://developerconnect.googleapis.com/v1/{name=projects/*/locations/*/connections/*/gitRepositoryLinks/*}:fetchCommitList

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Pflichtangabe. Der Ressourcenname des GitRepositoryLink im Format projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Suchparameter

Parameter
ref

string

Optional. Der Commit-SHA oder die symbolische Überarbeitung (z. B. Branch-Name, Tag oder Git-Referenz), ab der Commits aufgelistet werden sollen.
pageSize

integer

Optional. Anzahl der Ergebnisse, die in der Liste zurückgegeben werden sollen. Der Standardwert ist 50. Der Höchstwert ist 100.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen gitRepositoryLinks.fetchCommitList-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für gitRepositoryLinks.fetchCommitList bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
view

enum (CommitView)

Optional. Die Ebene der Commit-Details, die in der Antwort zurückgegeben werden sollen. Nur BASIC wird unterstützt. FULL gibt INVALID_ARGUMENT zurück. Wenn keine Angabe gemacht wird, ist der Standardwert BASIC. Verwenden Sie gitRepositoryLinks.fetchCommit, um Dateiunterschiede für einen einzelnen Commit abzurufen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für gitRepositoryLinks.fetchCommitList.

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

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

object (SCMCommit)

Die Liste der Commit-Metadaten.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • developerconnect.gitRepositoryLinks.fetchCommitList

Weitere Informationen finden Sie in der IAM-Dokumentation.