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

# cfn-get-metadata
<a name="cfn-get-metadata"></a>

`cfn-get-metadata` 헬퍼 스크립트를 사용하여 CloudFormation에서 메타데이터 블록을 가져와 표준 출력으로 인쇄할 수 있습니다. 또한 키를 지정하는 경우 메타데이터 블록의 하위 트리를 인쇄할 수도 있습니다. 그러나 최상위 키만 지원됩니다.

**Topics**
+ [구문](#cfn-get-metadata-Syntax)
+ [옵션](#cfn-get-metadata-options)

## 구문
<a name="cfn-get-metadata-Syntax"></a>

```
cfn-get-metadata --access-key {{access.key}} \
                 --secret-key {{secret.key}} \
                 --credential-file|f {{credential.file}} \
                 --key|k {{key}} \
                 --stack|-s {{stack.name.or.id}} \
                 --resource|-r {{logical.resource.id}} \
                 --role {{IAM.role.name}} \
                 --url|-u {{service.url}} \
                 --region {{region}}
```

**참고**  
`cfn-get-metadata`에는 자격 증명이 필요 없기 때문에 `--access-key`, `--secret-key`, `--role` 또는 `--credential-file` 옵션을 사용할 필요가 없습니다. 그러나 자격 증명을 지정하지 않으면 CloudFormation이 스택 멤버십을 확인하고 해당 인스턴스가 속한 스택에 대한 호출 범위를 제한합니다. 자세한 내용은 [헬퍼 스크립트에 대한 권한](cfn-helper-scripts-reference.md#cfn-helper-scripts-reference-permissions) 섹션을 참조하세요.

## 옵션
<a name="cfn-get-metadata-options"></a>


| 명칭 | 설명 | 필수 | 
| --- | --- | --- | 
|  `-k, --key`  | 키-값 페어의 경우 지정한 값에 대한 키의 이름을 반환합니다.<br />*유형*: 문자열<br />*예*: `{ "Key1": "SampleKey1", "Key2": "SampleKey2" }`의 경우 `cfn-get-metadata -k Key2`에서는 `SampleKey2`를 반환합니다. | 아니요 | 
|  `-s, --stack`  | 스택의 이름입니다.<br />*유형*: 문자열<br />*기본값*: 없음<br />*예*: `-s { "Ref" : "AWS::StackName" },` | 예 | 
|  `-r, --resource`  | 메타데이터가 포함된 리소스의 논리적 리소스 ID입니다.<br />*유형*: 문자열<br />*예*: `-r WebServerHost` | 예 | 
| `--role`(리소스 신호 전송에만 해당) | 인스턴스와 연결되는 IAM 역할의 이름입니다.<br />*유형*: 문자열<br />조건: 자격 증명 파일 파라미터가 이 파라미터를 대신합니다. | 아니요 | 
|  `--region`  | CloudFormation URL이 파생되는 리전입니다.<br />*유형*: 문자열<br />*기본값*: 없음<br />*예*: `--region ", { "Ref" : "AWS::Region" },` | 아니요 | 
|  `--access-key`  | CloudFormation에서 DescribeStackResource를 호출할 권한이 있는 계정의 AWS 액세스 키입니다.<br />*유형*: 문자열<br />조건: 자격 증명 파일 파라미터가 이 파라미터를 대신합니다. | 조건 | 
|  `--secret-key`  | 지정된 AWS 액세스 키에 해당하는 AWS 보안 키입니다.<br />*유형*: 문자열<br />조건: 자격 증명 파일 파라미터가 이 파라미터를 대신합니다. | 조건 | 
|  `-f, --credential-file`  | 보안 키 및 액세스 키가 둘 다 포함된 파일입니다.<br />*유형*: 문자열<br />조건: 자격 증명 파일 파라미터가 --access-key 및 --secret-key 파라미터를 대신합니다. | 조건 |