Shape the future of software delivery and make your voice heard by taking the 2021 State of DevOps survey.

Method: projects.locations.builds.get

Returns information about a previously requested build.

The Build that is returned includes its status (such as SUCCESS, FAILURE, or WORKING), and timing information.

HTTP request

GET https://cloudbuild.googleapis.com/v1/{name=projects/*/locations/*/builds/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the Build to retrieve. Format: projects/{project}/locations/{location}/builds/{build}

Query parameters

Parameters
projectId

string

Required. ID of the project.

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

  • cloudbuild.builds.get
id

string

Required. ID of the build.

Request body

The request body must be empty.

Response body

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

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.