새로운 *CloudFormation 템플릿 참조 안내서*입니다. 북마크와 링크를 업데이트하세요. CloudFormation을 시작하는 데 도움이 필요한 경우 [AWS CloudFormation 사용 설명서](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)를 참조하세요.

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

`Fn::ToJsonString` 내장 함수는 객체 또는 배열을 해당 JSON 문자열로 변환합니다.

**중요**  
`Fn::ToJsonString` 내장 함수를 사용하려면 [`AWS::LanguageExtensions` 변환](transform-aws-languageextensions.md)를 사용해야 합니다.

## 선언
<a name="tojsonstring-declaration"></a>

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

```
{ "Fn::ToJsonString": Object }
```

```
{ "Fn::ToJsonString": Array }
```

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

```
Fn::ToJsonString: Object
```

```
Fn::ToJsonString: Array
```

## 파라미터
<a name="tojsonstring-parameters"></a>

`Object`  
JSON 문자열로 변환할 객체입니다.

`Array`  
JSON 문자열로 변환할 배열입니다.

## 반환 값
<a name="intrinsic-function-reference-tojsonstring-return"></a>

JSON 문자열로 변환된 객체 또는 배열입니다.

## 예제
<a name="intrinsic-function-reference-tojsonstring-examples"></a>

### 객체를 JSON 문자열로 변환
<a name="intrinsic-function-reference-tojsonstring-example-subsection"></a>

이 예제 코드 조각은 내장 함수로 전달된 객체를 JSON 문자열로 변환합니다.

#### JSON
<a name="intrinsic-function-reference-tojsonstring-example.json"></a>

```
{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::ToJsonString": {
            "key1": "value1",
            "key2": { 
                "Ref": "ParameterName"
            }
        }
//...
}
```

#### YAML
<a name="intrinsic-function-reference-tojsonstring-example.yaml"></a>

```
Transform: 'AWS::LanguageExtensions'
#...
  Fn::ToJsonString: 
    key1: value1
    key2: !Ref ParameterName
#...
```

두 예제 모두에서 `ParameterName`에 대한 `Ref`가 `resolvedValue`로 확인되면 함수는 다음 JSON 문자열을 확인합니다.

```
"{\"key1\":\"value1\",\"key2\":\"resolvedValue\"}"
```

### 배열을 JSON 문자열로 변환
<a name="intrinsic-function-reference-tojsonstring-example2"></a>

이 예제 코드 조각은 내장 함수로 전달된 배열을 JSON 문자열로 변환합니다.

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

```
{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::ToJsonString": [{
            "key1": "value1",
            "key2": { 
                "Ref": "ParameterName" 
            }
        }]
//...
}
```

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

```
Transform: 'AWS::LanguageExtensions'
#...
  Fn::ToJsonString: 
    - key1: value1
      key2: !Ref ParameterName
#...
```

두 예제 모두에서 `ParameterName`에 대한 `Ref`가 `resolvedValue`로 확인되면 함수는 다음 JSON 문자열을 확인합니다.

```
"[{\"key1\":\"value1\"},{\"key2\":\"resolvedValue\"}]"
```

## 지원되는 함수
<a name="tojsonstring-supported-functions"></a>

`Fn::ToJsonString` 내장 함수 또는 배열에서 다음 함수를 사용할 수 있습니다.
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::GetAtt`
+ `Fn::GetAZs`
+ `Fn::If`
+ `Fn::ImportValue`
+ `Fn::Join`
+ `Fn::Length`
+ `Fn::Select`
+ `Fn::Split`
+ `Fn::Sub`
+ `Fn::ToJsonString`
+ `Ref`