Fn::Join - AWS CloudFormation

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Fn::Join

透過 Fn::Join 內部函數,即可將一組值附加至單一值,並以指定的分隔符號隔開。如果分隔符號是空白字串,系統即會串連這一組值,而不使用分隔符號。

宣告

JSON

{ "Fn::Join" : [ "delimiter", [ comma-delimited list of values ] ] }

YAML

完整函式名稱的語法:

Fn::Join: [ delimiter, [ comma-delimited list of values ] ]

短格式的語法:

!Join [ delimiter, [ comma-delimited list of values ] ]

參數

分隔符號

要在片段之間執行的值。分隔符號僅會出現在片段之間,且不會終止最後的值。

ListOfValues

要合併的數值清單。

傳回值

合併的字串。

範例

聯結簡單的字串陣列

以下範例傳回:"a:b:c"

JSON

"Fn::Join" : [ ":", [ "a", "b", "c" ] ]

YAML

!Join [ ":", [ a, b, c ] ]

使用搭配參數的 Ref 函數進行聯結

以下範例會使用 Fn::Join 來建構字串值,且將搭配 Ref 函數、AWS::Partition 參數和 AWS::AccountId 虛擬參數一起使用。

JSON

{ "Fn::Join": [ "", [ "arn:", { "Ref": "AWS::Partition" }, ":s3:::elasticbeanstalk-*-", { "Ref": "AWS::AccountId" } ] ] }

YAML

!Join - '' - - 'arn:' - !Ref AWS::Partition - ':s3:::elasticbeanstalk-*-' - !Ref AWS::AccountId
注意

如需了解類似功能,另請參閱 Fn::Sub 函數。

支援的函數

對於 Fn::Join 分隔符號,您不能使用任何函數。您必須指定一個字串值。

對於值的 Fn::Join 清單,您可以使用下列函數:

  • Fn::Base64

  • Fn::FindInMap

  • Fn::GetAtt

  • Fn::GetAZs

  • Fn::If

  • Fn::ImportValue

  • Fn::Join

  • Fn::Split

  • Fn::Select

  • Fn::Sub

  • Ref