Method: projects.locations.connections.gitRepositoryLinks.fetchCommit

Commit-Details über einen Git-Repository-Link abrufen.

HTTP-Anfrage

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

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
commitSha

string

Pflichtangabe. Der Commit-SHA oder die symbolische Überarbeitung (z. B. Branch-Name, Tag oder Git-Referenz).

view

enum (CommitView)

Optional. Die Ebene der Commit-Details, die in der Antwort zurückgegeben werden sollen. Wenn kein Wert angegeben wird, gilt der Standardwert FULL. In der Ansicht FULL werden files-Metadaten (Pfade und Status) zurückgegeben. pathFilters muss ebenfalls angegeben werden, um Zeilen-Patch-Hunks zu füllen.

pathFilters[]

string

Optional. Pfadmuster oder genaue Pfade zum Filtern zurückgegebener Dateien (nur in der Ansicht FULL anwendbar). Wenn pathFilters angegeben ist, wird FileDiff.patch für alle übereinstimmenden Dateien ausgefüllt. Verwenden Sie ["**"], um Patches für alle geänderten Dateien einzuschließen. Wenn pathFilters weggelassen wird oder leer ist, wird die vollständige Liste der FileDiff ohne Patch-Diffs zurückgegeben (FileDiff.patch ist leer).

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für gitRepositoryLinks.fetchCommit.

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

JSON-Darstellung
{
  "commit": {
    object (SCMCommit)
  },
  "files": [
    {
      object (FileDiff)
    }
  ]
}
Felder
commit

object (SCMCommit)

Die Commit-Metadaten.

files[]

object (FileDiff)

Liste der Dateiänderungen und Patch-Diffs. Wird weggelassen, wenn die Ansicht BASIC ist. Patch-Diffs (FileDiff.patch) werden nur ausgefüllt, wenn pathFilters in der Anfrage angegeben ist.

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.fetchCommit

Weitere Informationen finden Sie in der IAM-Dokumentation.