更新时间:2024-03-15 GMT+08:00

新建模板

功能介绍

该API在DLI服务中新建一个用户模板,最多100个。

URI

  • URI格式

    POST /v1.0/{project_id}/streaming/job-templates

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

    参数名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目编号,用于资源隔离。获取方式请参考获取项目ID

请求消息

表2 请求参数说明

参数名称

是否必选

参数类型

说明

name

String

模板名称。长度限制:1-64个字符 。

desc

String

模板描述。长度限制:0-512个字符。

sql_body

String

Stream SQL语句,至少包含source,query,sink三个部分。长度限制:0-2048个字符。

tags

Array of Objects

Flink作业模板的标签。具体请参考表3

job_type

String

Flink作业模板类型。默认值为"flink_sql_job",若填写则只能为"flink_sql_job"或者"flink_opensource_sql_job"。

表3 tags参数

参数名称

是否必选

参数类型

说明

key

String

标签的键。

说明:

标签的键的最大长度为128个字符,标签的键可以包含任意语种字母、数字、空格和_ . : =+-@ ,但首尾不能含有空格,不能以_sys_开头。

value

String

标签的值。

说明:

标签值的最大长度为255个字符,标签的值可以包含任意语种字母、数字、空格和_ . : =+-@ ,但首尾不能含有空格。

响应消息

表4 响应参数说明

参数名称

是否必选

参数类型

说明

is_success

Boolean

请求是否成功。

message

String

消息内容。

template

Object

作业更新信息。请参见表5

表5 template参数说明

参数名称

是否必选

参数类型

说明

template_id

Long

模板ID。

name

String

模板名称。

desc

String

模板描述。

create_time

Long

模板创建时间。

job_type

String

作业模板类型。

请求示例

创建一个名为simple_stream_sql的作业模板。

{
    "name": "simple_stream_sql",
    "desc": "快速上手示例",
    "sql_body": "select * from source_table",
    "job_type": "flink_sql_job"
}

响应示例

{
    "is_success": true,
    "message": "新建成功",
    "template": {
        "template_id": 0,
        "name": "IoT_example",
        "desc": "快速上手示例",
        "create_time": 1516952710040,
        "job_type": "flink_opensource_sql_job"
    }
}

状态码

状态码如表6所示。

表6 状态码

状态码

描述

200

创建模板成功。

400

输入参数无效。

错误码

调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码