文档首页/ 数据湖探索 DLI/ API参考/ Spark作业模板相关API/ 创建作业模板 - CreateSparkJobTemplate
更新时间:2025-10-28 GMT+08:00
分享

创建作业模板 - CreateSparkJobTemplate

功能介绍

该API用于创建作业模板。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限及授权项说明
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    Action

    访问级别

    Access Level

    资源类型(*为必须)

    Resource Type (*: required)

    条件键

    Condition Key

    别名

    Alias

    依赖的授权项

    Dependencies

    dli:template:create

    write

    template *

    -

    -

    -

URI

  • URI格式:

    POST /v3/{project_id}/templates

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

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

请求参数

表2 请求参数

参数

是否必选

参数类型

说明

type

String

类型。

  • SQL:SQL模板。
  • SPARK:Spark模板。

name

String

模板名称。

body

String

模板内容。

group

String

模板分组名称。

description

String

模板描述信息。

language

String

语言。

响应参数

表3 响应参数

参数

参数类型

说明

id

String

模板ID。

请求示例

创建一个SQL类型的作业模板,模板内容为“test sql”

{ 
    "type": "SQL",
    "name": "test",
    "description": "",
    "body": "test aql",
    "group": "" 
 }

响应示例

{ 
    "id":"85aad9e5-3766-46c2-b3c0-16c2832e52e8"
 }

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档