

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.

# `CreationPolicy`atribut
<a name="aws-attribute-creationpolicy"></a>

Kaitkan `CreationPolicy` atribut dengan sumber daya untuk mencegah statusnya mencapai create complete hingga CloudFormation menerima sejumlah sinyal sukses tertentu atau periode batas waktu terlampaui. Untuk memberi sinyal sumber daya, Anda dapat menggunakan skrip [cfn-signal](cfn-signal.md) pembantu atau [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html)API. CloudFormation menerbitkan sinyal yang valid ke peristiwa tumpukan sehingga Anda melacak jumlah sinyal yang dikirim.

Kebijakan pembuatan hanya dipanggil saat CloudFormation membuat sumber daya terkait. Saat ini, satu-satunya CloudFormation sumber daya yang mendukung kebijakan pembuatan adalah:
+ [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-appstream-fleet.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-appstream-fleet.html)
+ [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html)
+ [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html)
+ [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-waitcondition.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-waitcondition.html)

Gunakan atribut `CreationPolicy` ketika Anda ingin menunggu pada tindakan konfigurasi sumber daya sebelum pembuatan tumpukan dilanjutkan. Misalnya, jika Anda menginstal dan mengkonfigurasi aplikasi perangkat lunak pada instans EC2, Anda mungkin ingin aplikasi tersebut berjalan sebelum melanjutkan. Dalam kasus tersebut, Anda dapat menambahkan atribut `CreationPolicy` ke instans, dan kemudian mengirim sinyal sukses ke instans setelah aplikasi diinstal dan dikonfigurasi. Untuk contoh mendetail, lihat [Menerapkan aplikasi di Amazon EC2 CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/deploying.applications.html) dengan di Panduan Pengguna *AWS CloudFormation .*

## WorkSpaces Kebijakan pembuatan aplikasi
<a name="aws-attribute-creation-policy-app-stream-fleet"></a>

 AppStream Konfigurasi Amazon untuk kebijakan pembuatan.

### Sintaksis
<a name="aws-attribute-creation-policy-app-stream-fleet-syntax"></a>

#### JSON
<a name="aws-attribute-creation-policy-app-stream-fleet-syntax-json"></a>

```
{
    "CreationPolicy": {
        "StartFleet": "Boolean"
    }
}
```

#### YAML
<a name="aws-attribute-creation-policy-app-stream-fleet-syntax-yaml"></a>

```
CreationPolicy:
  StartFleet: Boolean
```

`StartFleet`  <a name="cfn-attributes-updatepolicy-replacingupdate-StartFleet"></a>
Mulai armada yang ditentukan.  
*Wajib*: Tidak

## Properti pembuatan Penskalaan Otomatis Amazon EC2
<a name="w2aac19b7c13"></a>

Konfigurasi Amazon EC2 Auto Scaling untuk kebijakan pembuatan.

### Sintaksis
<a name="aws-attribute-creation-policy-app-auto-scaling-syntax"></a>

#### JSON
<a name="aws-attribute-creation-policy-app-auto-scaling-syntax.json"></a>

```
"CreationPolicy" : {
  "AutoScalingCreationPolicy" : {
    "MinSuccessfulInstancesPercent" : Integer
  },
  "ResourceSignal" : {    
    "Count" : Integer,
    "Timeout" : String
  }
}
```

#### YAML
<a name="aws-attribute-creation-policy-app-auto-scaling-syntax.yaml"></a>

```
CreationPolicy:
  AutoScalingCreationPolicy:
    MinSuccessfulInstancesPercent: Integer
  ResourceSignal:    
    Count: Integer
    Timeout: String
```

### Properti pembuatan Penskalaan Otomatis Amazon EC2
<a name="cfn-attributes-creationpolicy-properties"></a>

Konfigurasi Amazon EC2 Auto Scaling untuk kebijakan pembuatan.

`AutoScalingCreationPolicy`  <a name="cfn-attributes-creationpolicy-autoscalingcreationpolicy"></a>
Untuk grup Amazon EC2 Auto Scaling baru, tentukan jumlah instans yang harus memberi sinyal keberhasilan sebelum menyetel status grup. `CREATE_COMPLETE`    
`MinSuccessfulInstancesPercent`  <a name="cfn-attributes-creationpolicy-autoscalingcreationpolicy-minsuccessfulinstancespercent"></a>
Menentukan persentase instans dalam Amazon EC2 Auto Scaling yang harus memberi sinyal keberhasilan sebelum menyetel status grup. `CREATE_COMPLETE` Anda dapat menentukan nilai dari `0` ke`100`. CloudFormation putaran ke sepersepuluh persen terdekat. Misalnya, jika Anda membuat lima instance dengan persentase keberhasilan minimum`50`, tiga instance harus menandakan keberhasilan. Jika sebuah instance tidak mengirim sinyal dalam waktu yang ditentukan oleh `Timeout` properti, CloudFormation asumsikan bahwa instance tidak dibuat.  
*Default*: `100`  
*Tipe*: Integer  
*Wajib*: Tidak

`ResourceSignal`  <a name="cfn-attributes-creationpolicy-resourcesignal"></a>
Saat CloudFormation membuat sumber daya terkait, mengonfigurasi jumlah sinyal keberhasilan yang diperlukan dan lamanya waktu yang CloudFormation menunggu sinyal tersebut.    
`Count`  <a name="cfn-attributes-creationpolicy-resourcesignal-count"></a>
Jumlah sinyal keberhasilan CloudFormation harus diterima sebelum menetapkan status sumber daya sebagai`CREATE_COMPLETE`. Jika sumber daya menerima sinyal kegagalan atau tidak menerima jumlah sinyal yang ditentukan sebelum periode batas waktu berakhir, pembuatan sumber daya gagal dan CloudFormation memutar tumpukan kembali.  
*Default*: `1`  
*Tipe*: Integer  
*Wajib*: Tidak  
`Timeout`  <a name="cfn-attributes-creationpolicy-resourcesignal-timeout"></a>
Lamanya waktu yang CloudFormation menunggu jumlah sinyal yang ditentukan dalam `Count` properti. Periode batas waktu dimulai setelah CloudFormation menstabilkan sumber daya, dan batas waktu berakhir tidak lebih cepat dari waktu yang Anda tentukan tetapi dapat terjadi segera setelahnya. Waktu maksimum yang dapat Anda tentukan adalah 12 jam.  
Nilai harus dalam [format ISO8601 durasi](https://en.wikipedia.org/wiki/ISO_8601#Durations), dalam bentuk:`PT#H#M#S`, di mana masing-masing *\$1* adalah jumlah jam, menit, dan detik, masing-masing. Untuk hasil terbaik, tentukan periode waktu yang memberikan instans Anda banyak waktu untuk bangun dan berjalan. Batas waktu yang lebih pendek dapat menyebabkan rollback.  
*Default*: `PT5M` (5 menit)  
*Tipe*: String  
*Wajib*: Tidak

## Contoh
<a name="aws-attribute-creation-policy-examples"></a>

### Nama grup Auto Scaling
<a name="aws-attribute-creation-policy-as-group"></a>

Contoh berikut menunjukkan cara menambahkan kebijakan pembuatan ke grup Amazon EC2 Auto Scaling. Kebijakan pembuatan membutuhkan tiga sinyal berhasil dan habis waktu setelah 15 menit. Gunakan skrip [cfn-signal](cfn-signal.md) helper untuk memberi sinyal ketika proses pembuatan instance telah berhasil diselesaikan.

Agar instance menunggu pemeriksaan kesehatan Elastic Load Balancing sebelum sinyal berhasil, tambahkan verifikasi pemeriksaan kesehatan dengan menggunakan skrip helper. [cfn-init](cfn-init.md) [Sebagai contoh, lihat `verify_instance_health` perintah di templat sampel untuk pembaruan GitHub bergulir Amazon EC2 Auto Scaling di repositori kami.](https://github.com/aws-cloudformation/aws-cloudformation-templates/tree/main/AutoScaling)

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

```
"AutoScalingGroup": {
  "Type": "AWS::AutoScaling::AutoScalingGroup",
  "Properties": {
    "VPCZoneIdentifier":[ "subnetIdAz1", "subnetIdAz2", "subnetIdAz3" ],
    "LaunchTemplate":{
      "LaunchTemplateId":{
        "Ref":"logicalName"
      },
      "Version":{
        "Fn::GetAtt":[
          "logicalName",
          "LatestVersionNumber"
        ]
      }
    },
    "MinSize": "1",
    "MaxSize": "4"
  },
  "CreationPolicy": {
    "ResourceSignal": {
      "Count": "3",
      "Timeout": "PT15M"
    }
  }
}
```

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

```
AutoScalingGroup:
  Type: AWS::AutoScaling::AutoScalingGroup
  Properties:
    VPCZoneIdentifier:
      - subnetIdAz1
      - subnetIdAz2
      - subnetIdAz3
    LaunchTemplate:
      LaunchTemplateId: !Ref logicalName
      Version: !GetAtt logicalName.LatestVersionNumber
    MinSize: '1'
    MaxSize: '4'
  CreationPolicy:
    ResourceSignal:
      Count: '3'
      Timeout: PT15M
```

### WaitCondition
<a name="w2aac19b7c15b5"></a>

Contoh berikut menunjukkan cara menambahkan kebijakan pembuatan ke kondisi tunggu untuk CloudFormation sumber daya di luar Amazon EC2.

Untuk memberi sinyal `WaitCondition` sumber daya, gunakan [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html)API. API ini dirancang untuk bekerja dengan `WaitCondition` sumber daya yang Anda konfigurasikan menggunakan file`CreationPolicy`.

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

```
"WaitCondition" : {
    "Type" : "AWS::CloudFormation::WaitCondition",
    "CreationPolicy" : {
        "ResourceSignal" : {
            "Timeout" : "PT15M",
            "Count" : "5"
        }
    }
}
```

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

```
WaitCondition:
  Type: AWS::CloudFormation::WaitCondition
  CreationPolicy:
    ResourceSignal:
      Timeout: PT15M
      Count: 5
```