调用CreateFlow创建一个流程。

接口说明

  • 每个用户所能创建的流程个数受资源限制（详见使用限制），如果您有特殊需求，可以提工单进行调整。
  • 流程在用户级别是按照名称来区分的，即单一账号下不可以存在同名流程。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateFlow

系统规定参数。取值：CreateFlow。

RequestId String 否 testRequestID

请求ID。如果您指定了该值，系统将使用该值作为本次请求的ID；如果您不指定，系统将随机生成。
Name String 是 flow

流程名称。该名称在同一地域内唯一，创建后不可修改。取值说明如下：

  • 支持英文字符（a~z）或（A~Z）、数字（0~9）、下划线（_）和短划线（-）。
  • 首字母必须为英文字母（a~z）、（A~Z）或下划线（_）。
  • 区分大小写。
  • 长度为1~128个字符。
Definition String 是 version:&nbsp;v1.0<br/>type:&nbsp;flow<br/>steps:<br/>&nbsp;-&nbsp;type:&nbsp;pass<br/>&nbsp;name:&nbsp;mypass

流程定义，遵循FDL语法标准。
Description String 是 test flow

流程描述。
Type String 是 FDL

流程类型，取值：FDL。

RoleArn String 否 acs:ram:${region}:${accountID}:${role}

流程执行所需的资源描述符信息，用于在任务执行时，FnF扮演该角色（AssumeRole）以调用资源。
ExternalStorageLocation String 否 /path

外部存储位置。

返回数据

名称 类型 示例值 描述
Type String FDL

流程类型。
Definition String version: v1.0\ntype: flow\nname: test\nsteps:\n - type: pass\n name: mypass

流程定义。
RoleArn String acs:ram:${region}:${accountID}:${role}

流程执行所需资源描述符信息。
RequestId String testRequestID

请求ID。当有http status code返回时，Serverless工作流都会返回请求ID。

Description String test flow

流程描述信息。
Name String flow

流程名称。
CreatedTime String 2019-01-01T01:01:01.001Z

流程创建时间。
LastModifiedTime String 2019-01-01T01:01:01.001Z

流程最近一次的更改时间。
Id String e589e092-e2c0-4dee-b306-3574ddfdddf5****

流程的唯一ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateFlow
&Definition=version: v1.0 type: flow steps: - type: pass name: mypass
&Description=test flow
&Name=flow
&RoleArn=acs:ram::${accountID}:${role}
&Type=FDL
&<公共请求参数>

正常返回示例

JSON格式 

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

{
  "Type" : "FDL",
  "Definition" : "version: v1.0\\ntype: flow\\nname: test\\nsteps:\\n - type: pass\\n name: mypass",
  "RoleArn" : "acs:ram:${region}:${accountID}:${role}",
  "RequestId" : "testRequestID",
  "Description" : "test flow",
  "Name" : "flow",
  "CreatedTime" : "2019-01-01T01:01:01.001Z",
  "LastModifiedTime" : "2019-01-01T01:01:01.001Z",
  "Id" : "e589e092-e2c0-4dee-b306-3574ddfdddf5****"
}

错误码

HttpCode 错误码 错误信息 描述
400 EntityTooLarge The payload size exceeds maximum allowed size (%s bytes). 请求消息体过大。
400 InvalidArgument Parameter error. 请求参数错误。具体内容请参考实际错误信息。
400 MissingRequiredHeader The HTTP header '%s' must be specified. 请求所需参数缺失。具体内容请参考实际错误信息。
400 MissingRequiredParams The HTTP query '%s' must be specified. 请求所需参数缺失。具体内容请参考实际错误信息。
403 InvalidAccessKeyID The AccessKey ID %s is invalid. AccessKey ID无效。
403 RequestTimeTooSkewed The difference between the request time %s and the current time %s is too large. 您的请求时间不正确，该请求已被识别为无效。请参考通用参数一节。
403 SignatureNotMatch The request signature we calculated does not match the signature you provided. Check your access key and signing method. 您发起请求的签名与我们计算不一致，请检查您的签名算法及AccessKey Secret。
409 FlowAlreadyExists Flow %s already exists. 已存在同名流程。
415 UnsupportedMediaType The content type must be "application/json". 请求消息体类型错误。
429 ResourceThrottled The request is throttled. Please try again later. 因某些原因系统流量已达瓶颈。请稍后重试。
500 InternalServerError An internal error has occurred. Please retry. 服务器内部错误。请稍后重试。

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