새로운 *CloudFormation 템플릿 참조 안내서*입니다. 북마크와 링크를 업데이트하세요. CloudFormation을 시작하는 데 도움이 필요한 경우 [AWS CloudFormation 사용 설명서](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)를 참조하세요.

# `Fn::Transform`
<a name="intrinsic-function-reference-transform"></a>

내장 함수 `Fn::Transform`은 스택 템플릿의 일부분인 사용자 지정 처리를 수행하는 매크로를 지정합니다. 매크로를 통해 찾기 및 바꾸기 작업 같은 간단한 작업부터 전체 템플릿 변형과 같은 작업까지 템플릿에 대한 사용자 지정 처리를 수행할 수 있습니다. 자세한 내용은 *AWS CloudFormation 사용 설명서*의 [템플릿 매크로를 사용하여 CloudFormation 템플릿에서 사용자 지정 처리 수행](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html)을 참조하세요.

또한 `Fn::Transform`을 사용하여 CloudFormation에서 호스팅된 매크로인 [`AWS::Include` 변환](transform-aws-include.md) 변형을 호출할 수 있습니다.

## 선언
<a name="intrinsic-function-reference-transform-declaration"></a>

### JSON
<a name="intrinsic-function-reference-transform-syntax.json"></a>

전체 함수 이름의 구문:

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

짧은 형식의 구문:

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

### YAML
<a name="intrinsic-function-reference-transform-syntax.yaml"></a>

전체 함수 이름의 구문:

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

짧은 형식의 구문:

```
!Transform
  Name: macro name
  Parameters:
    Key: value
```

## 파라미터
<a name="intrinsic-function-reference-transform-parameters"></a>

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

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

## 반환 값
<a name="intrinsic-function-reference-transform-returnvalue"></a>

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

## 예제
<a name="intrinsic-function-reference-transform-examples"></a>

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

### JSON
<a name="intrinsic-function-reference-transform-example-1.json"></a>

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

### YAML
<a name="intrinsic-function-reference-transform-example-1.yaml"></a>

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

## 지원되는 함수
<a name="intrinsic-function-reference-transform-supported-functions"></a>

없음.

CloudFormation에서는 `Fn::Transform`에 포함된 모든 내장 함수를 리터럴 문자열로 지정된 매크로에 전달합니다.