Method: projects.locations.repositories.fetchHistory

Fetches a Repository's history of commits. The Repository must not have a value for gitRemoteSettings.url.

HTTP request

GET https://dataform.googleapis.com/v1beta1/{name=projects/*/locations/*/repositories/*}:fetchHistory

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The repository's name.

Authorization requires the following IAM permission on the specified resource name:

  • dataform.repositories.fetchHistory

Query parameters

Parameters
pageSize

integer

Optional. Maximum number of commits to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.

pageToken

string

Optional. Page token received from a previous repositories.fetchHistory call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to repositories.fetchHistory, with the exception of pageSize, must match the call that provided the page token.

Request body

The request body must be empty.

Response body

repositories.fetchHistory response message.

If successful, the response body contains data with the following structure:

JSON representation
{
  "commits": [
    {
      object (CommitLogEntry)
    }
  ],
  "nextPageToken": string
}
Fields
commits[]

object (CommitLogEntry)

A list of commit logs, ordered by 'git log' default order.

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • dataform.repositories.fetchHistory

For more information, see the IAM documentation.

CommitLogEntry

Represents a single commit log.

JSON representation
{
  "commitTime": string,
  "commitSha": string,
  "author": {
    object (CommitAuthor)
  },
  "commitMessage": string
}
Fields
commitTime

string (Timestamp format)

Commit timestamp.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

commitSha

string

The commit SHA for this commit log entry.

author

object (CommitAuthor)

The commit author for this commit log entry.

commitMessage

string

The commit message for this commit log entry.