Fn::Transform - AWS CloudFormation
DeclaraçãoParâmetrosValor de retornoExemplosFunções compatíveis

Este é o novo Guia de referência de modelos do AWS CloudFormation. Atualize seus favoritos e links. Para obter ajuda para começar a usar o CloudFormation, consulte o Guia do usuário do AWS CloudFormation.

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 obter mais informações, consulte Usar macros do CloudFormation para executar processamento personalizado em modelos no Guia do usuário do AWS CloudFormation.

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

Name

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

Parameters

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.