Method: projects.locations.connections.gitRepositoryLinks.fetchCommitList

從 Git 存放區連結擷取修訂版本清單。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
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。使用 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 權限

需要 name 資源的下列 IAM 權限：

  • developerconnect.gitRepositoryLinks.fetchCommitList

詳情請參閱 IAM 說明文件。