# CloudFormation 템플릿 Metadata 구문
<a name="metadata-section-structure"></a>

`Metadata`는 JSON 또는 YAML 객체를 사용하여 추가 정보를 저장합니다. 템플릿에서 사용할 수 있는 템플릿 수준 메타데이터 유형은 다음과 같습니다.

사용자 지정 메타데이터  
사용자 정의 키-값 페어를 저장합니다. 예를 들어 리소스 생성에는 영향을 미치지 않지만 인프라, 팀 또는 배포 세부 사항에 대한 추가 컨텍스트를 제시하는 추가 정보를 제공할 수 있습니다.

`AWS::CloudFormation::Interface`  
CloudFormation 콘솔에 표시되는 입력 파라미터의 그룹화 및 순서를 정의합니다. 기본적으로 CloudFormation 콘솔에는 파라미터가 논리적 ID에 따라 영문자순으로 정렬됩니다.

`AWS::CloudFormation::Designer`  
CloudFormation Designer(Designer)는 2025년 2월 5일 수명이 종료되었습니다.



**중요**  
스택 업데이트 중에는 `Metadata` 섹션을 자체적으로 업데이트할 수 없습니다. 리소스를 추가, 수정 또는 삭제하는 변경 내용을 포함할 때만 업데이트할 수 있습니다.  
CloudFormation은 `Metadata` 섹션에 포함된 정보를 변환, 수정 또는 삭제하지 않습니다. 이러한 이유 때문에 이 섹션을 사용하여 암호나 보안 암호와 같은 민감한 정보를 저장하지 않는 것이 좋습니다.

## 구문
<a name="metadata-section-structure-syntax"></a>

CloudFormation 템플릿에서 사용자 지정 메타데이터를 선언하려면 다음 구문을 사용합니다.

### JSON
<a name="metadata-section-structure-syntax.json"></a>

```
"Metadata" : {
  "Instances" : {"Description" : "Information about the instances"},
  "Databases" : {"Description" : "Information about the databases"}
}
```

### YAML
<a name="metadata-section-structure-syntax.yaml"></a>

```
Metadata:
  Instances:
    Description: "Information about the instances"
  Databases: 
    Description: "Information about the databases"
```

`AWS::CloudFormation::Interface`에 대한 구문은 [`AWS::CloudFormation::Interface` 메타데이터를 사용하여 CloudFormation 파라미터 구성](aws-cloudformation-interface.md) 섹션을 참조하세요.