Fn::Transform

A função intrínseca Fn::Transform especifica uma macro para realizar o processamento personalizado em parte de um modelo de pilha. Macros permitem realizar o processamento personalizado em modelos, desde ações simples, como operações de localizar e substituir, até transformações extensas de modelos inteiros. Para ter mais informações, consulte Executar processamento personalizado em modelos do CloudFormation com macros de modelo.

Você também pode usar Fn::Transform para chamar a transformação Transformação AWS::Include, que é uma macro hospedado pelo AWS CloudFormation.

Declaração

JSON

Sintaxe para o nome da função completo:

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

Sintaxe para a forma resumida:

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

YAML

Sintaxe para o nome da função completo:

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

Sintaxe para a forma resumida:

!Transform
  Name: macro name
  Parameters:
    Key: value

Parâmetros

Nome

O nome da macro da qual você deseja realizar o processamento.

Parâmetros

Os parâmetros de lista, especificados como pares de chave/valor a serem transferidos para a macro.

Valor de retorno

O trecho de modelo processado a ser incluído no modelo de pilha.

Exemplos

O exemplo a seguir chama a transformação AWS::Include, especificando que o local de onde recuperar um trecho de modelo é transmitido no parâmetro InputValue.

JSON

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

YAML

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

Funções compatíveis

Nenhum.

O CloudFormation transmite qualquer chamada de função intrínseca incluída em Fn::Transform à macro especificada como strings de literal. Para ter mais informações, consulte Interface de função de macro do CloudFormation.