Fn::ForEach - AWS CloudFormation
선언 파라미터반환 값지원되는 함수예시

새로운 AWS CloudFormation 템플릿 참조 안내서입니다. 북마크와 링크를 업데이트하세요. CloudFormation을 시작하는 데 도움이 필요한 경우 AWS CloudFormation 사용 설명서를 참조하세요.

Fn::ForEach

Fn::ForEach 내장 함수는 컬렉션과 조각을 가져와서 컬렉션의 항목을 제공된 조각의 식별자에 적용합니다. Fn::ForEach는 Fn::ForEach를 비롯한 다른 내장 함수를 포함할 수 있으며, Conditions, Outputs, Resources(리소스 속성 포함) 섹션 내에서 사용될 수 있습니다. AWSTemplateFormatVersion, Description, Metadata, Transform, Parameters, Mappings, Rules 또는 Hooks 섹션에서는 사용할 수 없습니다.

템플릿에서 Fn::ForEach 내장 함수를 사용하는 경우 AWS::LanguageExtensions 변환도 사용해야 합니다.

Fn::ForEach 내장 함수를 사용해도 결과 템플릿에 적용되는 할당량은 변경되지 않습니다. 할당량에는 템플릿의 최대 크기와 템플릿의 최대 리소스 수가 포함됩니다. 자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 할당량 이해 섹션을 참조하세요.

선언

JSON

"Fn::ForEach::LoopLogicalName": [
  "Identifier",
  ["Value1","Value2"], // Collection
  {"OutputKey": {OutputValue}}
]

YAML

'Fn::ForEach::LoopLogicalName':
    - Identifier
    - - Value1 # Collection
      - Value2
    - 'OutputKey':
        OutputValue

파라미터

루프 논리명

루프의 논리적 ID입니다. 이름은 템플릿 내에서 고유해야 하며 템플릿의 Resources 섹션에 있는 논리적 ID 값과 충돌해서는 안 됩니다. 이 이름은 변환된 출력에 없습니다. CloudFormation 템플릿 자체 내에서 내부 참조에 사용됩니다.

식별자

OutputKey 및 OutputValue 파라미터에서 대체되는 자리 표시자의 식별자입니다. OutputKey 및 OutputValue 파라미터에서 ${Identifier} 또는 &{Identifier}의 모든 인스턴스는 Collection 파라미터의 값으로 대체됩니다.

수집

반복할 값 컬렉션입니다. 이 파라미터의 배열일 수도 있고 Ref~CommaDelimitedList일 수도 있습니다. &{Identifier}를 사용하는 경우 Collection에 영숫자가 아닌 문자가 전달될 수 있습니다.

출력 키

변환된 템플릿의 키입니다. ${Identifier} 또는 &{Identifier}는 OutputKey 파라미터에 포함되어야 합니다. 예를 들어 Fn::ForEach가 템플릿의 Resources 섹션에서 사용되는 경우 각 리소스의 논리적 ID입니다.

&{} 구문을 사용하면 OutputKey 파라미터에서 사용할 Collection에 영숫자가 아닌 문자를 사용할 수 있습니다. 예제는 Fn::ForEach의 Collection 내에서 영숫자가 아닌 문자 전달의 내용을 참조하세요.

출력 값입니다.

Collection 파라미터의 각 항목에 대해 변환된 템플릿에 복제되는 값입니다. 예를 들어 Fn::ForEach가 템플릿의 Resources 섹션에서 사용되는 경우 각 리소스를 구성하기 위해 반복되는 템플릿 조각입니다.

반환 값

컬렉션의 각 항목에 대해 한 번씩 반복되는 개체 조각이 포함된 확장 개체이며, 조각의 식별자는 컬렉션의 항목으로 대체됩니다.

지원되는 함수

Fn::ForEach 내에서 다음과 같은 함수를 사용할 수 있습니다.

예시

예시에서 Conditions, Outputs 및 Resources 섹션의 예를 찾을 수 있습니다.