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

# `Metadata` 属性
<a name="aws-attribute-metadata"></a>

リソースには、`Metadata` 属性を使用して構造化データを関連付けることができます。リソースに `Metadata` 属性を追加することで、JSON または YAML 形式のデータをリソースの宣言に追加することができます。また、`Metadata` 属性内で組み込み関数 ([`Fn::GetAtt`](intrinsic-function-reference-getatt.md)、[`Ref`](intrinsic-function-reference-ref.md) など) パラメータや擬似パラメータを使用し、これらの解釈された値を追加することもできます。

**注記**  
CloudFormation は、Metadata 属性内の構文を検証しません。

**重要**  
CloudFormation は、Metadata 属性に含められた情報の編集や難読化を行いません。このセクションを使用してパスワードやシークレットなどの機密情報を保存しないことを強くお勧めします。

このデータは、[describe-stack-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-resource.html) CLI コマンドまたは [DescribeStackResource](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackResource.html) API オペレーションを使用して取得できます。

## 例
<a name="aws-attribute-metadata-example"></a>

次のテンプレートでは、Amazon S3 バケットリソースに `Metadata` 属性が使用されています。

### JSON
<a name="aws-attribute-metadata-example.json"></a>

```
{
   "AWSTemplateFormatVersion" : "2010-09-09",
   "Resources" : {
      "MyBucket" : {
         "Type" : "AWS::S3::Bucket",
         "Metadata" : { 
            "Object1" : "Location1",
            "Object2" : "Location2" 
         }
      }
   }
}
```

### YAML
<a name="aws-attribute-metadata-example.yaml"></a>

```
1. AWSTemplateFormatVersion: '2010-09-09'
2. Resources:
3.   MyBucket:
4.     Type: AWS::S3::Bucket
5.     Metadata:
6.       Object1: Location1
7.       Object2: Location2
```