Method: projects.locations.connections.gitRepositoryLinks.fetchCommit

אחזור פרטי Commit מקישור למאגר Git.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
name

string

חובה. שם המשאב של GitRepositoryLink בפורמט projects/*/locations/*/connections/*/gitRepositoryLinks/*.

פרמטרים של שאילתה

פרמטרים
commitSha

string

חובה. ה-SHA של ה-commit או הגרסה הסמלית (לדוגמה, שם ההסתעפות, התג או ההפניה ל-Git).
view

enum (CommitView)

זה שינוי אופציונלי. רמת הפירוט של פרטי השמירה שיופיעו בתשובה. אם לא צוין ערך, ברירת המחדל היא FULL. בתצוגה FULL, מוחזרים המטא-נתונים של files (נתיבים וסטטוסים). צריך לציין גם את pathFilters כדי לאכלס את קטעי התיקונים של השורות.
pathFilters[]

string

זה שינוי אופציונלי. תבניות של נתיבים או נתיבים מדויקים לסינון הקבצים שמוחזרים (רלוונטי רק בתצוגה FULL). כשמציינים את pathFilters, השדה FileDiff.patch מאוכלס בכל הקבצים התואמים (אפשר להשתמש ב-["**"] כדי לכלול תיקונים לכל הקבצים שהשתנו). אם משמיטים את pathFilters או שהוא ריק, מוחזרת הרשימה המלאה של FileDiff בלי הבדלי תיקונים (FileDiff.patch ריק).

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת תגובה ל-gitRepositoryLinks.fetchCommit.

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "commit": {
    object (SCMCommit)
  },
  "files": [
    {
      object (FileDiff)
    }
  ]
}
שדות
commit

object (SCMCommit)

המטא-נתונים של ה-commit.
files[]

object (FileDiff)

רשימת השינויים בקבצים וההבדלים בתיקונים. לא נכלל כשהתצוגה היא BASIC. ההבדלים בתיקונים (FileDiff.patch) מאוכלסים רק כשמציינים את pathFilters בבקשה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב name:

  • developerconnect.gitRepositoryLinks.fetchCommit

מידע נוסף זמין במאמרי העזרה בנושא IAM.