CreateDeployRevision - - Alibaba Cloud Documentation Center

Creates a deployment revision.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
ApplicationName	string	Yes	The name of the application.	AgentColin3
Description	string	No	The description of the deployment revision.	2026-01-03
RevisionType	string	No	The type of the deployment revision. Valid values: `Command`: A command. `GitRepo`: A Git repository. `HelmChart`: A Helm chart. `Oss`: An object in Object Storage Service (OSS). `EcsImage`: An ECS image. `DockerImage`: A Docker image. `Yaml`: A YAML file.	Command
Location	string	No	The deployment location, specified as a JSON string that contains details such as the bucket name and region.	{"bucketName":"ecs-application-ui-test","objectName":"319137376-pipeline-run-319137376-task-1-cmd-exec.log","regionId":"cn-hangzhou"}
Hooks	string	No	The deployment hook scripts, specified as a JSON string. The scripts contain commands that run when the application starts or stops.	{"applicationStart":"# Execute build process\nbuild() {\n REPO_URL=\"https://github.com/aldinokemal/go-whatsapp-web-multidevice.git\"\n BRANCH=\"main\"\n DOCKERFILE_PATH=\"./dockerfile\"\n "}
DeployResourceType	string	No	The type of the deployment resource. Valid values: `Kubernetes`: A Kubernetes cluster. `Ecs`: An ECS instance. `FC`: A Function Compute service. `SWAS`: A Simple Application Server instance.	Kubernetes

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	4DB0****1234
Revision	object	The details of the deployment revision.	{"RevisionId": "rev-0d6c6956faac431c891b", "ApplicationName": "AgentColin3"}
RevisionId	string	The ID of the deployment revision.	rev-0d6c6956faac431c891b
ApplicationName	string	The name of the application.	AgentColin3
RevisionType	string	The type of the deployment revision. Valid values are `Command`, `GitRepo`, `HelmChart`, `Oss`, `EcsImage`, `DockerImage`, and `Yaml`. The following list describes some of these types: Command: A deployment that uses a command. GitRepo: A deployment from a Git repository. OSS: A deployment from an OSS object.	Oss
Description	string	The description of the deployment revision.	2026-01-05
Location	string	The storage location of the deployment resource, provided as a JSON string.	{"bucketName":"ecs-application-ui-test","objectName":"319137376-pipeline-run-319137376-task-1-cmd-exec.log","regionId":"cn-hangzhou"}
Hooks	string	The deployment hook scripts.	{"applicationStart": "echo \\"介绍agentscope是什么\" \| python agent_sample.py"}
DeployResourceType	string	The deployment resource type.	Ecs

Examples

Success response

JSON format

{
  "RequestId": "4DB0****1234",
  "Revision": {
    "RevisionId": "rev-0d6c6956faac431c891b",
    "ApplicationName": "AgentColin3",
    "RevisionType": "Oss",
    "Description": "2026-01-05",
    "Location": "{\"bucketName\":\"ecs-application-ui-test\",\"objectName\":\"319137376-pipeline-run-319137376-task-1-cmd-exec.log\",\"regionId\":\"cn-hangzhou\"}",
    "Hooks": "{\"applicationStart\": \"echo \\\\\"介绍agentscope是什么\\\" | python agent_sample.py\"}",
    "DeployResourceType": "Ecs"
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.