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

# EventBridgeRule
<a name="sam-property-function-eventbridgerule"></a>

L'oggetto che descrive un tipo di origine di `EventBridgeRule` eventi, che imposta la tua funzione serverless come destinazione di una regola Amazon EventBridge . Per ulteriori informazioni, consulta [What Is Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) nella *Amazon EventBridge User Guide*.

AWS SAM genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html)risorsa quando viene impostato questo tipo di evento. AWS SAM crea anche una `AWS::Lambda::Permission` risorsa, necessaria per `EventBridgeRule` poter chiamare Lambda.

## Sintassi
<a name="sam-property-function-eventbridgerule-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-eventbridgerule-syntax.yaml"></a>

```
  [DeadLetterConfig](#sam-function-eventbridgerule-deadletterconfig): DeadLetterConfig
  [EventBusName](#sam-function-eventbridgerule-eventbusname): String
  [Input](#sam-function-eventbridgerule-input): String
  [InputPath](#sam-function-eventbridgerule-inputpath): String
  InputTransformer: [InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html)
  [Pattern](#sam-function-eventbridgerule-pattern): [EventPattern](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-eventpattern)
  [RetryPolicy](#sam-function-eventbridgerule-retrypolicy): [RetryPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-retrypolicy)
  RuleName: String 
  State: String
  [Target](#sam-function-eventbridgerule-target): Target
```

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

 `DeadLetterConfig`   <a name="sam-function-eventbridgerule-deadletterconfig"></a>
Configura la coda Amazon Simple Queue Service (Amazon SQS) a EventBridge cui invia gli eventi dopo una chiamata di destinazione non riuscita. L'invocazione può fallire, ad esempio, quando si invia un evento a una funzione Lambda che non esiste o quando EventBridge le autorizzazioni sono insufficienti per richiamare la funzione Lambda. *Per ulteriori informazioni, consulta la [politica di riprova degli eventi e l'utilizzo delle code di lettere morte nella](https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html) Amazon User Guide. EventBridge *  
Il tipo di [AWS::Serverless::Function](sam-resource-function.md) risorsa ha un tipo di dati simile`DeadLetterQueue`, che gestisce gli errori che si verificano dopo una chiamata riuscita della funzione Lambda di destinazione. Esempi di questi tipi di errori includono la limitazione Lambda o gli errori restituiti dalla funzione di destinazione Lambda. *Per ulteriori informazioni sulla `DeadLetterQueue` proprietà della funzione, consulta [Dead-letter](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq) queues nella Developer Guide.AWS Lambda *
*Tipo:* [DeadLetterConfig](sam-property-function-deadletterconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[DeadLetterConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-deadletterconfig)` proprietà del tipo di dati. `AWS::Events::Rule` `Target` La AWS SAM versione di questa proprietà include sottoproprietà aggiuntive, nel caso in cui si desideri AWS SAM creare automaticamente la coda di lettere non scritte.

 `EventBusName`   <a name="sam-function-eventbridgerule-eventbusname"></a>
Il bus evento da associare a questa regola. Se si omette questa proprietà, AWS SAM utilizza il bus eventi predefinito.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Predefinito*: bus eventi predefinito  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventBusName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-eventbusname)` proprietà di una `AWS::Events::Rule` risorsa.

 `Input`   <a name="sam-function-eventbridgerule-input"></a>
Testo JSON valido passato al target. Se utilizzi questa proprietà, al target non viene passata alcuna informazione sul testo dell'evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Input](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-input)` proprietà di una `AWS::Events::Rule Target` risorsa.

 `InputPath`   <a name="sam-function-eventbridgerule-inputpath"></a>
Quando non vuoi passare l'intero evento corrispondente alla destinazione, usa la `InputPath` proprietà per descrivere quale parte dell'evento trasmettere.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[InputPath](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-inputpath)` proprietà di una `AWS::Events::Rule Target` risorsa.

 `InputTransformer`   <a name="sam-function-eventbridgerule-inputtransformer"></a>
Impostazioni che consentono di fornire input personalizzato a un target in base a determinati dati di eventi. Puoi estrarre una o più coppie chiave-valore dall'evento e quindi utilizzare tali dati per l'invio di input personalizzato al target. Per ulteriori informazioni, consulta [Amazon EventBridge Input Transformation](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html) nella *Amazon EventBridge User Guide*.   
*Tipo:* [InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-inputtransformer)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html)` proprietà di un tipo di `AWS::Events::Rule` `Target` dati.

 `Pattern`   <a name="sam-function-eventbridgerule-pattern"></a>
Descrive quali eventi vengono instradati nella destinazione specificata. Per ulteriori informazioni, consulta [ EventBridgegli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) e [i modelli di EventBridge eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) di *Amazon nella Amazon EventBridge User Guide*.  
*Tipo:* [EventPattern](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-eventpattern)  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventPattern](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-eventpattern)` proprietà di una `AWS::Events::Rule` risorsa.

 `RetryPolicy`   <a name="sam-function-eventbridgerule-retrypolicy"></a>
Un oggetto `RetryPolicy` che include informazioni sulle impostazioni dei criteri di nuovi tentativi. *Per ulteriori informazioni, consulta la [politica di riprova degli eventi e l'utilizzo delle code di lettere morte nella](https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html) Amazon User Guide. EventBridge *  
*Tipo:* [RetryPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-retrypolicy)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[RetryPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-retrypolicy)` proprietà del tipo di dati. `AWS::Events::Rule` `Target`

 `RuleName`   <a name="sam-function-eventbridgerule-rulename"></a>
Nome della regola .  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-name)` proprietà di una `AWS::Events::Rule` risorsa.

 `State`   <a name="sam-function-eventbridgerule-state"></a>
Lo stato della regola.  
*Valori accettati*: `DISABLED` \$1 `ENABLED` \$1 `ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[State](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-state) ` proprietà di una `AWS::Events::Rule` risorsa.

 `Target`   <a name="sam-function-eventbridgerule-target"></a>
La AWS risorsa che EventBridge richiama quando viene attivata una regola. È possibile utilizzare questa proprietà per specificare l'ID logico della destinazione. Se questa proprietà non è specificata, AWS SAM genera l'ID logico della destinazione.  
*Tipo*: [Target](sam-property-function-target.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[Targets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-targets)` proprietà di una `AWS::Events::Rule` risorsa. `Amazon EC2 RebootInstances API call`è un esempio di proprietà di destinazione. La AWS SAM versione di questa proprietà consente solo di specificare l'ID logico di una singola destinazione.

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

### EventBridgeRule
<a name="sam-property-function-eventbridgerule--examples--eventbridgerule"></a>

Di seguito è riportato un esempio di tipo di origine di `EventBridgeRule` evento.

#### YAML
<a name="sam-property-function-eventbridgerule--examples--eventbridgerule--yaml"></a>

```
EBRule:
  Type: EventBridgeRule
  Properties:
    Input: '{"Key": "Value"}'
    Pattern:
      detail:
        state:
          - terminated
    RetryPolicy:
      MaximumRetryAttempts: 5
      MaximumEventAgeInSeconds: 900
    DeadLetterConfig:
      Type: SQS
      QueueLogicalId: EBRuleDLQ
    Target:
      Id: MyTarget
```

# DeadLetterConfig
<a name="sam-property-function-deadletterconfig"></a>

L'oggetto utilizzato per specificare la coda Amazon Simple Queue Service (Amazon SQS) in EventBridge cui invia gli eventi dopo una chiamata di destinazione non riuscita. L'invocazione può fallire, ad esempio, quando si invia un evento a una funzione Lambda che non esiste o le autorizzazioni sono insufficienti per richiamare la funzione Lambda. *Per ulteriori informazioni, consulta la [politica di riprova degli eventi e l'utilizzo delle code di lettere morte nella](https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html) Amazon User Guide. EventBridge *

**Nota**  
Il tipo di [AWS::Serverless::Function](sam-resource-function.md) risorsa ha un tipo di dati simile, `DeadLetterQueue` che gestisce gli errori che si verificano dopo una chiamata riuscita della funzione Lambda di destinazione. Esempi di questo tipo di errore includono la limitazione Lambda o gli errori restituiti dalla funzione di destinazione Lambda. *Per ulteriori informazioni sulla `DeadLetterQueue` proprietà della funzione, consulta [Dead-letter](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq) queues nella Developer Guide.AWS Lambda *

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

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

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

```
  [Arn](#sam-function-deadletterconfig-arn): String
  [QueueLogicalId](#sam-function-deadletterconfig-queuelogicalid): String
  [Type](#sam-function-deadletterconfig-type): String
```

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

 `Arn`   <a name="sam-function-deadletterconfig-arn"></a>
L'Amazon Resource Name (ARN) della coda Amazon SQS specificato come destinazione per la coda di lettere non scritte.  
Specificare la proprietà o la `Type` proprietà, ma non entrambe. `Arn`
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Arn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-deadletterconfig.html#cfn-events-rule-deadletterconfig-arn)` proprietà del tipo di `AWS::Events::Rule` `DeadLetterConfig` dati.

 `QueueLogicalId`   <a name="sam-function-deadletterconfig-queuelogicalid"></a>
`Type`Viene specificato il nome personalizzato della coda di lettere morte che AWS SAM crea if.  
Se la `Type` proprietà non è impostata, viene ignorata.
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Type`   <a name="sam-function-deadletterconfig-type"></a>
Il tipo di coda. Quando questa proprietà è impostata, crea AWS SAM automaticamente una coda di lettere morte e allega la [politica basata sulle risorse necessaria per concedere l'autorizzazione alla risorsa](https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html#dlq-perms) delle regole di inviare eventi alla coda.  
Specificate la proprietà o la proprietà, ma non entrambe. `Type` `Arn`
*Valori validi*: `SQS`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### DeadLetterConfig
<a name="sam-property-function-deadletterconfig--examples--deadletterconfig"></a>

DeadLetterConfig

#### YAML
<a name="sam-property-function-deadletterconfig--examples--deadletterconfig--yaml"></a>

```
DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ
```

# Target
<a name="sam-property-function-target"></a>

Configura la AWS risorsa che EventBridge richiama quando viene attivata una regola.

## Sintassi
<a name="sam-property-function-target-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-target-syntax.yaml"></a>

```
  [Id](#sam-function-target-id): String
```

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

 `Id`   <a name="sam-function-target-id"></a>
L'ID logico della destinazione.  
Il valore di `Id` può includere caratteri alfanumerici, punti (`.`), trattini () e caratteri di `-` sottolineatura (). `_`  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Id](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-id)` proprietà del tipo di dati. `AWS::Events::Rule` `Target`

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

### Target
<a name="sam-property-function-target--examples--target"></a>

#### YAML
<a name="sam-property-function-target--examples--target--yaml"></a>

```
EBRule:
  Type: EventBridgeRule
  Properties:
    Target:
      Id: MyTarget
```