Create a trigger -

Note You can use triggers only to redeploy pods.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request syntax

POST /clusters/cluster_id/triggers HTTP/1.1
Content-Type:application/json

{
  "cluster_id" : "String",
  "project_id" : "String",
  "action" : "String",
  "type" : "String"
}

Request parameters

Request path parameters

Parameter	Type	Required	Example	Description
cluster_id	String	Yes	c68deb844dc6d480eb775be611fdf****	The cluster ID.

Request body parameters

Parameter	Type	Required	Example	Description
cluster_id	String	Yes	c5cdf7e3938bc4f8eb0e44b21a80f****	The cluster ID.
project_id	String	Yes	default/test-app	The name of the trigger project. The name consists of the namespace where the application is deployed and the name of the application. The format is `${namespace}/${name}`. Example: `default/test-app`.
action	String	Yes	redeploy	The action that the trigger performs. Set the value to redeploy. `redeploy`: redeploys the resources specified by `project_id`.
type	String	No	deployment	The type of trigger. Valid values: `deployment`: performs actions on Deployments. `application`: performs actions on applications that are deployed in Application Center. Default value: `deployment`.

Response syntax

HTTP/1.1 200 OK
Content-Type:application/json

{
  "id" : "String",
  "cluster_id" : "String",
  "project_id" : "String",
  "type" : "String",
  "action" : "String"
}

Response parameters

Response body parameters

Parameter	Type	Example	Description
id	String	102536	The ID of the application trigger.
cluster_id	String	c93095129fc41463aa455d89444fd****	The cluster ID.
project_id	String	default/test-app	The name of the trigger project.
type	String	deployment	The type of trigger. Default value: deployment.
action	String	redeploy	The action that the trigger performs. For example, a value of `redeploy` indicates that the trigger redeploys the application.

Examples

Sample requests

POST /clusters/c68deb844dc6d480eb775be611fdf****/triggers HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

{
  "cluster_id" : "c5cdf7e3938bc4f8eb0e44b21a80f****",
  "project_id" : "default/test-app",
  "action" : "redeploy",
  "type" : "deployment"
}

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTriggerResponse>
    <id>102536</id>
    <cluster_id>c93095129fc41463aa455d89444fd****</cluster_id>
    <project_id>default/test-app</project_id>
    <type>deployment</type>
    <action>redeploy</action>
</CreateTriggerResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "id" : "102536",
  "cluster_id" : "c93095129fc41463aa455d89444fd****",
  "project_id" : "default/test-app",
  "type" : "deployment",
  "action" : "redeploy"
}

Error codes

For a list of error codes, see Service error codes.