Method: projects.builds.retry

Creates a new build based on the specified build.

This method creates a new build using the original build request, which may or may not result in an identical build.

For triggered builds:

  • Triggered builds resolve to a precise revision; therefore a retry of a triggered build will result in a build that uses the same revision.

For non-triggered builds that specify RepoSource:

  • If the original build built from the tip of a branch, the retried build will build from the tip of that branch, which may not be the same revision as the original build.
  • If the original build specified a commit sha or revision ID, the retried build will use the identical source.

For builds that specify StorageSource:

  • If the original build pulled source from Cloud Storage without specifying the generation of the object, the new build will use the current object, which may be different from the original build source.
  • If the original build pulled source from Cloud Storage and specified the generation of the object, the new build will attempt to use the same object, which may or may not be available depending on the bucket's lifecycle management settings.

HTTP request

POST https://cloudbuild.googleapis.com/v1/projects/{projectId}/builds/{id}:retry

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. ID of the project.

Authorization requires one or more of the following IAM permissions on the specified resource projectId:

  • cloudbuild.builds.get
  • cloudbuild.builds.create
id

string

Required. Build ID of the original build.

Request body

The request body contains data with the following structure:

JSON representation
{
  "name": string
}
Fields
name

string

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

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.