調(diào)用CreateFlow接口，創(chuàng)建工作流。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱(chēng) 類(lèi)型 是否必選 示例值 描述
Action String 是 CreateFlow

系統(tǒng)規(guī)定參數(shù)。取值：CreateFlow。

RegionId String 是 cn-hangzhou

地域ID。您可以調(diào)用DescribeRegions查看最新的阿里云地域列表。
ProjectId String 是 FP-ED2F3E844FE3****

項(xiàng)目ID。您可以調(diào)用ListFlowProject查看項(xiàng)目的ID。
Name String 是 myFlow

目錄名稱(chēng)。您可以調(diào)用ListFlowProject查看
Description String 是 這是一個(gè)項(xiàng)目描述

項(xiàng)目描述。
StartSchedule Long 否 1538017814000

開(kāi)始調(diào)度時(shí)間，長(zhǎng)整型時(shí)間戳.。例如：System.currentTimeMillis()。

  • 必須小于EndSchedule。
  • 當(dāng)CronExpr不為空時(shí)，此項(xiàng)必填。
EndSchedule Long 否 1538018814000

調(diào)度失效時(shí)間，長(zhǎng)整型時(shí)間戳，例如System.currentTimeMillis()。
CronExpression String 否 0 0 0-23/1 * * ?

時(shí)間周期調(diào)度的cron表達(dá)式。
CreateCluster Boolean 否 false

是否通過(guò)集群模板創(chuàng)建集群，true表示通過(guò)集群模板創(chuàng)建集群，ClusterId應(yīng)設(shè)置為集群模板 ID(CT-xxx)，否則為已有集群 ID（C-xxx）。
ClusterId String 否 C-A23BD131A862****

集群ID。您可以調(diào)用ListClusters查看集群的ID。
HostName String 否 emr-header-1.cluster-123456

節(jié)點(diǎn)實(shí)例運(yùn)行所在主機(jī)的名稱(chēng)。您可以調(diào)用ListFlow或登錄主機(jī)使用hostname命令查看。
Namespace String 否 無(wú)

保留字段。
Application String 否 無(wú)

APP
AlertConf String 否 {"items":[{"enable":true,"eventId":"EMR-210401001","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]},{"enable":true,"eventId":"EMR-110401015","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]},{"enable":true,"eventId":"EMR-110401002","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]}]}

報(bào)警通知配置，eventId目前支持以下告警：

  • EMR-210401001（工作流失敗報(bào)警）。
  • EMR-110401002（工作流成功通知）。
  • EMR-110401015（工作流節(jié)點(diǎn)失敗報(bào)警）。
AlertUserGroupBizId String 否 ADG-0a00d00abb7743ff9f812f1a997f3d87

報(bào)警用戶(hù)組信息。
AlertDingDingGroupBizId String 否 已過(guò)期

報(bào)警釘釘群信息。
ParentFlowList String 否 F-62ECFC6E1BF6EAD2,F-1E6528634E67B615,F-7E0A84332E9D9A89

依賴(lài)的上游工作流列表，以逗號(hào)分隔。您可以調(diào)用ListFlowInstance查看工作流ID。
ParentCategory String 否 F-62ECFC6E1BF6EAD2,F-1E6528634E67B615,F-7E0A84332E9D9A89

F-62ECFC6E1BF6EAD2,F-1E6528634E67B615,F-7E0A84332E9D9A89
ClientToken String 否 123e4567-e89b-12d3-a456-42665544****

保證請(qǐng)求冪等性。從您的客戶(hù)端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。

返回?cái)?shù)據(jù)

名稱(chēng) 類(lèi)型 示例值 描述
Id String F-7A39731FE719****

新創(chuàng)建的工作流ID。
RequestId String 243D5A48-96A5-4C0C-8966-93CBF65635ED

請(qǐng)求ID。

示例

請(qǐng)求示例

http(s)://[Endpoint]/?Action=CreateFlow
&RegionId=cn-hangzhou
&ProjectId=FP-ED2F3E844FE3****
&Name=myFlow
&Description=這是一個(gè)項(xiàng)目描述
&StartSchedule=1538017814000
&EndSchedule=1538018814000
&CronExpression=0 0 0-23/1 * * ?
&CreateCluster=false
&ClusterId=C-A23BD131A862****
&HostName=emr-header-1.cluster-123456
&Namespace=無(wú)
&Application=無(wú)
&AlertConf={"items":[{"enable":true,"eventId":"EMR-210401001","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]},{"enable":true,"eventId":"EMR-110401015","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]},{"enable":true,"eventId":"EMR-110401002","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]}]}
&AlertUserGroupBizId=ADG-0a00d00abb7743ff9f812f1a997f3d87
&AlertDingDingGroupBizId=已過(guò)期
&ParentFlowList=F-62ECFC6E1BF6EAD2,F-1E6528634E67B615,F-7E0A84332E9D9A89
&ParentCategory=F-62ECFC6E1BF6EAD2,F-1E6528634E67B615,F-7E0A84332E9D9A89
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateFlowResponse>
    <Id>F-7A39731FE719****</Id>
    <RequestId>243D5A48-96A5-4C0C-8966-93CBF65635ED</RequestId>
</CreateFlowResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Id" : "F-7A39731FE719****",
  "RequestId" : "243D5A48-96A5-4C0C-8966-93CBF65635ED"
}

錯(cuò)誤碼

訪(fǎng)問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。

訪(fǎng)問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。