Method: projects.locations.repositories.fetchHistory

HTTP request
Path parameters
Query parameters
Request body
Response body
- JSON representation
Authorization scopes
IAM Permissions
CommitLogEntry
- JSON representation
Try it!

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

HTTP request

GET https://dataform.googleapis.com/v1/{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

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.

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

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.

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 one of the following OAuth scopes:

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

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. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"` , `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"` .
`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.