Questa è la nuova *Guida di riferimento ai modelli CloudFormation *. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la [Guida AWS CloudFormation per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Associa l'`CreationPolicy`attributo a una risorsa per evitare che lo stato di creazione raggiunga il completamento finché non CloudFormation riceve un numero specificato di segnali di successo o non viene superato il periodo di timeout. Per segnalare una risorsa, puoi utilizzare lo script di [cfn-signal](cfn-signal.md) supporto o l'API. [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html) CloudFormation pubblica segnali validi negli eventi dello stack in modo da tenere traccia del numero di segnali inviati.

La politica di creazione viene richiamata solo quando viene CloudFormation creata la risorsa associata. Attualmente, le uniche CloudFormation risorse che supportano le politiche di creazione sono:
+ [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)

Utilizza l'attributo `CreationPolicy` per restare in attesa durante le operazioni di configurazione della risorsa prima che la creazione dello stack continui. Ad esempio, se esegui l'installazione e la configurazione di applicazioni software su un'istanza EC2, potresti volere che tali applicazioni siano in esecuzione prima di continuare. In questi casi, puoi aggiungere un attributo `CreationPolicy` all'istanza e quindi inviare un segnale di successo all'istanza dopo l'installazione e la configurazione delle applicazioni. Per un esempio dettagliato, consulta la sezione [Distribuzione di applicazioni su Amazon EC2](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/deploying.applications.html) nella Guida per CloudFormation *AWS CloudFormation l'*utente.

## WorkSpaces Politica di creazione delle applicazioni
<a name="aws-attribute-creation-policy-app-stream-fleet"></a>

 AppStream Configurazione Amazon per una politica di creazione.

### Sintassi
<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>
Avvia il parco istanze specificato.  
*Obbligatorio:* no

## Proprietà di creazione di Amazon EC2 Auto Scaling
<a name="w2aac19b7c13"></a>

Configurazione di Amazon EC2 Auto Scaling per una policy di creazione.

### Sintassi
<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}}
```

### Proprietà di creazione di Amazon EC2 Auto Scaling
<a name="cfn-attributes-creationpolicy-properties"></a>

Configurazione di Amazon EC2 Auto Scaling per una policy di creazione.

`AutoScalingCreationPolicy`  <a name="cfn-attributes-creationpolicy-autoscalingcreationpolicy"></a>
Per un nuovo gruppo Amazon EC2 Auto Scaling, specifica il numero di istanze che devono riferire un esito positivo prima di impostare lo stato del gruppo su `CREATE_COMPLETE`.    
`MinSuccessfulInstancesPercent`  <a name="cfn-attributes-creationpolicy-autoscalingcreationpolicy-minsuccessfulinstancespercent"></a>
Specifica la percentuale di istanze in Amazon EC2 Auto Scaling che devono riferire un esito positivo prima di impostare lo stato del gruppo su `CREATE_COMPLETE`. Puoi specificare un valore compreso tra `0` a`100`. CloudFormation arrotonda al decimo di punto percentuale più vicino. Ad esempio, se crei cinque istanze con una percentuale di riuscita minima pari a `50`, tre istanze devono inviare segnali di esito positivo. Se un'istanza non invia un segnale entro il tempo specificato dalla `Timeout` proprietà, CloudFormation presuppone che l'istanza non sia stata creata.  
*Default*: `100`  
*Tipo*: integer  
*Obbligatorio:* no

`ResourceSignal`  <a name="cfn-attributes-creationpolicy-resourcesignal"></a>
Quando CloudFormation crea la risorsa associata, configura il numero di segnali di successo richiesti e il periodo di CloudFormation attesa di tali segnali.    
`Count`  <a name="cfn-attributes-creationpolicy-resourcesignal-count"></a>
Il numero di segnali di successo che CloudFormation deve ricevere prima di impostare lo stato della risorsa su. `CREATE_COMPLETE` Se la risorsa riceve un segnale di errore o non riceve il numero di segnali specificato prima della scadenza del periodo di timeout, la creazione della risorsa fallisce e ripristina lo CloudFormation stack.  
*Default*: `1`  
*Tipo*: integer  
*Obbligatorio:* no  
`Timeout`  <a name="cfn-attributes-creationpolicy-resourcesignal-timeout"></a>
Il periodo di CloudFormation attesa del numero di segnali specificato nella proprietà. `Count` Il periodo di timeout inizia dopo CloudFormation la stabilizzazione della risorsa e scade non prima del periodo specificato, ma può verificarsi poco dopo. Il tempo massimo che puoi specificare è 12 ore.  
Il valore deve essere in [formato di ISO8601 durata](https://en.wikipedia.org/wiki/ISO_8601#Durations), nel formato:`PT{{#}}H{{#}}M{{#}}S`, dove ciascuno {{\#}} è rispettivamente il numero di ore, minuti e secondi. Per ottenere risultati ottimali, specifica un valore che garantisca alle istanze molto tempo per attivarsi, perché un timeout più breve può causare un rollback.  
*Predefinito*: `PT5M` (5 minuti)  
▬*Tipo:* stringa  
*Obbligatorio:* no

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

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

Nell'esempio seguente viene mostrato come aggiungere una policy di creazione a un gruppo Amazon EC2 Auto Scaling. Le policy di creazione richiede tre segnali di successo e il timeout è dopo 15 minuti. Utilizza lo script helper [cfn-signal](cfn-signal.md) per segnalare il completamento del processo di creazione di un’istanza.

Per fare in modo che le istanze attendano un controllo dell’integrità Elastic Load Balancing prima di inviare il segnale di completamento dell’operazione, aggiungi una verifica del controllo dell’integrità utilizzando lo script helper [cfn-init](cfn-init.md). [Per un esempio, consulta il `verify_instance_health` comando nei modelli di esempio per gli aggiornamenti GitHub di Amazon EC2 Auto Scaling nel nostro repository.](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>

L'esempio seguente mostra come aggiungere una policy di creazione a una condizione di attesa per CloudFormation risorse oltre Amazon EC2.

Per segnalare la risorsa `WaitCondition`, utilizza l’API [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html). Questa API è progettata per funzionare con risorse `WaitCondition` configurate utilizzando una `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
```