aws:branch— 运行条件自动化步骤 - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

aws:branch— 运行条件自动化步骤

这些区域有:aws:branch操作让您能够创建在一个步骤中评估不同选择,然后根据评估结果跳转到 Runbook 中的不同步骤的动态自动化。

当您指定aws:branch操作时,您可以指定Choices自动化必须评估。这些区域有:Choices可以基于您在Parameters部分,或生成作为上一步的输出生成的动态值。Automation 使用布尔表达式评估每个选择。如果第一个选择为真,则自动化跳转到为该选择指定的步骤。如果第一个选择为假,则自动化评估下一个选择。自动化继续评估每个选择,直到处理真的选择为止。然后,Automation 跳转到指定的步骤以获得真正的选择。

如果所有选择都为假,则 Automation 检查该步骤是否包含default值。默认值定义当所有选择都为假时自动化应跳转到的步骤。如果没有default值,则自动化处理 Runbook 中的下一个步骤。

aws:branch 操作通过组合使用 AndNotOr 运算符来支持复杂的选择评估。有关如何使用的更多信息aws:branch,包括使用不同运算符的示例 Runbook 和示例,请参阅使用条件分支创建动态自动化

Input

在步骤中指定一个或多个 Choices。这些区域有:Choices可以基于您在Parameters部分,或生成作为上一步的输出生成的动态值。下面是一个评估参数的 YAML 示例。

mainSteps: - name: chooseOS action: aws:branch inputs: Choices: - NextStep: runWindowsCommand Variable: "{{Name of a parameter defined in the Parameters section. For example: OS_name}}" StringEquals: windows - NextStep: runLinuxCommand Variable: "{{Name of a parameter defined in the Parameters section. For example: OS_name}}" StringEquals: linux Default: sleep3

下面是一个评估上一步输出的 YAML 示例。

mainSteps: - name: chooseOS action: aws:branch inputs: Choices: - NextStep: runPowerShellCommand Variable: "{{Name of a response object. For example: GetInstance.platform}}" StringEquals: Windows - NextStep: runShellCommand Variable: "{{Name of a response object. For example: GetInstance.platform}}" StringEquals: Linux Default: sleep3
Choices

Automation 在确定下一个要处理的步骤时应评估的一个或多个表达式。通过使用布尔表达式对选择进行评估。每个选择都必须定义以下选项:

  • NextStep:如果指定的选择为真,则 Runbook 中要处理的下一个步骤。

  • 变量:指定参数的名称,该参数在Parameters部分。或指定来自 Runbook 中上一步的输出对象。有关为 aws:branch 创建变量的更多信息,请参阅关于创建输出变量

  • 运算:用于评估选择的标准。aws:branch 操作支持以下运算:

    字符串运算

    • 字符串等于

    • EqualsIgnoreCase

    • StartsWith

    • EndsWith

    • 包含

    数值运算

    • NumericEquals

    • NumericGreater

    • NumericLesser

    • NumericGreaterOrEquals

    • NumericLesser

    • NumericLesserOrEquals

    布尔运算

    • BooleanEquals

    重要

    创建 Runbook 时,系统将验证 Runbook 中的每个操作。如果某个操作不受支持,则在尝试创建 Runbook 时,系统会返回错误。

默认值

自动化应跳转到的步骤的名称Choices都 true.

类型: 字符串

:必需 否

注意

aws:branch 操作支持 AndOrNot 运算符。有关使用运算符的 aws:branch 的示例,请参阅使用条件分支创建动态自动化