Fn::Transform - AWS CloudFormation

Fn::Transform

내장 함수 Fn::Transform은 스택 템플릿의 일부분인 사용자 지정 처리를 수행하는 매크로를 지정합니다. 매크로를 통해 찾기 및 바꾸기 작업 같은 간단한 작업부터 전체 템플릿 변형과 같은 작업까지 템플릿에 대한 사용자 지정 처리를 수행할 수 있습니다. 자세한 내용은 AWS CloudFormation 매크로를 사용하여 템플릿에 사용자 지정 처리 수행 섹션을 참조하세요.

또한 Fn::Transform을 사용하여 AWS CloudFormation에서 호스팅된 매크로인 AWS::Include 변환 변형을 호출할 수 있습니다.

선언

JSON

전체 함수 이름의 구문:

{ "Fn::Transform": { "Name": "macro name", "Parameters": { "Key": "value" } } }

짧은 형식의 구문:

{ "Transform": { "Name": "macro name", "Parameters": { "Key": "value" } } }

YAML

전체 함수 이름의 구문:

Fn::Transform: Name : macro name Parameters : Key : value

짧은 형식의 구문:

!Transform Name: macro name Parameters: Key: value

파라미터

이름

처리를 수행하고자 하는 매크로의 이름입니다.

파라미터

매크로에 전달하는 키-값 페어로 지정된 목록 파라미터입니다.

반환 값

처리된 스택 템플릿에 포함될 처리된 템플릿 코드 조각입니다.

예시

다음 예제에서는 AWS::Include 변형을 호출하여 템플릿 코드 조각을 검색하는 위치가 InputValue 파라미터에 전달되도록 지정합니다.

JSON

{ "Fn::Transform": { "Name": "AWS::Include", "Parameters": { "Location": { "Ref": "InputValue" } } } }

YAML

'Fn::Transform': Name: 'AWS::Include' Parameters: Location: !Ref InputValue

다음 예제에서는 AWS::Include 변형을 호출하여 템플릿 코드 조각을 검색하는 위치가 RegionMap 매핑에 위치하고, 키는 us-east-1, 중첩된 키가 s3Location에 있도록 지정합니다.

JSON

{ "Fn::Transform": { "Name": "AWS::Include", "Parameters": { "Location": { "Fn::FindInMap": [ "RegionMap", "us-east-1", "s3Location" ] } } } }

YAML

!Transform Name: AWS::Include Parameters: Location: !FindInMap - RegionMap - us-east-1 - s3Location

지원되는 함수

없음.

CloudFormation에서는 Fn::Transform에 포함된 모든 내장 함수를 리터럴 문자열로 지정된 매크로에 전달합니다. 자세한 내용은 AWS CloudFormation 매크로 함수 인터페이스 섹션을 참조하세요.