Description
Queries information about a specific version of a private App resource, including parameters and command lines.
Request
GET /apps/{AppName}?Detail=True&Qualifier={Qualifier}
Parameter description
Parameter | Type | Required | Description |
AppName | String | Yes | Name of the App |
Qualifier | String | No | Alias or version number of the App.If this parameter is not specified, the information about the latest version is queried. |
Response
Response status code
HTTP/1.1 200 OK
Response body
{
"Name": string,
"Description": string,
"InputParameters": {
string: {
"Description": string,
"Type": string,
"Default": string,
"LocalPath": string
},
...
},
"OutputParameters": {
string: {
"Description": string,
"Type": string,
"LocalPath": string
},
...
},
// begin union
// only one of the following can be specified:
"Docker": {
"Image": string,
"RegistryOSSPath": string
},
"VM": {
"ECSImageId": string
},
// end union
"CommandLine": string,
"EnvVars": {
string: string,
...
},
"Daemonize": boolean,
"Config": {
"ResourceType": {
"Description": string,
"Default": string,
"Overwritable": boolean
},
"InstanceType": {
"Description": string,
"Default": string,
"Overwritable": boolean
},
"InstanceCount": {
"Description": string,
"Default": number,
"Overwritable": boolean
},
"MinDiskSize": {
"Description": string,
"Default": number,
"Overwritable": boolean
},
"DiskType": {
"Description": string,
"Default": string,
"Overwritable": boolean
},
"MaxRetryCount": {
"Description": string,
"Default": number,
"Overwritable": boolean
},
"Timeout": {
"Description": string,
"Default": number,
"Overwritable": boolean
}
}
}
Response parameters
Attribute | Type | Description |
Name | string | Name of the App |
Description | String | Detailed description about the App |
InputParameters | map | Input parameter list of the App |
OutputParameters | map | Output parameter list of the App |
Docker | object | Configuration related to the Docker image |
VM | object | Configuration related to the ECS instance |
CommandLine | String | Command line used to run the App |
EnvVars | map | Environmental variable |
Daemonize | boolean | Whether to restart when the App is executed |
Config | object | Runtime parameters when the job is submitted |
InputParameter
Attribute | Type | Description |
Description | String | Parameter description |
Type | String | Parameter type |
Default | String | Default value of the parameter |
LocalPath | String | If LocalPath is not empty, the parameter specifies a file or directory in the OSS.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 (/). |
OutputParameter
Attribute | Type | Description |
Description | String | Parameter description |
Type | String | Parameter type |
LocalPath | String | If LocalPath is not empty, the parameter specifies a file or directory in the OSS.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 (/). |
Docker
Attribute | Type | Description |
Image | String | Docker image |
RegistryOSSPath | String | Root directory of the Docker registry storage in the OSS |
VM
Attribute | Type | Description |
ECSImageId | String | ECS image ID |
Config
Attribute | Type | Description |
ResourceType | object | Resource type |
InstanceType | object | Instance type |
InstanceCount | object | Number of instances |
MinDiskSize | object | Minimum disk size (GB) |
DiskType | object | Disk type |
MaxRetryCount | object | Maximum number of retries after an instance fails |
Timeout | object | Timeout of an instance, in seconds |
ResourceType
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | String | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
InstanceType
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | String | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
InstanceCount
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | Number | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
MinDiskSize
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | Number | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
DiskType
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | String | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
MaxRetryCount
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | Number | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
Timeout
Attribute | Type | Description |
Description | String | Detailed description provided for App users |
Default | Number | Default value of the parameter |
Overwritable | Boolean | Specifies whether the default value can be overwritten when a user uses this App to submit a job. |
Examples
Request example
GET /apps/myapp?Detail=True&Qualifier=1 HTTP/1.1
Response example
HTTP/1.1 200 OK
{
"CommandLine": "cat ${inputFile} > ${outputFile} ",
"Config": {
"DiskType": {
"Default": "cloud_efficiency",
"Description": "",
"Overwritable": true},
"InstanceCount": {
"Default": 1,
"Description": "",
"Overwritable": true},
"InstanceType": {
"Default": "",
"Description": "",
"Overwritable": true},
"MaxRetryCount": {
"Default": 0,
"Description": "",
"Overwritable": true},
"MinDiskSize": {
"Default": 40,
"Description": "",
"Overwritable": true},
"ResourceType": {
"Default": "OnDemand",
"Description": "",
"Overwritable": true},
"Timeout": {
"Default": 86400,
"Description": "",
"Overwritable": true}},
"Daemonize": false,
"Description": "app description",
"Docker": {
"Image": "myimage",
"RegistryOSSPath": "oss://bucket/registry"},
"EnvVars": {},
"InputParameters": {
"inputFile": {
"Default": null,
"Description": "",
"LocalPath": "/tmp/inputFile",
"Type": "String"}},
"Name": "myapp",
"OutputParameters": {
"outputFile": {
"Description": "",
"LocalPath": "/tmp/outputFile",
"Type": "String"}}}