Method: projects.locations.triggers.run

Runs a BuildTrigger at a particular source revision.

To run a regional or global trigger, use the POST request that includes the location endpoint in the path (ex. v1/projects/{projectId}/locations/{region}/triggers/{triggerId}:run). The POST request that does not include the location endpoint in the path can only be used when running global triggers.

HTTP request

POST https://cloudbuild.googleapis.com/v1/{name=projects/*/locations/*/triggers/*}:run

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the Trigger to run. Format: projects/{project}/locations/{location}/triggers/{trigger}

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

  • cloudbuild.builds.create

Request body

The request body contains data with the following structure:

JSON representation
{
  "projectId": string,
  "triggerId": string,
  "source": {
    object (RepoSource)
  }
}
Fields
projectId

string

Required. ID of the project.

triggerId

string

Required. ID of the trigger.

source

object (RepoSource)

Source to build against this trigger. Branch and tag names cannot consist of regular expressions.

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.