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

您可以在工作流文档中使用动态变量来表示映像创建过程中在运行时会发生变化的值。动态变量的字符串插值允许您在结构化内容（如 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 提供以下系统变量，您可以在工作流程文档中使用这些变量。这些是映像生成器在运行时填充的只读值。例如，您使用imagebuilder文档结构节点引用系统变量$.imagebuilder.platform。