调用ListExecutions获取一个流程下面的所有历史执行。
接口说明
- 当您删除流程后,其所有的执行历史将不再支持查询,即便您后续创建了同名流程。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListExecutions |
系统规定参数。取值:ListExecutions。 |
FlowName | String | 是 | flow |
流程名称。 |
RequestId | String | 否 | testRequestId |
您这次请求的指定RequestID。如果不指定,我们系统会帮你随机生成。 |
NextToken | String | 否 | flow_xxx |
执行查询开始名称,根据本接口返回获取。 |
Limit | Integer | 否 | 1 |
查询数量。 |
Status | String | 否 | Succeeded |
您希望过滤的执行状态。状态支持以下字段:Running/Stopped/Succeeded/Failed/TimedOut。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Executions | Array |
执行列表。 |
|
FlowDefinition | String | version: v1.0\ntype: flow\nname: test\nsteps:\n - type: pass\n name: mypass |
执行的流程定义。 |
FlowName | String | flow |
流程名称。 |
Input | String | {"key":"value"} |
执行的输入。 |
Name | String | exec |
执行名称。 |
Output | String | {"key":"value"} |
执行的输出。 |
StartedTime | String | 2019-01-01T01:01:01.001Z |
执行开始时间。 |
Status | String | Succeeded |
执行的状态。 |
StoppedTime | String | 2019-01-01T01:01:01.001Z |
执行停止时间。 |
NextToken | String | exec2 |
下个查询起始key,如无其他数据则不返回。 |
RequestId | String | testRequestId |
本次请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListExecutions
&FlowName=flow
&<公共请求参数>
正常返回示例
XML
格式
<CreateFlowResponseponse>
<Description>Response in XML format is not supported.</Description>
</CreateFlowResponseponse>
JSON
格式
{
"Executions": [
{
"Name": "exec",
"FlowName": "flow1",
"FlowDefinition": "version: v1.0\ntype: flow\nname: test\nsteps:\n - type: pass\n name: mypass",
"Input": "",
"Output": "",
"Status": "Succeeded",
"StartedTime": "2019-01-01T01:01:01.001Z",
"StoppedTime": "2019-01-01T01:01:01.001Z"
}
],
"NextToken": "exec2",
"RequestId": "testRequestId"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | AccessDenied | The resources doesn't belong to you. | 请求鉴权未通过,具体内容请参考实际错误信息 |
400 | ActionNotSupported | The requested API operation '%s' is incorrect. Please check. | 所请求方法错误。请参照api文档并检查拼写 |
400 | APIVersionNotSupported | The requested API version '%s' is not supported yet. Please check. | 所请求接口版本不正确。请参考api简介 |
400 | EntityTooLarge | The payload size exceeds maximum allowed size (%s bytes). | 请求消息体过大 |
404 | FlowNotExists | Flow %s does not exist. | 所请求资源不存在,请确保流程已创建。 |
500 | InternalServerError | An internal error has occurred. Please retry. | 服务器内部错误。请稍后重试 |
403 | InvalidAccessKeyID | The AccessKey ID %s is invalid. | access key ID 无效。 |
400 | InvalidArgument | Parameter error. | 请求参数错误。具体内容请参考实际错误信息 |
400 | MissingRequiredHeader | The HTTP header '%s' must be specified. | 请求所需参数缺失。具体内容请参考实际错误信息。 |
400 | MissingRequiredParams | The HTTP query '%s' must be specified. | 请求所需参数缺失。具体内容请参考实际错误信息。 |
412 | PreconditionFailed | The resource to be modified has been changed. | 资源查看/更新检查失败,该资源可能已被更改。请稍后重试 |
403 | RequestTimeTooSkewed | The difference between the request time %s and the current time %s is too large. | 您的请求时间不正确,该请求已被识别为无效。请参考通用参数一节。 |
429 | ResourceThrottled | The request is throttled. Please try again later. | 因某些原因系统流量已达瓶颈。请稍后重试。 |
403 | SignatureNotMatch | The request signature we calculated does not match the signature you provided. Check your access key and signing method. | 您发起请求的签名与我们计算不一致,请检查您的签名算法及access key secret。 |
415 | UnsupportedMediaType | The content type must be "application/json". | 请求消息体类型错误。 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。