Fn::Transform

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

또한 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

지원되는 함수

없음.

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