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.
# Referensi jenis properti bersama
Bagian ini berisi informasi referensi terperinci untuk jenis properti yang CloudFormation mendukung untuk digunakan dalam beberapa jenis sumber daya.
**Topics**
+ [CloudFormation penamaan kustom sumber daya](aws-properties-name.md)
+ [CloudFormation penandaan sumber daya](aws-properties-resource-tags.md)
# CloudFormation penamaan kustom sumber daya
Anda dapat menetapkan nama kustom untuk jenis sumber daya yang didukung dalam CloudFormation template Anda untuk membuatnya lebih bermakna dan mudah diidentifikasi. Secara default, CloudFormation menghasilkan ID fisik unik untuk memberi nama sumber daya. Misalnya, CloudFormation beri nama bucket Amazon S3 dengan ID fisik berikut. `MyStack-MyBucket-abcdefghijk1` Dengan nama kustom, Anda dapat menentukan nama yang lebih mudah dibaca dan diidentifikasi, seperti `production-app-logs` atau `business-metrics`.
Tidak semua sumber daya mendukung nama khusus. Setiap AWS layanan secara independen menentukan jenis sumber daya mana yang mendukung nama kustom.
Nama sumber daya harus bersifat unik di semua tumpukan aktif Anda. Jika Anda menggunakan kembali templat untuk membuat beberapa tumpukan, Anda harus mengubah atau menghapus nama kustom dari templat Anda. Jika Anda tidak menentukan nama, buat CloudFormation ID fisik unik untuk memberi nama sumber daya. Pengidentifikasi harus dimulai dengan huruf, hanya boleh berisi huruf ASCII, angka, dan tanda hubung; dan tidak diakhiri dengan tanda hubung atau berisi dua tanda hubung berturut-turut.
Juga, jangan mengelola sumber daya tumpukan di luar CloudFormation. Misalnya, jika Anda mengganti nama sumber daya yang merupakan bagian dari tumpukan tanpa menggunakan CloudFormation, Anda mungkin mendapatkan kesalahan setiap kali Anda mencoba memperbarui atau menghapus tumpukan itu.
**penting**
Anda tidak dapat melakukan pembaruan yang menyebabkan sumber daya bernama kustom diganti. Jika Anda harus mengganti sumber daya, tentukan nama baru.
## Contoh
Jika Anda ingin menggunakan nama kustom, tentukan properti nama untuk sumber daya tersebut di templat CloudFormation . Setiap sumber daya yang mendukung nama kustom memiliki properti sendiri yang Anda tentukan. Misalnya, untuk memberi nama tabel DynamoDB, Anda menggunakan properti, seperti `TableName` yang ditunjukkan pada contoh berikut:
### JSON
```
"myDynamoDBTable" : {
"Type" : "AWS::DynamoDB::Table",
"Properties" : {
"KeySchema" : {
"HashKeyElement": {
"AttributeName" : "AttributeName1",
"AttributeType" : "S"
},
"RangeKeyElement" : {
"AttributeName" : "AttributeName2",
"AttributeType" : "N"
}
},
"ProvisionedThroughput" : {
"ReadCapacityUnits" : "5",
"WriteCapacityUnits" : "10"
},
"TableName" : "SampleTable"
}
}
```
### YAML
```
myDynamoDBTable:
Type: AWS::DynamoDB::Table
Properties:
KeySchema:
HashKeyElement:
AttributeName: "AttributeName1"
AttributeType: "S"
RangeKeyElement:
AttributeName: "AttributeName2"
AttributeType: "N"
ProvisionedThroughput:
ReadCapacityUnits: "5"
WriteCapacityUnits: "10"
TableName: "SampleTable"
```
# CloudFormation penandaan sumber daya
Anda dapat menerapkan tag ke sumber daya dengan menggunakan `Tags` properti di CloudFormation template Anda, yang dapat membantu Anda mengidentifikasi dan mengkategorikan sumber daya tersebut.
Untuk informasi tentang sumber daya yang mendukung `Tags` properti, lihat sumber daya individu dalam [referensi jenis AWS sumber daya dan properti](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html). Jika sumber daya belum mendukung `Tags` properti, layanan sumber daya mungkin mendukung penandaan menggunakan operasi API-nya sendiri. Untuk informasi lebih lanjut, lihat dokumentasi untuk layanan tersebut.
Selain tag apa pun yang Anda tentukan, CloudFormation secara otomatis membuat tag tingkat tumpukan berikut dengan awalan: `aws:`
+ `aws:cloudformation:logical-id`
+ `aws:cloudformation:stack-id`
+ `aws:cloudformation:stack-name`
`aws:`Awalan dicadangkan untuk AWS digunakan. Prefiks ini tidak peka terhadap huruf besar/kecil. Jika Anda menggunakan prefiks ini di properti `Key` atau `Value`, Anda tidak dapat memperbarui atau menghapus tanda. Tanda dengan prefiks ini tidak dihitung terhadap jumlah tanda per sumber daya.
Penyebaran tag tingkat tumpukan ke sumber daya, termasuk tag dengan `aws:` awalan, bervariasi menurut jenis sumber daya. Misalnya, tag tidak disebarkan ke volume Amazon EBS yang dibuat dari pemetaan perangkat blok.
**catatan**
Beberapa sumber daya memerlukan pengaturan propagasi tag eksplisit. Misalnya, `AWS::AutoScaling::AutoScalingGroup` sumber daya harus memiliki `PropagateAtLaunch` propertinya yang disetel untuk menyebarkan tag `true` ke instans EC2-nya. Namun, tag tingkat tumpukan secara otomatis diterapkan ke instans EC2 terlepas dari pengaturannya. `PropagateAtLaunch`
## Sintaksis
### JSON
```
{
"Key" : String,
"Value" : String
}
```
### YAML
```
Key: String
Value: String
```
## Sifat-sifat
`Key`
Nama kunci dari tanda. Anda dapat menentukan nilai yang terdiri dari 1 hingga 128 karakter Unicode dan tidak boleh diawali dengan `aws:`. Anda dapat menggunakan salah satu karakter berikut: kumpulan huruf Unicode, digit, spasi putih,,,,,,`_`,`.`,`:`, `/` `=``+`, `@` dan. `-` `"`
*Wajib*: Ya
*Tipe*: String
`Value`
Nilai untuk tanda. Anda dapat menentukan nilai dengan panjang 1 hingga 256 karakter. Anda dapat menggunakan salah satu karakter berikut: set huruf Unicode, angka, spasi putih, `_`, `.`, `/`, `=`, `+`, dan `-`.
*Wajib*: Ya
*Tipe*: String
## Contoh
Contoh ini menunjukkan properti `Tags`. Anda menentukan properti ini dalam bagian `Properties` dari sumber daya yang mendukungnya. Saat sumber daya dibuat, `Environment` tag disetel secara dinamis menggunakan parameter, dan `Owner` tag diatur secara statis ke. `MyName`
### JSON
```
1. "Tags" : [
2. {
3. "Key" : "Environment",
4. "Value" : { "Ref": "Environment" }
5. },
6. {
7. "Key" : "Owner",
8. "Value" : "MyName"
9. }
10. ]
```
### YAML
```
1. Tags:
2. - Key: Environment
3. Value: !Ref Environment
4. - Key: Owner
5. Value: MyName
```
## Lihat juga
+ [Konfigurasikan opsi tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html#configure-stack-options) di *Panduan AWS CloudFormation Pengguna*
+ [Melihat data CloudFormation tumpukan dan sumber daya Konsol Manajemen AWS di](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html) *Panduan AWS CloudFormation Pengguna*