如何在具有 Fn::FindinMap、Fn::ImportValue 或其他支援函數的 AWS CloudFormation 中使用 Fn::Sub 函數？

簡短說明

您可以使用 Fn:: Sub 內嵌函數替換支援函數，或以您指定的值替換輸入字串中的變數。

若要替換支援函數的值，必須使用對映名稱和值的變數，如下所示：

JSON：

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

YAML：

!Sub
  - String
  - Var1Name: Var1Value
    Var2Name: Var2Value

解決方案

具有 Ref 函數的 Fn::Sub 用法

下列範例會使用對映，以 Ref 函數產生的值替換 Domain 變數。

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

具有 Fn::FindInMap 函數的 Fn::Sub 用法

下列範例會使用對映，以 ** Fn::FindInMap** 函數產生的值替換 **log_group_name ** 變數。

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

具有 Fn::ImportValue 函數的 Fn::Sub 用法

下列範例會使用對，以 Fn:: ImportValue 函數產生的值替換 Domain 變數。

注意：DomainName 是依另一個 CloudFormation 堆疊的 Output exported 名稱。

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

---