Il s’agit du nouveau *Guide de référence des modèles CloudFormation *. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le [guide de AWS CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Associez l'`CreationPolicy`attribut à une ressource pour éviter que son statut n'atteigne la fin de création tant que vous n'avez pas CloudFormation reçu un nombre spécifié de signaux de réussite ou que le délai d'expiration n'est pas dépassé. Pour signaler une ressource, vous pouvez utiliser le script d'[cfn-signal](cfn-signal.md)assistance ou [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html)l'API. CloudFormation publie des signaux valides dans la pile d'événements afin que vous puissiez suivre le nombre de signaux envoyés.

La politique de création n'est invoquée que lors de CloudFormation la création de la ressource associée. À l'heure actuelle, les seules CloudFormation ressources qui prennent en charge les politiques de création sont les suivantes :
+ [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)

Utilisez l’attribut `CreationPolicy` lorsque vous voulez attendre que les actions de configuration de ressource ne soient terminées avant que la création de la pile ne commence. Par exemple, si vous installez et configurez des applications logicielles dans une instance EC2, vous souhaitez peut-être que ces applications soient exécutées avant de poursuivre. Dans ce cas, vous pouvez ajouter un attribut `CreationPolicy` à l'instance, puis envoyer un signal de réussite à l'instance une fois que les applications sont installées et configurées. Pour un exemple détaillé, consultez la section [Déploiement d'applications sur Amazon EC2 CloudFormation dans le guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/deploying.applications.html) de l'*AWS CloudFormation utilisateur*.

## WorkSpaces Politique de création d'applications
<a name="aws-attribute-creation-policy-app-stream-fleet"></a>

 AppStream Configuration d'Amazon pour une politique de création.

### Syntaxe
<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>
Démarre la flotte spécifiée.  
*Obligatoire* : non

## Propriétés de création Amazon EC2 Auto Scaling
<a name="w2aac19b7c13"></a>

Configuration d'Amazon EC2 Auto Scaling pour une politique de création.

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

### Propriétés de création Amazon EC2 Auto Scaling
<a name="cfn-attributes-creationpolicy-properties"></a>

Configuration d'Amazon EC2 Auto Scaling pour une politique de création.

`AutoScalingCreationPolicy`  <a name="cfn-attributes-creationpolicy-autoscalingcreationpolicy"></a>
Pour un nouveau groupe Amazon EC2 Auto Scaling, cette configuration spécifie le nombre d'instances qui doivent signaler une réussite avant que l'état du groupe ne devienne `CREATE_COMPLETE`.    
`MinSuccessfulInstancesPercent`  <a name="cfn-attributes-creationpolicy-autoscalingcreationpolicy-minsuccessfulinstancespercent"></a>
Spécifie le pourcentage d'instances d'un groupe Amazon EC2 Auto Scaling qui doivent signaler une réussite avant que l'état du groupe ne devienne `CREATE_COMPLETE`. Vous pouvez spécifier une valeur comprise entre `0` et`100`. CloudFormation arrondit au dixième de pour cent le plus proche. Par exemple, si vous créez cinq instances avec un pourcentage minimum de réussite de `50`, trois instances doivent signaler leur réussite. Si une instance n'envoie pas de signal dans le délai spécifié par la `Timeout` propriété, cela CloudFormation suppose que l'instance n'a pas été créée.  
*Par défaut* : `100`  
*Type* : entier  
*Obligatoire* : non

`ResourceSignal`  <a name="cfn-attributes-creationpolicy-resourcesignal"></a>
Lors CloudFormation de la création de la ressource associée, configure le nombre de signaux de réussite requis et le temps d' CloudFormation attente de ces signaux.    
`Count`  <a name="cfn-attributes-creationpolicy-resourcesignal-count"></a>
Le nombre de signaux de réussite à CloudFormation recevoir avant que le statut de la ressource ne soit défini comme`CREATE_COMPLETE`. Si la ressource reçoit un signal d'échec ou ne reçoit pas le nombre de signaux spécifié avant l'expiration du délai d'expiration, la création de la ressource échoue et CloudFormation annule la pile.  
*Par défaut* : `1`  
*Type* : entier  
*Obligatoire* : non  
`Timeout`  <a name="cfn-attributes-creationpolicy-resourcesignal-timeout"></a>
Durée d' CloudFormation attente pour le nombre de signaux spécifié dans la `Count` propriété. Le délai d'expiration commence après la CloudFormation stabilisation de la ressource, et le délai expire au plus tôt à l'heure que vous spécifiez, mais il peut survenir peu de temps après. La durée maximale que vous pouvez spécifier est de 12 heures.  
La valeur doit être au [format ISO8601 durée](https://en.wikipedia.org/wiki/ISO_8601#Durations), sous la forme :`PT#H#M#S`, où chacune *\$1* correspond au nombre d'heures, de minutes et de secondes, respectivement. Pour optimiser les performances, spécifiez une période qui laisse suffisamment de temps à vos instances pour être opérationnelles. Un délai d'expiration trop court peut entraîner une restauration.  
*Valeur par défaut* : `PT5M` (5 minutes)  
*Type* : chaîne  
*Obligatoire* : non

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

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

L'exemple suivant montre comment ajouter une politique de création à un groupe Amazon EC2 Auto Scaling. Cette politique de création nécessite trois signaux de réussite et expire au bout de 15 minutes. Utilisez le script d’assistance [cfn-signal](cfn-signal.md) pour signaler qu’un processus de création d’instance s’est terminé avec succès.

Pour obliger les instances à attendre la surveillance de l’état d’équilibrage de charge Elastic Load Balancing avant de signaler leur réussite, ajoutez une vérification à l’aide du script d’assistance [cfn-init](cfn-init.md). Par exemple, consultez la `verify_instance_health` commande figurant dans les exemples de modèles pour les mises à jour continues d'Amazon EC2 Auto Scaling dans [GitHub notre](https://github.com/aws-cloudformation/aws-cloudformation-templates/tree/main/AutoScaling) référentiel.

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

L'exemple suivant montre comment ajouter une politique de création à une condition d'attente pour les CloudFormation ressources au-delà d'Amazon EC2.

Pour signaler la ressource `WaitCondition`, utilisez l’API [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html). Cette API est conçue pour fonctionner avec des ressources `WaitCondition` que vous configurez à l’aide d’un `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
```