在工作流文档中使用动态变量

您可以在工作流文档中使用动态变量来表示映像创建过程中在运行时会发生变化的值。动态变量的字符串插值允许您在结构化内容（例如 JSON 字符串）中嵌入 JSONPath 表达式。当您需要将复杂负载中的运行时值传递给步进操作（如或）时，这特别有用。ExecuteStateMachine WaitForAction

要对动态变量使用字符串插值，请在字符串内容中将 JSONPath 表达式用双大括号"{{...}}"括起来。只有用双花括号括起来的 JSONPath 表达式才会被当作变量处理。任何未用双大括号括起的 JSONPath 表达式都被视为文字字符串内容。

JSONPath 动态工作流程变量语法

$.<document structure>.[<step name>.]<variable name>

动态变量值表示为具有唯一标识目标变量的结构节点的 JSONPath 选择器。根 ($) 之后的第一个节点是指工作流文档结构，例如 stepOutputs，如果是 Image Builder 系统变量，则为 imageBuilder。以下列表包含支持 JSONPath 的工作流文档结构节点。

parameters 和 stepOutputs 文档结构节点包括步骤名称的可选节点。这样有助于确保所有步骤中变量名称的唯一性。

中的最后一个节点 JSONPath 是目标变量的名称，例如instanceId。

每个步骤都可以使用这些 JSONPath 动态变量引用任何先前步骤操作的输出。这也称为链接或引用。要引用先前步骤操作的输出，可以使用以下动态变量。

$.stepOutputs.step-name.output-name

示例 1：输入参数链接指示器

以下示例显示了一个输入参数，该参数在运行时使用字符串插值来解析参数值中的动态变量。

  - name: ApplyTestComponents
    action: ExecuteComponents
    onFailure: Abort
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

示例 2：动态变量中的字符串插值

以下示例演示了动态变量如何在运行时使用字符串插值来确定值。

- name: ValidateImageConfiguration
  action: ExecuteStateMachine
  inputs:
    stateMachineArn: arn:aws:states:us-east-1:111122223333:stateMachine:ImageValidation
    input: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-east-1",
        "buildDate": "{{ $.imagebuilder.dateTime }}",
        "instanceType": "{{ $.stepOutputs.LaunchStep.instanceType }}"
      }

在此示例中，用双大括号包裹的 JSONPath 表达式在运行时被解析：

像这样的字面字符串"region": "us-east-1"保持不变。

使用 Image Builder 系统变量

Image Builder 提供了以下可在工作流文档中使用的系统变量：