Method: projects.locations.connections.gitRepositoryLinks.fetchCommitList

אחזור רשימה של קומיטים מקישור למאגר Git.

בקשת HTTP

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

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

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

פרמטרים
name

string

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

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

פרמטרים
ref

string

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

integer

זה שינוי אופציונלי. מספר התוצאות שיוחזרו ברשימה. ברירת המחדל היא 50. המספר המקסימלי הוא 100.
pageToken

string

זה שינוי אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של gitRepositoryLinks.fetchCommitList. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-gitRepositoryLinks.fetchCommitList חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.
view

enum (CommitView)

זה שינוי אופציונלי. רמת הפירוט של פרטי השמירה שיופיעו בתשובה. יש תמיכה רק ב-BASIC. הערך FULL מחזיר את INVALID_ARGUMENT. אם לא צוין ערך, ברירת המחדל היא BASIC. כדי לקבל את ההבדלים בין הקבצים ב-commit יחיד, משתמשים ב-gitRepositoryLinks.fetchCommit.

גוף הבקשה

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

גוף התשובה

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

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

ייצוג ב-JSON 
{
  "commits": [
    {
      object (SCMCommit)
    }
  ],
  "nextPageToken": string
}
שדות
commits[]

object (SCMCommit)

רשימת המטא-נתונים של הקומיט.
nextPageToken

string

טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • developerconnect.gitRepositoryLinks.fetchCommitList

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