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

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

Arguments

Parameters
parent

string

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

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.

projectId

string

Required. ID of the project.

Raised exceptions

Exceptions
ConnectionError In case of a network problem (such as DNS failure or refused connection).
HttpError If the response status is >= 400 (excluding 429 and 503).
TimeoutError If a long-running operation takes longer to finish than the specified timeout limit.
TypeError If an operation or function receives an argument of the wrong type.
ValueError If 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.locations.builds.list
    args:
        parent: ...
        filter: ...
        pageSize: ...
        pageToken: ...
        projectId: ...
    result: listResult

JSON

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