Method: projects.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/projects/{projectId}/builds/{id}

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.get
id

string

Required. ID of the build.

Query parameters

Parameters
name

string

The name of the Build to retrieve. Format: projects/{project}/locations/{location}/builds/{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.