aws:branch - 조건부 자동화 단계 실행 - AWS Systems Manager

aws:branch - 조건부 자동화 단계 실행

aws:branch 작업을 통해 한 단계에서 여러 선택 항목을 평가한 다음 평가 결과에 따라 실행서의 다른 단계로 이동하는 동적 자동화를 생성할 수 있습니다.

단계에 대한 aws:branch 작업을 지정할 경우 해당 자동화에서 평가해야 하는 Choices를 지정할 수 있습니다. Choices는 실행서의 Parameters 섹션에 지정한 값이나 이전 단계의 출력으로 생성된 동적 값에 기초할 수 있습니다. 이 자동화는 부울 식을 사용하여 각 선택을 평가합니다. 첫 번째 선택 항목이 true이면 이 자동화는 해당 선택 항목에 지정된 단계로 이동합니다. 첫 번째 선택 항목이 false이면 이 자동화는 다음 선택 항목을 평가합니다. 이 자동화는 true 선택 항목을 처리할 때까지 각 선택 항목을 계속 평가합니다. 그런 다음 이 자동화는 true인 선택 항목에 지정된 단계로 이동합니다.

값이 true인 선택 항목이 없을 경우 이 자동화는 단계에 default 값이 포함되었는지 검사합니다. default 값은 선택 항목 중에 true인 항목이 없는 경우 자동화에서 이동해야 하는 단계를 정의합니다. 단계에 대한 default 값이 지정되지 않은 경우 자동화는 실행서의 다음 단계를 처리합니다.

aws:branch 작업은 And, NotOr 연산자의 조합을 사용한 복합 선택 항목 평가를 지원합니다. 예제 실행서와 다양한 연산자를 사용하는 예제 등 aws:branch를 사용하는 방법에 대한 자세한 내용은 런북에서 조건문 사용 섹션을 참조하세요.

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

자동화에서 처리할 다음 단계를 결정할 때 평가해야 하는 하나 이상의 표현식입니다. Choices는 부울 식을 사용하여 평가됩니다. 각 선택 항목은 다음 옵션을 정의해야 합니다.

  • NextStep: 지정된 선택 항목이 true인 경우 처리할 실행서의 다음 단계.

  • Variable: 실행서의 Parameters 섹션에 정의된 파라미터의 이름을 지정합니다. 또는 실행서의 이전 단계에서 얻은 출력 객체를 지정합니다. aws:branch용 변수 생성에 대한 자세한 내용은 출력 변수 생성 정보 섹션을 참조하세요.

  • Operation: 선택 항목(choice)을 평가하는 데 사용되는 기준입니다. aws:branch 작업에서는 다음 연산을 지원합니다.

    문자열 연산
    • StringEquals

    • EqualsIgnoreCase

    • StartsWith

    • EndsWith

    • 포함

    수치 연산
    • NumericEquals

    • NumericGreater

    • NumericLesser

    • NumericGreaterOrEquals

    • NumericLesser

    • NumericLesserOrEquals

    부울 연산
    • BooleanEquals

    중요

    실행서를 생성하면 시스템에서 실행서의 각 작업을 검증합니다. 작업이 지원되지 않는 경우 실행서를 생성할 때 오류가 발생합니다.

기본값

Choices 중에 true인 항목이 없는 경우 자동화에서 이동해야 할 단계의 이름입니다.

유형: 문자열

필수 항목 여부: 아니요

참고

aws:branch 작업은 And, OrNot 연산자를 지원합니다. 연산자를 사용하는 aws:branch의 예는 런북에서 조건문 사용 섹션을 참조하세요.