Method: projects.locations.connections.gitRepositoryLinks.fetchPullRequestList

אחזור רשימה של בקשות משיכה מהמאגר המרוחק.

בקשת HTTP

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

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

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

פרמטרים
name

string

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

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

פרמטרים
filter

string

זה שינוי אופציונלי. ביטוי סינון שמסנן את בקשות המשיכה שמוחזרות בתגובה. יש תמיכה רק בהשוואת שוויון אחת ב-state, לדוגמה state = "OPEN". הערכים הנתמכים הם OPEN,‏ CLOSED ו-MERGED. השדה DECLINED נתמך רק בספקי SCM שתומכים בדחיית בקשות משיכה, ומחזיר את הערך INVALID_ARGUMENT ב-GitHub, ב-GitHub Enterprise, ב-GitLab וב-GitLab Enterprise. ערכים או ביטויים אחרים מחזירים את הערך INVALID_ARGUMENT. אם לא צוין ערך, ברירת המחדל היא state = "OPEN".
pageSize

integer

זה שינוי אופציונלי. מספר התוצאות שיוחזרו ברשימה. ברירת המחדל היא 20. המספר המקסימלי הוא 100. יכול להיות שדף יכיל פחות מ-pageSize תוצאות גם אם יש עוד תוצאות זמינות. צריך להשתמש ב-nextPageToken כדי לבדוק אם יש עוד דפים.
pageToken

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (PullRequest)

רשימת בקשות משיכה (pull request)
nextPageToken

string

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

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • developerconnect.gitRepositoryLinks.fetchPullRequestList

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