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