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à.

# DeploymentPreference
<a name="sam-property-function-deploymentpreference"></a>

Specifica le configurazioni per abilitare le distribuzioni Lambda graduali. Per ulteriori informazioni sulla configurazione di distribuzioni Lambda graduali, consulta. [Implementazione graduale di applicazioni serverless con AWS SAM](automating-updates-to-serverless-apps.md)

**Nota**  
È necessario specificare un `AutoPublishAlias` nel proprio [AWS::Serverless::Function](sam-resource-function.md) per utilizzare un `DeploymentPreference` oggetto, altrimenti si verificherà un errore.

## Sintassi
<a name="sam-property-function-deploymentpreference-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-property-function-deploymentpreference-syntax.yaml"></a>

```
  [Alarms](#sam-function-deploymentpreference-alarms): List
  [Enabled](#sam-function-deploymentpreference-enabled): Boolean
  [Hooks](#sam-function-deploymentpreference-hooks): Hooks
  [PassthroughCondition](#sam-function-deploymentpreference-passthroughcondition): Boolean
  [Role](#sam-function-deploymentpreference-role): String
  [TriggerConfigurations](#sam-function-deploymentpreference-triggerconfigurations): List
  [Type](#sam-function-deploymentpreference-type): String
```

## Properties
<a name="sam-property-function-deploymentpreference-properties"></a>

 `Alarms`   <a name="sam-function-deploymentpreference-alarms"></a>
Un elenco di CloudWatch allarmi che desideri vengano attivati da eventuali errori generati dalla distribuzione.  
Questa proprietà accetta la funzione `Fn::If` intrinseca. Vedi la sezione Esempi alla fine di questo argomento per un modello di esempio che utilizza. `Fn::If`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Enabled`   <a name="sam-function-deploymentpreference-enabled"></a>
Se questa preferenza di distribuzione è abilitata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Impostazione predefinita*: True  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Hooks`   <a name="sam-function-deploymentpreference-hooks"></a>
Funzioni Lambda di convalida eseguite prima e dopo lo spostamento del traffico.  
*[Tipo: ganci](sam-property-function-hooks.md)*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `PassthroughCondition`   <a name="sam-function-deploymentpreference-passthroughcondition"></a>
Se True e se questa preferenza di distribuzione è abilitata, la Condition della funzione verrà trasmessa alla CodeDeploy risorsa generata. In genere, è necessario impostarlo su True. Altrimenti, la CodeDeploy risorsa verrebbe creata anche se la condizione della funzione viene risolta su False.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Role`   <a name="sam-function-deploymentpreference-role"></a>
Un ARN di ruolo IAM che CodeDeploy verrà utilizzato per lo spostamento del traffico. Se viene fornito, non verrà creato un ruolo IAM.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `TriggerConfigurations`   <a name="sam-function-deploymentpreference-triggerconfigurations"></a>
Un elenco di configurazioni di trigger che si desidera associare al gruppo di distribuzione. Utilizzato per notificare un argomento SNS sugli eventi del ciclo di vita.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[TriggerConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentgroup.html#cfn-codedeploy-deploymentgroup-triggerconfigurations)` proprietà di una risorsa. `AWS::CodeDeploy::DeploymentGroup`

 `Type`   <a name="sam-function-deploymentpreference-type"></a>
Al momento esistono due categorie di tipi di distribuzione: Linear e Canary. Per ulteriori informazioni sui tipi di distribuzione disponibili, vedere[Implementazione graduale di applicazioni serverless con AWS SAM](automating-updates-to-serverless-apps.md).  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

## Esempi
<a name="sam-property-function-deploymentpreference--examples"></a>

### DeploymentPreference con agganci pre e post-traffico.
<a name="sam-property-function-deploymentpreference--examples--deploymentpreference-with-pre--and-post-traffic-hooks."></a>

Esempio di preferenza di implementazione che contiene gli hook precedenti e successivi al traffico.

#### YAML
<a name="sam-property-function-deploymentpreference--examples--deploymentpreference-with-pre--and-post-traffic-hooks.--yaml"></a>

```
DeploymentPreference:
  Enabled: true
  Type: Canary10Percent10Minutes 
  Alarms:
    - !Ref: AliasErrorMetricGreaterThanZeroAlarm
    - !Ref: LatestVersionErrorMetricGreaterThanZeroAlarm
  Hooks:
    PreTraffic:
      !Ref: PreTrafficLambdaFunction
    PostTraffic:
      !Ref: PostTrafficLambdaFunction
```

### DeploymentPreference con la funzione intrinseca Fn: :If
<a name="sam-property-function-deploymentpreference--examples--deploymentpreference-with-fn::if-intrinsic-function"></a>

Esempio di preferenza di distribuzione utilizzata `Fn::If` per la configurazione degli allarmi. In questo esempio, `Alarm1` verrà configurato se lo `MyCondition` è `true` `Alarm2` e `Alarm5` verrà configurato se `MyCondition` lo è. `false`

#### YAML
<a name="sam-property-function-deploymentpreference--examples--deploymentpreference-with-fn::if-intrinsic-function--yaml"></a>

```
DeploymentPreference:
  Enabled: true
  Type: Canary10Percent10Minutes 
  Alarms:
    Fn::If:
      - MyCondition
      - - Alarm1
      - - Alarm2
        - Alarm5
```