更新时间:2022-02-22 GMT+08:00

更新作业对象

功能介绍

编辑指定的作业对象。该接口兼容Sahara。

URI

  • URI格式

    PATCH /v1.1/{project_id}/jobs/{job_id}

  • 参数说明
    表1 URI参数说明

    名称

    是否必选

    说明

    project_id

    项目编号。获取方法,请参见获取项目ID

    job_id

    作业对象ID。

请求消息

表2 请求参数说明

名称

是否必选

参数类型

说明

name

String

作业对象名称。

只能由字母、数字、中划线和下划线组成,并且长度为1~64字符。

mains

Array

作业对象的执行程序集合,当前版本不支持更新。

libs

Array

作业的依赖包集合,当前版本不支持更新。

is_protected

Bool

作业对象是否受保护。

  • true
  • false

当前版本不支持该功能。

interface

Array

自定义接口集合,当前版本不支持更新。

is_public

Bool

作业对象是否公开。

  • true
  • false

当前版本不支持该功能。

type

String

作业对象类型:

  • MapReduce
  • Spark
  • Hive
  • DistCp
  • SparkScript

description

String

作业对象描述信息,最大长度为65535字符。

响应消息

表3 响应参数说明

名称

参数类型

说明

description

String

作业对象描述信息。

tenant_id

String

项目编号。获取方法,请参见获取项目ID

created_at

String

作业对象创建时间。

updated_at

String

作业对象更新时间。

mains

Array

作业对象的执行程序集合。

libs

Array

作业对象的依赖包集合。

is_protected

Bool

作业对象是否受保护。

  • true
  • false

当前版本不支持该功能。

interface

Array

自定义接口集合。

is_public

Bool

作业对象是否公开。

  • true
  • false

当前版本不支持该功能。

type

String

作业对象类型。

id

String

作业对象ID。

name

String

作业对象名称。

示例

  • 请求示例
    {    
        "name": "my-mapreduce-job-update",         
        "mains": [ ],         
        "libs": [                 
        "2628d0e4-6109-4a09-a338-c4ee1b0963ed"        
        ],         
        "is_protected": false,         
        "interface": [ ],         
        "is_public": false,         
        "type": "MapReduce",         
        "description": "This is the Map Reduce job template"    
    }
  • 响应示例
    {
        "job": {
            "name": "my-mapreduce-job-update",
            "type": "MapReduce",
            "description": "This is the Map Reduce job template",
            "mains": [],
            "libs": [
                {
                    "name": "my-job-binary-666",
                    "url": "/simple/mapreduce/program",
                    "description": "this is the job binary template",
                    "id": "2628d0e4-6109-4a09-a338-c4ee1b0963ed",
                    "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
                    "is_public": false,
                    "is_protected": false,
                    "extra": null
                }
            ],
            "created_at": "2017-06-22T12:05:58",
            "updated_at": "2017-06-22T12:05:58",
            "id": "b8ea4daa-0042-45e0-a522-e8b714e74760",
            "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
            "is_public": false,
            "is_protected": false,
            "interface": []
        }
    }

状态码

状态码如表4所示。

表4 状态码

状态码

描述

202

更新作业对象成功。

异常状态码请参见状态码