在指定Project下创建一个数据加工任务。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /etls HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
project | string | 是 | Project 名称 | ali-test-project |
body | object | 否 | 数据加工任务配置 | |
name | string | 是 | 数据加工任务名称(project 下唯一) | etl-123456 |
displayName | string | 是 | 数据加工任务显示名称 | sls-test-etl |
description | string | 否 | 数据加工任务描述 | this is ETL |
configuration | ETLConfiguration | 是 | 数据加工任务详细配置 |
新版加工的创建需要额外补充 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:])
返回参数
示例
正常返回示例
JSON
格式
{}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
401 | AuthorizationRequired | Authorization Required | 没有访问权限,需要进行用户身份认证 |
访问错误中心查看更多错误码。