- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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/{parent=projects/*/locations/*}/builds
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent
|
The parent of the collection of |
Query parameters
projectId
string
Required. ID of the project.
Authorization requires the following IAM
permission on the specified resource projectId
:
-
cloudbuild.builds.list
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 .
