AWS StepFunction父流程调用子流程时如何自定义子执行实例名称

你的报错是由于AWS Step Functions的参数动态取值规则导致：如果需要从执行输入、上下文变量中读取值作为参数，参数键必须以.$结尾。你当前配置的"Name": "$.Name"会被系统直接将$.Name这个字符串字面量作为子执行的名称，不符合Step Functions执行名的命名规范（仅支持字母、数字、连字符、下划线，长度1-80位），因此抛出InvalidName错误。

你使用的arn:aws:states:::states:startExecution.sync原生支持最长1年的同步等待，完全覆盖子流程超过15分钟的业务场景，不需要额外调用Lambda。

1. 直接从父流程入参传递子执行名称 #

将Name参数的键修改为带.$后缀即可，修改后的状态配置如下：

"Trigger Inner StepFunction": {
  "Type": "Task",
  "Resource": "arn:aws:states:::states:startExecution.sync",
  "Parameters": {
    "StateMachineArn": "arn:aws:states:eu-west-1:xxxxx:stateMachine:InnerStepFunc",
    "Name.$": "$.Name",
    "Input": {
      "StatePayload": "Hello from Step Functions!",
      "AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id"
    }
  },
  "Next": "NextStep"
}

只要父流程入参中的Name字段符合命名规范，即可正常将其设置为子执行的名称。

2. 固定前缀+随机ID自动生成名称 #

使用Step Functions内置的内置函数States.Format和States.UUID即可实现，不需要额外调用Lambda：

"Trigger Inner StepFunction": {
  "Type": "Task",
  "Resource": "arn:aws:states:::states:startExecution.sync",
  "Parameters": {
    "StateMachineArn": "arn:aws:states:eu-west-1:xxxxx:stateMachine:InnerStepFunc",
    "Name.$": "States.Format('inner-exec-{}', States.UUID())",
    "Input": {
      "StatePayload": "Hello from Step Functions!",
      "AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id"
    }
  },
  "Next": "NextStep"
}

上述配置会生成类似inner-exec-123e4567-e89b-12d3-a456-426614174000格式的子执行名称，也可以替换为你需要的前缀。

3. 同时支持入参传递+默认自动生成（fallback逻辑） #

如果需要实现「父入参传了Name就用传入值，没传就自动生成前缀加随机ID的名称」的逻辑，可以结合States.If和States.IsPresent内置函数实现：

"Trigger Inner StepFunction": {
  "Type": "Task",
  "Resource": "arn:aws:states:::states:startExecution.sync",
  "Parameters": {
    "StateMachineArn": "arn:aws:states:eu-west-1:xxxxx:stateMachine:InnerStepFunc",
    "Name.$": "States.If(States.IsPresent($.Name), $.Name, States.Format('inner-exec-{}', States.UUID()))",
    "Input": {
      "StatePayload": "Hello from Step Functions!",
      "AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id"
    }
  },
  "Next": "NextStep"
}

• Step Functions同一状态机下的执行名称必须全局唯一，因此如果使用自定义固定名称，重复提交会抛出ExecutionAlreadyExists错误，添加随机UUID后缀可以避免该问题
• 执行名称仅支持字母、数字、-、_四类字符，长度不能超过80位
• 所有从路径/函数动态取值的参数，参数键必须加.$后缀，否则会被当做字面量处理

内容的提问来源于stack exchange，提问作者Stefan Volkmer