Method: googleapis.cloudbuild.v1.projects.builds.list

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

Arguments

Parameters
projectId

string

Required. ID of the project.

filter

string

The raw filter text to constrain the results.

pageSize

integer (int32 format)

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.

parent

string

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

Raised exceptions

Exceptions
ConnectionErrorIn case of a network problem (such as DNS failure or refused connection).
HttpErrorIf the response status is >= 400 (excluding 429 and 503).
TimeoutErrorIf a long-running operation takes longer to finish than the specified timeout limit.
TypeErrorIf an operation or function receives an argument of the wrong type.
ValueErrorIf an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout.

Response

If successful, the response contains an instance of ListBuildsResponse.

Subworkflow snippet

Some fields might be optional or required. To identify required fields, refer to the API documentation.

YAML

- list:
    call: googleapis.cloudbuild.v1.projects.builds.list
    args:
        projectId: ...
        filter: ...
        pageSize: ...
        pageToken: ...
        parent: ...
    result: listResult

JSON

[
  {
    "list": {
      "call": "googleapis.cloudbuild.v1.projects.builds.list",
      "args": {
        "projectId": "...",
        "filter": "...",
        "pageSize": "...",
        "pageToken": "...",
        "parent": "..."
      },
      "result": "listResult"
    }
  }
]