これは新しい CloudFormation テンプレートリファレンスガイドです。ブックマークとリンクを更新してください。CloudFormation の開始方法については、『[AWS CloudFormation ユーザーガイド](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)』を参照してください。

# `Fn::Join`
<a name="intrinsic-function-reference-join"></a>

組み込み関数 `Fn::Join` は、一連の値を特定の区切り文字で区切って 1 つの値に追加します。区切り文字が空の文字列の場合、一連の値は区切り文字を使用することなく連結されます。

## 宣言
<a name="w2aac24c48b5"></a>

### JSON
<a name="intrinsic-function-reference-join-syntax.json"></a>

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

### YAML
<a name="intrinsic-function-reference-join-syntax.yaml"></a>

完全関数名の構文:

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

短縮形の構文:

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

## パラメータ
<a name="intrinsic-function-reference-join-parameters"></a>

delimiter  
値を区切る区切り文字を指定する値。区切り文字は値の間にのみ挿入されます。これは最後の値を終了しません。

ListOfValues  
結合する値のリスト。

## 戻り値
<a name="intrinsic-function-reference-join-returnvalues"></a>

結合された文字列。

## 例
<a name="intrinsic-function-reference-join-examples"></a>

### シンプルな文字列配列を結合する
<a name="intrinsic-function-reference-join-example1"></a>

次の例は、`"a:b:c"` を返します。

#### JSON
<a name="intrinsic-function-reference-join-example1.json"></a>

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

#### YAML
<a name="intrinsic-function-reference-join-example1.yaml"></a>

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

### パラメータ付きの Ref 関数を使用した結合
<a name="intrinsic-function-reference-join-example2"></a>

次の例では、`Fn::Join` を使用して文字列値を作成しています。これは、`Ref` パラメータと `AWS::Partition` 擬似パラメータで `AWS::AccountId` 関数を使用します。

#### JSON
<a name="intrinsic-function-reference-join-example2.json"></a>

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

#### YAML
<a name="intrinsic-function-reference-join-example2.yaml"></a>

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

**注記**  
同様の機能の [`Fn::Sub`](intrinsic-function-reference-sub.md) 関数も参照してください。

## サポートされている関数
<a name="intrinsic-function-reference-join-supportedfunctions"></a>

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