Fn::Transform - 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 AWS CloudFormation para realizar processamento personalizado em modelos.

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}}

O exemplo a seguir chama a transformação AWS::Include, especificando que o local de onde recuperar um trecho de modelo está localizado no mapeamento RegionMap, sob a chave us-east-1 e a chave aninhada s3Location.

JSON

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

YAML

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

Funções compatíveis

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