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

创建作业二进制对象

功能介绍

创建一个作业二进制对象。该接口兼容Sahara。

URI

  • URI格式

    POST /v1.1/{project_id}/job-binaries

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

    名称

    是否必选

    说明

    project_id

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

请求消息

表2 请求参数说明

名称

是否必选

参数类型

说明

name

String

二进制对象名称。

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

url

String

二进制对象URL,并且长度为1~255字符。

该URL必须以“s3a://”“/”开始。

is_protected

Bool

二进制对象是否受保护。

  • true
  • false

当前版本不支持该功能。

is_public

Bool

二进制对象是否公开。

  • true
  • false

当前版本不支持该功能。

description

String

二进制对象描述信息,最大长度为65535字符。

响应消息

表3 响应参数说明

名称

参数类型

说明

description

String

二进制对象描述信息。

url

String

二进制对象URL。

tenant_id

String

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

created_at

String

二进制对象创建时间。

updated_at

String

二进制对象更新时间。

is_protected

Bool

二进制对象是否受保护。

  • true
  • false

当前版本不支持该功能。

is_public

Bool

二进制对象是否公开。

  • true
  • false

当前版本不支持该功能。

id

String

二进制对象ID。

name

String

二进制对象名称。

示例

  • 请求示例
    { 
        "name": "my-job-binary",  
        "url": "/simple/mapreduce/program",  
        "is_protected": false,  
        "is_public": false,  
        "description": "this is the job binary template" 
    }
  • 响应示例
    {
        "job_binary": {
            "name": "my-job-binary",
            "url": "/simple/mapreduce/program",
            "description": "this is the job binary template",
            "created_at": "2017-06-22T09:04:53",
            "updated_at": null,
            "id": "da37b581-042f-4d7a-9378-f628f32bd9ae",
            "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
            "is_public": false,
            "is_protected": false
        }
    }

状态码

状态码如表4所示。

表4 状态码

状态码

描述

202

创建作业二进制对象成功。

异常状态码请参见状态码