全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
批量计算

创建作业(App类型)

更新时间:2017-11-03 14:13:37

CreateJob

描述

创建一个使用App的job资源。

请求方法

POST /jobs

请求消息体

  1. {
  2. "Name": string,
  3. "Description": string,
  4. "Type": "App",
  5. "App": {
  6. "AppName": string,
  7. "Inputs": {
  8. string: Any
  9. },
  10. "Outputs": {
  11. string: string
  12. },
  13. "Logging": {
  14. "StdoutPath": string,
  15. "StderrPath": string
  16. },
  17. "Config": {
  18. "ResourceType": string,
  19. "InstanceType": string,
  20. "InstanceCount": number,
  21. "MinDiskSize": number,
  22. "DiskType": string,
  23. "MaxRetryCount": number,
  24. "Timeout": number,
  25. "ReserveOnFail": boolean
  26. }
  27. }
  28. }

请求参数

参数

参数名称 类型 必选 描述
Name string 作业名称。允许的字符集为[a-zA-Z0-9_-],长度不能大于100,不能为空
Description string 作业的详细描述。长度不能大于1000。默认值:空
Type string 作业类型。App类型的作业其值必须为:App
AppName string app name。允许的字符集为[a-zA-Z0-9_-:],长度不能大于1024。App名Name有两种格式,分别用于访问公共的App和自己私有的App。比如,要访问公共App App1,则可以设置为Public:App1,其中的Public可以省略,变为:App1。如果App1是自己的私有App,则直接设置为App1。
Inputs map<string, Any> 作业输入参数。Map大小不能大于50,不能小于0。Key应为App中InputParameters定义的参数名,Value应当与App中参数定义的类型相同。
outputs map<string, string> 作业输出参数。Map大小不能大于50,不能小于0。Key应为App中OutputParameters定义的LocalPath不为空的参数名,Value应当为某个OSS路径。默认值:{}
Logging object(Logging) 日志配置
Config object(Config) 作业运行时配置

Logging

参数名称 类型 必选 描述
StdoutPath string 标准输出重定向到OSS的目录。长度不能大于1000。默认值:空
StderrPath string 标准错误重定向到OSS的目录。长度不能大于1000。默认值:空

Config

参数名称 类型 必选 描述
ResourceType string 资源类型。可以取值为:OnDemand,Spot。默认值为App中定义的值。
InstanceType string ECS实例类型。默认值为App中定义的值。
InstanceCount number 并发执行实例个数。默认值为App中定义的值。
MinDiskSize number 最小磁盘大小(单位GB)。默认值为App中定义的值。
DiskType string 磁盘类型。默认值为App中定义的值。
MaxRetryCount number 某个Instance失败后,最大重试次数。默认值为App中定义的值。
Timeout number Instance的运行时超时时间,单位为秒。默认值为App中定义的值。
ReserveOnFail number 作业失败后,是否保留虚拟机,以待调查问题。默认值为false。

响应

响应状态码

201

响应消息体

  1. {
  2. "Id": string
  3. }

响应参数

参数名称 类型 描述
Id string 资源Id

示例

请求示例

  1. POST /jobs
  2. {
  3. "Name": "job_name",
  4. "Description": "job description",
  5. "Type": "App",
  6. "App": {
  7. "AppName": "myapp",
  8. "Inputs": {
  9. "inputFile": "oss://bucket/a"
  10. },
  11. "Outputs": {
  12. "outputFile": "oss://bucket/b"
  13. },
  14. "Config": {
  15. "InstanceType": "ecs.s3.large"
  16. },
  17. "Logging": {
  18. "StdoutPath": "oss://bucket/logging/",
  19. "StderrPath": "oss://bucket/logging/"
  20. }
  21. }
  22. }

返回示例

  1. HTTP/1.1 201 Created
  2. {
  3. "Id": "job-0000123"
  4. }
本文导读目录