Method: projects.builds.list

Lists previously requested builds.

Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully.

HTTP request

GET https://cloudbuild.googleapis.com/v1/projects/{projectId}/builds

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. ID of the project.

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

  • cloudbuild.builds.list

Query parameters

Parameters
parent

string

The parent of the collection of Builds. Format: projects/{project}/locations/{location}

pageSize

integer

Number of results to return in the list.

pageToken

string

The page token for the next page of Builds.

If unspecified, the first page of results is returned.

If the token is rejected for any reason, INVALID_ARGUMENT will be thrown. In this case, the token should be discarded, and pagination should be restarted from the first page of results.

See https://google.aip.dev/158 for more.

filter

string

The raw filter text to constrain the results.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListBuildsResponse.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.