赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 日志服务
  4. 开发参考
  5. API参考
  6. API目录
  7. 数据加工
  8. CreateETL - 创建数据加工任务

CreateETL - 创建数据加工任务

  • 数据加工
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

在指定Project下创建一个数据加工任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /etls HTTP/1.1

请求参数

名称类型必填描述示例值
projectstring是

Project 名称

ali-test-project
bodyobject否

数据加工任务配置

namestring是

数据加工任务名称(project 下唯一)

etl-123456
displayNamestring是

数据加工任务显示名称

sls-test-etl
descriptionstring否

数据加工任务描述

this is ETL
configurationETLConfiguration是

数据加工任务详细配置

新版加工的创建需要额外补充 lang 以及 datasets 参数,以 python 代码为例

# -*- coding: utf-8 -*-
# This file is auto-generated, don't edit it. Thanks.
import os
import sys

from typing import List

from alibabacloud_sls20201230.client import Client as Sls20201230Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_sls20201230 import models as sls_20201230_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Sls20201230Client:
        """
        使用 AK&SK 初始化账号 Client
        @return: Client
        @throws Exception
        """
        # 工程代码泄露可能会导致 AccessKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考。
        # 建议使用更安全的 STS 方式,更多鉴权访问方式请参见:https://help.aliyun.com/document_detail/378659.html。
        config = open_api_models.Config(
            # 必填,请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。,
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # 必填,请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。,
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        # Endpoint 请参考 https://api.aliyun.com/product/Sls
        config.endpoint = f'cn-hangzhou.log.aliyuncs.com'
        return Sls20201230Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        etlconfiguration_etlconfiguration_sink_0 = sls_20201230_models.ETLConfigurationSink(
            name='my-test',
            project='my-test',
            endpoint='cn-hangzhou.log.aliyuncs.com',
            logstore='target',
            role_arn='***',
            datasets=["__UNNAMED__"]
        )
        etlconfiguration = sls_20201230_models.ETLConfiguration(
            script='* | where 1 = 1',
            lang='SPL',
            logstore='mock',
            role_arn='***',
            from_time=1729740027,
            to_time=0,
            sinks=[
                etlconfiguration_etlconfiguration_sink_0
            ]
        )
        create_etlrequest = sls_20201230_models.CreateETLRequest(
            name='etl-my-test',
            display_name='my-test',
            configuration=etlconfiguration
        )
        runtime = util_models.RuntimeOptions()
        headers = {}
        try:
            # 复制代码运行请自行打印 API 的返回值
            client.create_etlwith_options('my-test', create_etlrequest, headers, runtime)
        except Exception as error:
            # 此处仅做打印展示,请谨慎对待异常处理,在工程项目中切勿直接忽略异常。
            # 错误 message
            print(error.message)
            # 诊断地址
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)



if __name__ == '__main__':
    Sample.main(sys.argv[1:])

返回参数

名称类型描述示例值
headersobject
Serverstring

服务器名称

Content-Typestring

返回的响应体的内容格式

Content-Lengthstring

响应内容长度

Connectionstring

是否长链接。取值包括: close:不是长链接,则每个 HTTP 请求都会重新建立 TCP 连接。 keep-alive:长链接,TCP 连接建立后保持连接状态,节省连接所需时间和带宽。

x-log-requestidstring

服务端产生的标识,该请求的唯一 ID。

示例

正常返回示例

JSON格式

{}

错误码

HTTP status code错误码错误信息描述
401AuthorizationRequiredAuthorization Required没有访问权限,需要进行用户身份认证

访问错误中心查看更多错误码。

相关文章

CreateETL - 创建数据加工任务 2025-04-22 10:39

在指定Project下创建一个数据加工任务。

DeleteETL - 删除数据加工任务 2025-04-22 10:39

删除一个数据加工任务。

UpdateETL - 更新数据加工任务 2025-04-22 10:39

更新指定的数据加工任务。

StartETL - 启动数据加工任务 2025-04-22 10:39

启动指定的数据加工任务。

StopETL - 停止数据加工任务 2025-04-22 10:39

停止指定的数据加工任务。

ListETLs - 列出数据加工任务 2025-04-22 10:39

列出project下的数据加工任务。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号