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
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 (
|
| Fields | |
|---|---|
projectId
|
Required. ID of the project. |
triggerId
|
Required. ID of the trigger. |
source
|
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 .
