Ini adalah *Panduan Referensi CloudFormation Template* baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat [Panduan AWS CloudFormation Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Anda dapat menggunakan skrip `cfn-get-metadata` pembantu untuk mengambil blok metadata dari CloudFormation dan mencetaknya ke output standar. Anda juga dapat mencetak subpohon dari blok metadata jika Anda menentukan kunci. Namun, hanya kunci tingkat atas yang didukung.

**Topics**
+ [Sintaksis](#cfn-get-metadata-Syntax)
+ [Opsi](#cfn-get-metadata-options)

## Sintaksis
<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
```

**catatan**  
`cfn-get-metadata`tidak memerlukan kredensi, jadi Anda tidak perlu menggunakan`--access-key`,, `--secret-key``--role`, atau `--credential-file` opsi. Namun, jika tidak ada kredensial yang ditentukan, CloudFormation memeriksa keanggotaan tumpukan dan membatasi cakupan panggilan ke tumpukan tempat instans berada. Untuk informasi selengkapnya, lihat [Izin untuk skrip pembantu](cfn-helper-scripts-reference.md#cfn-helper-scripts-reference-permissions).

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


| Nama | Deskripsi | Diperlukan | 
| --- | --- | --- | 
|   `-k, --key`   |  Untuk pasangan nilai kunci, mengembalikan nama kunci untuk nilai yang Anda tentukan. *Tipe*: String *Contoh*: Untuk `{ "Key1": "SampleKey1", "Key2": "SampleKey2" }`, `cfn-get-metadata -k Key2` mengembalikan `SampleKey2`.  |  Tidak  | 
|   `-s, --stack`   |  Nama Tumpukan. *Tipe*: String *Default*: Tidak Ada *Contoh*: `-s { "Ref" : "AWS::StackName" },`  |  Ya  | 
|   `-r, --resource`   |  ID sumber daya logis dari sumber daya yang berisi metadata. *Tipe*: String *Contoh*: `-r WebServerHost`  |  Ya  | 
|  `--role` (pemberian sinyal sumber daya saja)  |  Nama peran IAM yang terkait dengan instance. *Tipe*: String Syarat: Parameter file kredensial menggantikan parameter ini.  |  Tidak  | 
|   `--region`   |  Wilayah untuk mendapatkan CloudFormation URL dari. *Tipe*: String *Default*: Tidak Ada *Contoh*: `--region ", { "Ref" : "AWS::Region" },`  |  Tidak  | 
|   `--access-key`   |  AWS Kunci Akses untuk akun dengan izin untuk DescribeStackResource menelepon CloudFormation. *Tipe*: String Syarat: Parameter file kredensial menggantikan parameter ini.  |  Bersyarat  | 
|   `--secret-key`   |  AWS Kunci Rahasia yang sesuai dengan Kunci AWS Akses yang ditentukan. *Tipe*: String Syarat: Parameter file kredensial menggantikan parameter ini.  |  Bersyarat  | 
|   `-f, --credential-file`   |  File yang berisi secret key dan access key. *Tipe*: String Syarat: Parameter file kredensial menggantikan parameter --access key dan --secret key.  |  Bersyarat  |