Method description
Creates an App.
Call method
CreateAppResponse createApp(AppDescription appDescription) throws ClientException;
CreateAppResponse createApp(CreateAppRequest req) throws ClientException;
CreateAppResponse createApp(AppDescription appDescription, String idempotentToken) throws ClientException;
Parameter description
Parameter |
Type |
Required |
Description |
appDescription |
AppDescription |
Yes |
Description of the created App |
The package names of the following classes are all com.aliyuncs.batchcompute.pojo.v20151111.
Attributes of AppDescription
The getter and setter methods are available to all attributes.
Attribute |
Type |
Required |
Description |
name |
String |
Yes |
App name |
description |
String |
No |
Brief description |
inputParameters |
Map |
No |
Input parameter description |
outputParameters |
Map |
No |
Output parameter description |
docker |
AppDescription.Docker |
No |
Use the Docker configuration. You can select one of Docker and VM for configuration |
vm |
AppDescription.VM |
No |
Use the ECS VM-related configurations.You can select one of Docker and VM for configuration |
commandLine |
String |
Yes |
Command line for running the App. |
envVars |
Map |
No |
Environmental variable. “Map” must be a value between 0 and 50. The valid character set of Key is [a-zA-Z0-9_-], and the length of Key cannot exceed 100 characters. The length of value cannot exceed 1000 characters. Default value:{} |
daemonize |
Boolean |
No |
Specifies whether to restart when the App is executed. The default value is False |
config |
AppDescription.Config |
No |
Runtime parameters when the job is submitted |
Parameter |
Type |
Required |
Description |
description |
String |
No |
Parameter description. The length cannot exceed 1000 characters. Default value: null |
type |
String |
No |
Parameter type. Enumerated type. Optional values include String and Number. Default value: String |
defaultValue |
Any |
No |
Default value of the parameter. The type must be the same as that specified by Type. Default value: null |
localPath |
String |
No |
If LocalPath is not null, this parameter specifies an OSS file or directory. During compute analysis, the system maps the OSS file or directory specified by this parameter to a file or directory specified by LocalPath. It supports only UTF-8 encoding. If localPath is a directory, it must end with a slash (/).The length cannot exceed 1000 characters. Default value: null |
Attributes of AppDescription.OutputParameterValue
Parameter |
Type |
Required |
Description |
description |
String |
No |
Parameter description.The length cannot exceed 1000 characters. Default value: null |
type |
String |
No |
Parameter type.Enumerated type. Optional values include String and Number.Default value: String |
localPath |
String |
No |
If LocalPath is not null, this parameter specifies an OSS file or directory. During compute analysis, the system maps the file or directory specified by LocalPath to a file or directory specified by this parameter.It supports only UTF-8 encoding.If localPath is a directory, it must end with a slash (/).The length cannot exceed 1000 characters. Default value: null |
Attributes of AppDescription.Docker
Parameter |
Type |
Required |
Description |
image |
String |
Yes |
Docker image. The length cannot exceed 1000 characters |
registryOSSPath |
String |
No |
Root directory of the Docker registry storage on the OSS instance.The length cannot exceed 1000 characters. Default value: null |
Attributes of AppDescription.VM
Parameter |
Type |
Required |
Description |
ECSImageId |
String |
Yes |
ID of the ECS image. The valid character set is [a-zA-Z0-9_-]. The length cannot exceed 100 characters. |
Attributes of AppDescription.Config
Parameter |
Type |
Required |
Description |
resourceType |
App.ConfigValue |
No |
Type of the resource |
instanceType |
App.ConfigValue |
No |
Type of the instance |
instanceCount |
App.ConfigValueInteger |
No |
Number of instances |
minDiskSize |
App.ConfigValue |
No |
Minimum size of the system disk (GB) |
diskType |
App.ConfigValue |
No |
Type of the system disk |
maxRetryCount |
App.ConfigValueInteger |
No |
Maximum number of retries after an instance fails |
timeout |
App.ConfigValueLong |
No |
Timeout of an instance, in seconds |
Attributes of AppDescription.ConfigValue
Attribute |
Type |
Required |
Description |
description |
String |
No |
Detailed description for the App users |
defaultValue |
string |
No |
Default value of the parameter |
overwritable |
Boolean |
No |
Specifies whether the default value is overwritten if this App is used to submit a job |
Attributes of AppDescription.ConfigValueInteger
Attribute |
Type |
Required |
Description |
description |
String |
No |
Detailed description for the App users |
defaultValue |
int |
No |
Default value of the parameter |
overwritable |
Boolean |
No |
Specifies whether the default value is overwritten if this App is used to submit a job |
Attributes of AppDescription.ConfigValueLong
Parameter |
Type |
Required |
Description |
description |
String |
No |
Detailed description for the App users |
defaultValue |
long |
No |
Default value of the parameter |
overwritable |
Boolean |
No |
Specifies whether the default value is overwritten if this App is used to submit a job |
Response description
- If the App is successfully created, a CreateAppResponse instance is returned. You can use response.getAppName() to obtain the name of the created App.
Type |
Description |
CreateAppResponse |
Obtains the name of the created App |
- The CreateAppResponse package name is com.aliyuncs.batchcompute.model.v20151111.
- Other responses listed in the following are under this package.
- If creation fails, a ClientException is thrown.
Sample code
try{
CreateAppResponse response = client.createApp(appDescription);
String appName = response.getAppName();
//Creation succeeded
}catch(ClientException e){
e.printStackTrace();
//Creation failed
}