View a markdown version of this page

Fn::FindInMap enhancements - AWS CloudFormation
선언파라미터예제지원되는 함수관련 리소스

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

Fn::FindInMap enhancements

AWS::LanguageExtensions 변환은 CloudFormation 템플릿의 Fn::FindInMap 내장 함수 기능을 향상시킵니다.

표준 Fn::FindInMap 함수는 Fn::FindInMap 및 Ref만 중첩 내장 함수로 지원합니다. AWS::LanguageExtensions 변환은 이 제한을 제거함으로써 더 광범위한 내장 함수를 사용하여 Fn::FindInMap의 파라미터를 정의하도록 합니다.

참고

Fn::FindInMap의 DefaultValue 파라미터에는 더 이상 AWS::LanguageExtensions 변환이 필요하지 않습니다. 모든 CloudFormation 템플릿에서 DefaultValue을(를) 사용할 수 있습니다. 자세한 내용은 Fn::FindInMap 섹션을 참조하세요.

선언

JSON

{ "Fn::FindInMap" : [ "MapName", "TopLevelKey", "SecondLevelKey"] }

매핑에서 키를 찾을 수 없을 때 폴백 값을 지정하려면 DefaultValue을(를) 포함합니다.

{ "Fn::FindInMap" : [ "MapName", "TopLevelKey", "SecondLevelKey", {"DefaultValue": "DefaultValue"}] }

YAML

전체 함수 이름의 구문:

Fn::FindInMap: [ MapName, TopLevelKey, SecondLevelKey ]

짧은 형식의 구문:

!FindInMap [ MapName, TopLevelKey, SecondLevelKey ]

매핑에서 키를 찾을 수 없을 때 폴백 값을 지정하려면 DefaultValue을(를) 포함합니다.

전체 함수 이름의 구문:

Fn::FindInMap:
  - MapName
  - TopLevelKey
  - SecondLevelKey
  - DefaultValue: DefaultValue

짧은 형식의 구문:

!FindInMap
  - MapName
  - TopLevelKey
  - SecondLevelKey
  - DefaultValue: DefaultValue

파라미터

AWS::LanguageExtensions 변환에서는 MapName, TopLevelKey, SecondLevelKey, DefaultValue 매개변수가 각각 내장 함수일 수 있습니다. 단, 변환 중 유효한 값으로 확인되어야 합니다.

예제

다음 예제에서는 AWS::LanguageExtensions 변환을 추가할 때 Fn::FindInMap의 파라미터에서 내장 함수를 사용하는 방법을 보여줍니다.

내장 함수를 사용하여 최상위 키 정의

다음은 Fn::Select 및 Fn::Split 내장 함수가 포함된 Fn::FindInMap 함수를 사용하여 최상위 키를 정의하는 예제입니다.

JSON

{
  //...
  "Transform": "AWS::LanguageExtensions",
  //...
      "Fn::FindInMap": [
        "MyMap",
        {
          "Fn::Select": [
            0,
            {
              "Fn::Split": [
                "|",
                { "Ref": "InputKeys" }
              ]
            }
          ]
        },
        "SecondKey"
      ]
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
    !FindInMap: [MyMap, !Select [0, !Split [|, !Ref InputKeys]], SecondKey]
#...

지원되는 함수

AWS::LanguageExtensions 변환이 포함된 Fn::FindInMap의 파라미터에서 다음 함수를 사용할 수 있습니다.

관련 리소스

DefaultValue 매개변수를 포함하여 Fn::FindInMap 내장 함수 사용 방법에 대한 자세한 내용과 예제는 Fn::FindInMap 단원을 참조하세요.

AWS::LanguageExtensions 변환에 대한 자세한 내용은 AWS::LanguageExtensions 변환 섹션을 참조하세요.