Como uso a função Fn::Sub no AWS CloudFormation com Fn::FindInMap, Fn::ImportValue ou outras funções suportadas?

2 minuto de leitura
0

Quero usar a função intrínseca Fn::Sub no AWS CloudFormation com Fn::FindInMap, Fn::ImportValue ou outras funções suportadas.

Breve descrição

Você pode usar a função intrínseca Fn::Sub para substituir funções suportadas ou para substituir variáveis em uma string de entrada por valores que você especifica.

Para substituir o valor das funções suportadas, você deve usar o mapa de variáveis com o nome e o valor, conforme mostrado abaixo:

JSON:

{ "Fn::Sub" : [ String, { Var1Name: Var1Value, Var2Name: Var2Value } ] }

YAML:

!Sub
  - String
  - Var1Name: Var1Value
    Var2Name: Var2Value

Resolução

Uso de Fn::Sub com a função Ref

O exemplo a seguir usa um mapeamento para substituir a variável Domínio pelo valor resultante da função Ref.

JSON:

{
  "Parameters": {
    "RootDomainName": {
      "Type": "String",
      "Default": "example123.com"
    }
  },
  "Resources": {
    "DNS": {
      "Type": "AWS::Route53::HostedZone",
      "Properties": {
        "Name": {
          "Fn::Sub": [
            "www.${Domain}",
            {
              "Domain": {
                "Ref": "RootDomainName"
              }
            }
          ]
        }
      }
    }
  }
}

YAML:

Parameters:
  RootDomainName:
    Type: String
    Default: example123.com
Resources:
  DNS:
    Type: 'AWS::Route53::HostedZone'
    Properties:
      Name: !Sub
        - 'www.${Domain}'
        - Domain: !Ref RootDomainName

Uso de Fn::Sub com a função Fn::FindInMap

O exemplo a seguir usa um mapeamento para substituir a variável log_group_name pelo valor resultante da função Fn::FindInMap.

JSON:

{
  "Mappings": {
    "LogGroupMapping": {
      "Test": {
        "Name": "test_log_group"
      },
      "Prod": {
        "Name": "prod_log_group"
      }
    }
  },
  "Resources": {
    "myLogGroup": {
      "Type": "AWS::Logs::LogGroup",
      "Properties": {
        "LogGroupName": {
          "Fn::Sub": [
            "cloud_watch_${log_group_name}",
            {
              "log_group_name": {
                "Fn::FindInMap": [
                  "LogGroupMapping",
                  "Test",
                  "Name"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

YAML:

Mappings:
  LogGroupMapping:
    Test:
      Name: test_log_group
    Prod:
      Name: prod_log_group
Resources:
  myLogGroup:
    Type: 'AWS::Logs::LogGroup'
    Properties:
      LogGroupName: !Sub
        - 'cloud_watch_${log_group_name}'
        - log_group_name: !FindInMap
            - LogGroupMapping
            - Test
            - Name

Uso de Fn::Sub com a função Fn::ImportValue

O exemplo a seguir usa um mapeamento para substituir a variável Domínio pelo valor resultante da função Fn::ImportValue.

Observação: “DomainName” é o nome da Saída exportada por outra pilha do CloudFormation.

JSON:

{
  "Resources": {
    "DNS": {
      "Type": "AWS::Route53::HostedZone",
      "Properties": {
        "Name": {
          "Fn::Sub": [
            "www.${Domain}",
            {
              "Domain": {
                "Fn::ImportValue": "DomainName"
              }
            }
          ]
        }
      }
    }
  }
}

YAML:

Resources:
  DNS:
    Type: 'AWS::Route53::HostedZone'
    Properties:
      Name: !Sub
        - 'www.${Domain}'
        - Domain: !ImportValue DomainName

AWS OFICIAL
AWS OFICIALAtualizada há 2 anos