查看作业的提交信息

最近更新时间:2018-03-21 18:04:21

1. 接口描述

本接口(DescribeJobSubmitInfo)用于查询指定作业的提交信息,其返回内容包括 JobId 和 SubmitJob 接口中作为输入参数的作业提交信息
接口请求域名:batch.api.qcloud.com

2. 输入参数

名称 类型 是否必选 描述
Version String API版本号
JobId String 按照作业ID查询作业详细信息。

3. 输出参数

名称 类型 描述
RequestId String 唯一请求ID。每次请求都会返回RequestId。当用户调用接口失败找后台研发人员处理时需提供该RequestId。
JobId String 作业ID
JobName String 作业名称
JobDescription String 作业描述
Priority Integer 作业优先级,任务(Task)和任务实例(TaskInstance)会继承作业优先级
Tasks.N array of Task objects 任务信息
Dependences.N array of Dependence objects 依赖信息
Notifications array of Notification objects 通知信息

备注:具体 DataType 参考 SubmitJob接口

{
  "Response": {
    "Priority": 1,
    "JobName": "test job",
    "Tasks": [
      {
        "TaskInstanceNum": 1,
        "ComputeEnv": {
          "EnvType": "MANAGED",
          "EnvData": {
            "VirtualPrivateCloud": {
              "SubnetId": "subnet-8axej2jc",
              "VpcId": "vpc-cg18la4l"
            },
            "SystemDisk": {
              "DiskSize": 50,
              "DiskType": "CLOUD_BASIC"
            },
            "InternetAccessible": {
              "PublicIpAssigned": "TRUE",
              "InternetMaxBandwidthOut": 50
            },
            "ImageId": "img-bd78fy2t",
            "InstanceType": "S1.SMALL1",
            "DataDisks": [
              {
                "DiskSize": 50,
                "DiskType": "CLOUD_BASIC"
              }
            ]
          }
        },
        "RedirectInfo": {
          "StdoutRedirectPath": "cos://dondonbatchv5-1251783334.cosgz.myqcloud.com/logs/",
          "StderrRedirectPath": "cos://dondonbatchv5-1251783334.cosgz.myqcloud.com/logs/"
        },
        "Application": {
          "Command": "python -c \"fib=lambda n:1 if n<=2 else fib(n-1)+fib(n-2); print(fib(20))\"; echo \"haha\" ",
          "DeliveryForm": "LOCAL"
        },
        "MaxRetryCount": 0,
        "FailedAction": "TERMINATE",
        "TaskName": "hello2"
      }
    ],
    "JobDescription": "xxx",
    "JobId": "job-ceg5mu8x",
    "Notifications": [
      {
        "TopicName": "topic name",
        "EventConfigs": [
          {
            "EventName": "JOB_RUNNING",
            "EventVars": [
              {
                "Name": "name1",
                "Value": "value1"
              },
              {
                "Name": "name2",
                "Value": "value2"
              }
            ]
          }
        ]
      }
    ],
    "RequestId": "9d7b0c99-f9b2-451c-ad68-090a6b7c04b2"
  }
}

4. 错误码

以下错误码表仅列出了该接口的业务逻辑错误码。

错误码 描述
JobNotFound 指定作业不存在。
InvalidBatchJobId.Malformed 非法的作业ID格式。
InternalServerError 内部服务错误。