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

# AWS::Serverless::Function
<a name="sam-resource-function"></a>

Crea una AWS Lambda funzione, un ruolo di esecuzione AWS Identity and Access Management (IAM) e mappature delle sorgenti degli eventi che attivano la funzione.

La [AWS::Serverless::Function](#sam-resource-function) risorsa supporta anche l'attributo `Metadata` resource, quindi puoi indicare di AWS SAM creare runtime personalizzati richiesti dall'applicazione. Per ulteriori informazioni sulla creazione di runtime personalizzati, consulta. [Creazione di funzioni Lambda con runtime personalizzati in AWS SAM](building-custom-runtimes.md)

**Nota**  
Quando esegui la distribuzione su AWS CloudFormation, AWS SAM trasforma le tue AWS SAM risorse in risorse. CloudFormation Per ulteriori informazioni, consulta [CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md).

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

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

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

```
Type: AWS::Serverless::Function
Properties:
  [Architectures](#sam-function-architectures): List
  [AssumeRolePolicyDocument](#sam-function-assumerolepolicydocument): JSON
  [AutoPublishAlias](#sam-function-autopublishalias): String
  AutoPublishAliasAllProperties: Boolean
  [AutoPublishCodeSha256](#sam-function-autopublishcodesha256): String
  [CapacityProviderConfig](#sam-function-capacityproviderconfig): CapacityProviderConfig
  [CodeSigningConfigArn](#sam-function-codesigningconfigarn): String
  [CodeUri](#sam-function-codeuri): String | FunctionCode
  [DeadLetterQueue](#sam-function-deadletterqueue): Map | DeadLetterQueue
  [DeploymentPreference](#sam-function-deploymentpreference): DeploymentPreference
  [Description](#sam-function-description): String
  [DurableConfig](#sam-function-durableconfig): DurableConfig
  [Environment](#sam-function-environment): [Environment](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-environment.html)
  [EphemeralStorage](#sam-function-ephemeralstorage): [EphemeralStorage](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-ephemeralstorage)
  [EventInvokeConfig](#sam-function-eventinvokeconfig): EventInvokeConfiguration
  [Events](#sam-function-events): EventSource
  [FileSystemConfigs](#sam-function-filesystemconfigs): List
  [FunctionName](#sam-function-functionname): String
  [FunctionScalingConfig](#sam-function-functionscalingconfig): FunctionScalingConfig
  [FunctionUrlConfig](#sam-function-functionurlconfig): FunctionUrlConfig
  [Handler](#sam-function-handler): String
  [ImageConfig](#sam-function-imageconfig): [ImageConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-imageconfig)
  [ImageUri](#sam-function-imageuri): String
  [InlineCode](#sam-function-inlinecode): String
  [KmsKeyArn](#sam-function-kmskeyarn): String
  [Layers](#sam-function-layers): List
  LoggingConfig: [LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-loggingconfig.html)
  [MemorySize](#sam-function-memorysize): Integer
  [PackageType](#sam-function-packagetype): String
  [PermissionsBoundary](#sam-function-permissionsboundary): String
  [Policies](#sam-function-policies): String | List | Map
  [PublishToLatestPublished](#sam-function-publishtolatestpublished): Boolean
  PropagateTags: Boolean
  [ProvisionedConcurrencyConfig](#sam-function-provisionedconcurrencyconfig): [ProvisionedConcurrencyConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html#cfn-lambda-alias-provisionedconcurrencyconfig)
  RecursiveLoop: String
  [ReservedConcurrentExecutions](#sam-function-reservedconcurrentexecutions): Integer
  [Role](#sam-function-role): String
  [RolePath](#sam-function-rolepath): String
  [Runtime](#sam-function-runtime): String
  RuntimeManagementConfig: [RuntimeManagementConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-runtimemanagementconfig.html)
  SnapStart: [SnapStart](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-snapstart.html)
  [SourceKMSKeyArn](#sam-function-sourcekmskeyarn): String
  [Tags](#sam-function-tags): Map
  [TenancyConfig](#sam-function-tenancyconfig): TenancyConfig
  [Timeout](#sam-function-timeout): Integer
  [Tracing](#sam-function-tracing): String
  [VersionDescription](#sam-function-versiondescription): String
  [VersionDeletionPolicy](#sam-function-versiondeletionpolicy): String
  [VpcConfig](#sam-function-vpcconfig): [VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-vpcconfig.html)
```

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

 `Architectures`   <a name="sam-function-architectures"></a>
L'architettura del set di istruzioni per la funzione.  
*Per ulteriori informazioni su questa proprietà, consulta [Architetture dei set di istruzioni Lambda nella Guida per gli](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html) sviluppatori.AWS Lambda *  
*Valori validi*: uno dei o `x86_64` `arm64`  
Tipo: elenco  
*Obbligatorio:* no  
*Default*: `x86_64`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Architectures](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-architectures)` proprietà di una `AWS::Lambda::Function` risorsa.

 `AssumeRolePolicyDocument`   <a name="sam-function-assumerolepolicydocument"></a>
Aggiunge un AssumeRolePolicyDocument valore predefinito creato `Role` per questa funzione. Se questa proprietà non è specificata, AWS SAM aggiunge un ruolo di assunzione predefinito per questa funzione.  
*Type*: JSON  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[AssumeRolePolicyDocument](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-assumerolepolicydocument)` proprietà di una `AWS::IAM::Role` risorsa. AWS SAM aggiunge questa proprietà al ruolo IAM generato per questa funzione. Se per questa funzione viene fornito l'Amazon Resource Name (ARN) di un ruolo, questa proprietà non fa nulla.

 `AutoPublishAlias`   <a name="sam-function-autopublishalias"></a>
Il nome dell'alias Lambda. *Per ulteriori informazioni sugli alias Lambda, consulta Alias delle [funzioni Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) nella Developer Guide.AWS Lambda * Per esempi che utilizzano questa proprietà, consulta. [Implementazione graduale di applicazioni serverless con AWS SAM](automating-updates-to-serverless-apps.md)  
AWS SAM genera [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-version.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-version.html)e [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html)risorse quando questa proprietà è impostata. Per informazioni su questo scenario, vedere[AutoPublishAlias la proprietà è specificata](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-autopublishalias). Per informazioni generali sulle CloudFormation risorse generate, vedere[CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md).  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `AutoPublishAliasAllProperties`   <a name="sam-function-autopublishaliasallproperties"></a>
Specifica quando ne [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-version.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-version.html)viene creato uno nuovo. Quando`true`, viene creata una nuova versione Lambda quando viene modificata una proprietà della funzione Lambda. Quando`false`, viene creata una nuova versione Lambda solo quando viene modificata una delle seguenti proprietà:  
+ `Environment`, `MemorySize`, oppure `SnapStart`.
+ Qualsiasi modifica che comporti un aggiornamento della `Code` proprietà, ad esempio `CodeDict``ImageUri`, o`InlineCode`.
Questa proprietà `AutoPublishAlias` deve essere definita.  
Se `AutoPublishCodeSha256` viene specificato anche, il suo comportamento ha la precedenza su`AutoPublishAliasAllProperties: true`.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Valore predefinito*: `false`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `AutoPublishCodeSha256`   <a name="sam-function-autopublishcodesha256"></a>
Quando viene utilizzata, questa stringa funziona con il `CodeUri` valore per determinare se è necessario pubblicare una nuova versione di Lambda. Questa proprietà viene spesso utilizzata per risolvere il seguente problema di distribuzione: un pacchetto di distribuzione viene archiviato in una posizione Amazon S3 e sostituito da un nuovo pacchetto di distribuzione con codice funzione Lambda aggiornato, ma la `CodeUri` proprietà rimane invariata (al contrario del nuovo pacchetto di distribuzione caricato in una nuova posizione Amazon S3 e `CodeUri` trasferito nella nuova posizione).  
Questo problema è contrassegnato da un AWS SAM modello con le seguenti caratteristiche:  
+ L'`DeploymentPreference`oggetto è configurato per distribuzioni graduali (come descritto in) [Implementazione graduale di applicazioni serverless con AWS SAM](automating-updates-to-serverless-apps.md)
+ La `AutoPublishAlias` proprietà è impostata e non cambia tra le distribuzioni
+ La `CodeUri` proprietà è impostata e non cambia tra le distribuzioni.
In questo scenario, l'aggiornamento `AutoPublishCodeSha256` comporta la creazione corretta di una nuova versione Lambda. Tuttavia, il nuovo codice funzionale distribuito su Amazon S3 non verrà riconosciuto. Per riconoscere il nuovo codice funzionale, prendi in considerazione l'utilizzo del controllo delle versioni nel tuo bucket Amazon S3. Specificate la `Version` proprietà per la funzione Lambda e configurate il bucket per utilizzare sempre il pacchetto di distribuzione più recente.  
In questo scenario, per attivare correttamente la distribuzione graduale, è necessario fornire un valore univoco per. `AutoPublishCodeSha256`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `CapacityProviderConfig`   <a name="sam-function-capacityproviderconfig"></a>
Configura il provider di capacità a cui verranno allegate le versioni pubblicate della funzione. Ciò consente l'esecuzione della funzione su istanze EC2 di proprietà del cliente gestite da Lambda Managed Instances.  
*Tipo:* [CapacityProviderConfig](sam-property-function-capacityproviderconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: SAM appiattisce la proprietà passata alla proprietà di una risorsa e ricostruisce la `[CapacityProviderConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-capacityproviderconfig)` struttura annidata. `AWS::Lambda::Function`

 `CodeSigningConfigArn`   <a name="sam-function-codesigningconfigarn"></a>
L'ARN della [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-codesigningconfig.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-codesigningconfig.html)risorsa, utilizzato per abilitare la firma del codice per questa funzione. Per ulteriori informazioni sulla firma del codice, vedere[Configura la firma del codice per la tua AWS SAM applicazione](authoring-codesigning.md).  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CodeSigningConfigArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-codesigningconfigarn)` proprietà di una `AWS::Lambda::Function` risorsa.

 `CodeUri`   <a name="sam-function-codeuri"></a>
Il codice della funzione. I valori accettati includono:  
+ L'URI della funzione è Amazon S3. Ad esempio, `s3://bucket-123456789/sam-app/1234567890abcdefg`.
+ Il percorso locale della funzione. Ad esempio, `hello_world/`.
+ Oggetto [FunctionCode](sam-property-function-functioncode.md).
Se fornisci l'URI o l'[FunctionCode](sam-property-function-functioncode.md)oggetto Amazon S3 di una funzione, devi fare riferimento a un pacchetto di distribuzione [Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html) valido.  
Se fornisci un percorso di file locale, usa il AWS SAMCLI per caricare il file locale al momento della distribuzione. Per ulteriori informazioni, consulta [Come AWS SAM vengono caricati i file locali al momento della distribuzione](deploy-upload-local-files.md).  
Se si utilizzano funzioni intrinseche nella `CodeUri` proprietà, non AWS SAM sarà possibile analizzare correttamente i valori. Prendi invece in considerazione l'utilizzo di [AWS::LanguageExtensions transform](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-languageextensions.html).
*Tipo*: [String \$1[FunctionCode](sam-property-function-functioncode.md)]  
*Obbligatorio:* condizionale. Quando `PackageType` è impostato su`Zip`, `InlineCode` è richiesto uno dei `CodeUri` o.  
*CloudFormation compatibilità*: questa proprietà è simile alla `[ Code](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-code)` proprietà di una `AWS::Lambda::Function` risorsa. Le proprietà annidate di Amazon S3 sono denominate in modo diverso.

 `DeadLetterQueue`   <a name="sam-function-deadletterqueue"></a>
Configura un argomento Amazon Simple Notification Service (Amazon SNS) o una coda Amazon Simple Queue Service (Amazon SQS) in cui Lambda invia eventi che non può elaborare. [https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-dlq](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-dlq)  
Se l'origine degli eventi della tua funzione Lambda è una coda Amazon SQS, configura una coda di lettere non scritte per la coda di origine, non per la funzione Lambda. [La coda di lettere morte configurata per una funzione viene utilizzata per la coda di invocazione asincrona della funzione, non per le code di origine degli eventi.](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html)
*Tipo: Mappa \$1 [DeadLetterQueue](sam-property-function-deadletterqueue.md)*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[DeadLetterConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-deadletterconfig.html)` proprietà di una `AWS::Lambda::Function` risorsa. CloudFormation Nel tipo è derivato da`TargetArn`, mentre in è AWS SAM necessario passare il tipo insieme a`TargetArn`.

 `DeploymentPreference`   <a name="sam-function-deploymentpreference"></a>
Le impostazioni per abilitare le distribuzioni Lambda graduali.  
Se viene specificato un `DeploymentPreference` oggetto, AWS SAM crea un [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-application.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-application.html)chiamato `ServerlessDeploymentApplication` (uno per stack), un [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentgroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentgroup.html)chiamato e un chiamato`<function-logical-id>DeploymentGroup`. [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)`CodeDeployServiceRole`  
*Tipo:* [DeploymentPreference](sam-property-function-deploymentpreference.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.  
*Vedi anche*: Per ulteriori informazioni su questa proprietà, vedi[Implementazione graduale di applicazioni serverless con AWS SAM](automating-updates-to-serverless-apps.md).

 `Description`   <a name="sam-function-description"></a>
Una descrizione della funzione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-description)` proprietà di una `AWS::Lambda::Function` risorsa.

 `DurableConfig`   <a name="sam-function-durableconfig"></a>
Configurazione per funzioni durevoli. Abilita l'esecuzione con stato con funzionalità di checkpoint e replay automatici.  
*Tipo:* [DurableConfig](sam-property-function-durableconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Environment`   <a name="sam-function-environment"></a>
La configurazione per l'ambiente di runtime.  
*Type*: [Environment](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-environment.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Environment](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-environment.html)` proprietà di una `AWS::Lambda::Function` risorsa.

 `EphemeralStorage`   <a name="sam-function-ephemeralstorage"></a>
Un oggetto che specifica lo spazio su disco, in MB, disponibile per la funzione Lambda in. `/tmp`  
Per ulteriori informazioni su questa proprietà, consulta l'[ambiente di esecuzione Lambda](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html) nella *AWS Lambda Developer* Guide.  
*Tipo:* [EphemeralStorage](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-ephemeralstorage)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EphemeralStorage](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-ephemeralstorage)` proprietà di una `AWS::Lambda::Function` risorsa.

 `EventInvokeConfig`   <a name="sam-function-eventinvokeconfig"></a>
L'oggetto che descrive la configurazione Event Invoke su una funzione Lambda.  
*Tipo:* [EventInvokeConfiguration](sam-property-function-eventinvokeconfiguration.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Events`   <a name="sam-function-events"></a>
Speciifica gli eventi che attivano questa funzione. Gli eventi sono costituiti da un tipo e da un insieme di proprietà che dipendono dal tipo.  
*Tipo:* [EventSource](sam-property-function-eventsource.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `FileSystemConfigs`   <a name="sam-function-filesystemconfigs"></a>
Elenco di [FileSystemConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-filesystemconfig.html)oggetti che specificano le impostazioni di connessione per un file system Amazon Elastic File System (Amazon EFS).  
Se il modello contiene una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-efs-mounttarget.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-efs-mounttarget.html)risorsa, è necessario specificare anche un attributo di `DependsOn` risorsa per garantire che la destinazione di montaggio venga creata o aggiornata prima della funzione.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FileSystemConfigs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-filesystemconfigs)` proprietà di una `AWS::Lambda::Function` risorsa.

 `FunctionName`   <a name="sam-function-functionname"></a>
Nome per la funzione. Se non specifichi un nome, viene generato un nome univoco.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-functionname)` proprietà di una `AWS::Lambda::Function` risorsa.

 `FunctionScalingConfig`   <a name="sam-function-functionscalingconfig"></a>
Configura il comportamento di scalabilità per le funzioni Lambda in esecuzione sui provider di capacità. Definisce il numero minimo e massimo di ambienti di esecuzione.  
*Tipo:* [FunctionScalingConfig](sam-property-function-functionscalingconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-functionscalingconfig)` proprietà di una `AWS::Lambda::Function` risorsa.

 `FunctionUrlConfig`   <a name="sam-function-functionurlconfig"></a>
L'oggetto che descrive l'URL di una funzione. L'URL di una funzione è un endpoint HTTPS che puoi utilizzare per richiamare la tua funzione.  
Per ulteriori informazioni, consulta [Function URLs](https://docs.aws.amazon.com/lambda/latest/dg/lambda-urls.html) nella *AWS Lambda Developer* Guide.  
*Tipo:* [FunctionUrlConfig](sam-property-function-functionurlconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Handler`   <a name="sam-function-handler"></a>
La funzione all'interno del codice che viene chiamata per iniziare l'esecuzione. Questa proprietà è richiesta solo se è impostata su`Zip`. `PackageType`  
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Handler](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-handler)` proprietà di una `AWS::Lambda::Function` risorsa.

 `ImageConfig`   <a name="sam-function-imageconfig"></a>
L'oggetto utilizzato per configurare le impostazioni dell'immagine del contenitore Lambda. Per ulteriori informazioni, consulta [Using container images with Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html) nella *AWS Lambda Developer* Guide.  
*Tipo:* [ImageConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-imageconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ImageConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-imageconfig)` proprietà di una `AWS::Lambda::Function` risorsa.

 `ImageUri`   <a name="sam-function-imageuri"></a>
L'URI del repository Amazon Elastic Container Registry (Amazon ECR) per l'immagine del contenitore della funzione Lambda. Questa proprietà si applica solo se è impostata su`Image`, altrimenti viene ignorata. `PackageType` Per ulteriori informazioni, consulta [Using container images with Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html) nella *AWS Lambda Developer* Guide.  
Se la `PackageType` proprietà è impostata su`Image`, allora una delle due `ImageUri` è obbligatoria oppure è necessario creare l'applicazione con `Metadata` le voci necessarie nel file AWS SAM modello. Per ulteriori informazioni, consulta [Compilazione predefinita con AWS SAM](serverless-sam-cli-using-build.md).
La creazione dell'applicazione con `Metadata` le voci necessarie ha la precedenza sulla creazione dell'applicazione`ImageUri`, quindi se si specificano entrambe le voci `ImageUri` viene ignorata.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ImageUri](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-code.html#cfn-lambda-function-code-imageuri)` proprietà del tipo di `AWS::Lambda::Function` `Code` dati.

 `InlineCode`   <a name="sam-function-inlinecode"></a>
Il codice della funzione Lambda scritto direttamente nel modello. Questa proprietà si applica solo se è impostata su`Zip`, altrimenti viene ignorata. `PackageType`  
Se la `PackageType` proprietà è impostata su `Zip` (impostazione predefinita), `InlineCode` è richiesta una delle `CodeUri` o.
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ZipFile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-code.html#cfn-lambda-function-code-zipfile)` proprietà del tipo di `AWS::Lambda::Function` `Code` dati.

 `KmsKeyArn`   <a name="sam-function-kmskeyarn"></a>
L'ARN di una chiave AWS Key Management Service (AWS KMS) utilizzata da Lambda per crittografare e decrittografare le variabili di ambiente della funzione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-kmskeyarn)` `AWS::Lambda::Function`

 `Layers`   <a name="sam-function-layers"></a>
L'elenco di ciò `LayerVersion` ARNs che questa funzione dovrebbe usare. L'ordine specificato qui è l'ordine in cui verranno importati durante l'esecuzione della funzione Lambda. La versione è un ARN completo che include la versione o un riferimento a una LayerVersion risorsa. Ad esempio, un riferimento a `LayerVersion` sarà `!Ref MyLayer` mentre lo sarà un ARN completo, inclusa la versione. `arn:aws:lambda:region:account-id:layer:layer-name:version`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Layers](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-layers)` proprietà di una `AWS::Lambda::Function` risorsa.

 `LoggingConfig`   <a name="sam-function-loggingconfig"></a>
Le impostazioni di configurazione di Amazon CloudWatch Logs della funzione.  
*Tipo:* [LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-loggingconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-loggingconfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-loggingconfig)proprietà di una `AWS::Lambda::Function` risorsa.

 `MemorySize`   <a name="sam-function-memorysize"></a>
La dimensione della memoria in MB allocata per invocazione della funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MemorySize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-memorysize)` proprietà di una risorsa. `AWS::Lambda::Function`

 `PackageType`   <a name="sam-function-packagetype"></a>
Il tipo di pacchetto di distribuzione della funzione Lambda. Per ulteriori informazioni, consulta i [pacchetti di distribuzione Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html) nella *AWS Lambda Developer* Guide.  
**Note:**  
1. Se questa proprietà è impostata su `Zip` (impostazione predefinita), allora `InlineCode` si applica `CodeUri` o `ImageUri` viene ignorata.  
2. Se questa proprietà è impostata su`Image`, viene `ImageUri` applicata solo `CodeUri` ed entrambe le proprietà `InlineCode` vengono ignorate. Il repository Amazon ECR necessario per archiviare l'immagine del contenitore della funzione può essere creato automaticamente da. AWS SAMCLI Per ulteriori informazioni, consulta [sam deploy](sam-cli-command-reference-sam-deploy.md).  
*Valori validi*: `Zip` o `Image`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Default*: `Zip`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[PackageType](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-packagetype)` proprietà di una `AWS::Lambda::Function` risorsa.

 `PermissionsBoundary`   <a name="sam-function-permissionsboundary"></a>
L'ARN di un limite di autorizzazioni da utilizzare per il ruolo di esecuzione di questa funzione. Questa proprietà funziona solo se il ruolo viene generato automaticamente.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[PermissionsBoundary](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-permissionsboundary)` proprietà di una `AWS::IAM::Role` risorsa.

 `Policies`   <a name="sam-function-policies"></a>
Politiche di autorizzazione per questa funzione. Le politiche verranno aggiunte al ruolo di esecuzione predefinito AWS Identity and Access Management (IAM) della funzione.  
Questa proprietà accetta un singolo valore o un elenco di valori. I valori autorizzati includono:  
+ [AWS SAM modelli di policy](serverless-policy-templates.md).
+ ARNDi una [politica AWS gestita o di una politica](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) [gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies).
+ Il nome di una politica AWS gestita dall'[elenco](https://github.com/aws/serverless-application-model/blob/develop/samtranslator/internal/data/aws_managed_policies.json) seguente.
+ Una [politica IAM in linea](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#inline-policies) formattata YAML come mappa.
Se si imposta la `Role` proprietà, questa proprietà viene ignorata.
*Tipo*: Stringa \$1 Elenco \$1 Mappa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[Policies](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-policies)` proprietà di una `AWS::IAM::Role` risorsa.

 `PublishToLatestPublished`   <a name="sam-function-publishtolatestpublished"></a>
Speciifica se pubblicare la versione più recente della funzione quando la funzione viene aggiornata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[PublishToLatestPublished](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-publishtolatestpublished)` proprietà di una `AWS::Lambda::Function` risorsa.

`PropagateTags`  <a name="sam-function-propagatetags"></a>
Indica se passare o meno i tag dalla `Tags` proprietà alle risorse [AWS::Serverless::Function](sam-specification-generated-resources-function.md) generate. `True`Specificate di propagare i tag nelle risorse generate.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `False`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `ProvisionedConcurrencyConfig`   <a name="sam-function-provisionedconcurrencyconfig"></a>
La configurazione simultanea fornita dell'alias di una funzione.  
`ProvisionedConcurrencyConfig`può essere specificato solo se è impostato. `AutoPublishAlias` In caso contrario, si verifica un errore.
*Tipo:* [ProvisionedConcurrencyConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html#cfn-lambda-alias-provisionedconcurrencyconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ProvisionedConcurrencyConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html#cfn-lambda-alias-provisionedconcurrencyconfig)` proprietà di una `AWS::Lambda::Alias` risorsa.

 `RecursiveLoop`   <a name="sam-function-recursiveloop"></a>
Lo stato della configurazione di rilevamento ricorsivo del loop della funzione.  
Quando questo valore è impostato su `Allow` e Lambda rileva che la funzione viene richiamata come parte di un ciclo ricorsivo, non esegue alcuna azione.  
Quando questo valore è impostato su `Terminate` e Lambda rileva che la funzione viene richiamata come parte di un ciclo ricorsivo, interrompe la chiamata della funzione e invia una notifica all'utente.   
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà della risorsa. `[RecursiveLoop](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-recursiveloop)` `AWS::Lambda::Function`

 `ReservedConcurrentExecutions`   <a name="sam-function-reservedconcurrentexecutions"></a>
Il numero massimo di esecuzioni simultanee che si desidera riservare per la funzione.  
*Per ulteriori informazioni su questa proprietà, consulta [Lambda Function Scaling](https://docs.aws.amazon.com/lambda/latest/dg/scaling.html) nella Developer Guide.AWS Lambda *  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ReservedConcurrentExecutions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-reservedconcurrentexecutions)` proprietà di una `AWS::Lambda::Function` risorsa.

 `Role`   <a name="sam-function-role"></a>
L'ARN di un ruolo IAM da utilizzare come ruolo di esecuzione di questa funzione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-role)` proprietà di una `AWS::Lambda::Function` risorsa. È obbligatorio in CloudFormation ma non in AWS SAM. Se non viene specificato un ruolo, ne viene creato uno con un ID logico di`<function-logical-id>Role`.

 `RolePath`   <a name="sam-function-rolepath"></a>
Il percorso del ruolo di esecuzione IAM della funzione.  
Usa questa proprietà quando il ruolo viene generato per te. Non utilizzare quando il ruolo è specificato con la `Role` proprietà.  
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Path](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-path)` proprietà di una `AWS::IAM::Role` risorsa.

 `Runtime`   <a name="sam-function-runtime"></a>
L'identificatore del [runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) della funzione. Questa proprietà è richiesta solo se la `PackageType` proprietà è impostata su`Zip`.  
Se si specifica l'`provided`identificatore per questa proprietà, è possibile utilizzare l'attributo `Metadata` resource per indicare di AWS SAM creare il runtime personalizzato richiesto da questa funzione. Per ulteriori informazioni sulla creazione di runtime personalizzati, vedere. [Creazione di funzioni Lambda con runtime personalizzati in AWS SAM](building-custom-runtimes.md)
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Runtime](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-runtime)` proprietà di una `AWS::Lambda::Function` risorsa.

 `RuntimeManagementConfig`   <a name="sam-function-runtimemanagementconfig"></a>
Configura le opzioni di gestione del runtime per le funzioni Lambda, come gli aggiornamenti dell'ambiente di runtime, il comportamento di rollback e la selezione di una versione di runtime specifica. Per saperne di più, consulta [gli aggiornamenti del runtime di Lambda](https://docs.aws.amazon.com//lambda/latest/dg/runtimes-update.html) nella *AWS Lambda Developer* Guide.  
*Tipo:* [RuntimeManagementConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-runtimemanagementconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ RuntimeManagementConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-runtimemanagementconfig.html)` proprietà di una `AWS::Lambda::Function` risorsa.

 `SnapStart`   <a name="sam-function-snapstart"></a>
Crea un'istantanea di ogni nuova versione della funzione Lambda. Un'istantanea è uno stato memorizzato nella cache della funzione inizializzata, incluse tutte le sue dipendenze. La funzione viene inizializzata una sola volta e lo stato memorizzato nella cache viene riutilizzato per tutte le future chiamate, migliorando le prestazioni dell'applicazione riducendo il numero di volte in cui la funzione deve essere inizializzata. Per ulteriori informazioni, consulta [Migliorare le prestazioni di avvio con Lambda SnapStart nella Guida](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) per gli *AWS Lambda sviluppatori*.  
*Tipo:* [SnapStart](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-snapstart.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[SnapStart](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-snapstart.html)` proprietà di una `AWS::Lambda::Function` risorsa.

 `SourceKMSKeyArn`   <a name="sam-function-sourcekmskeyarn"></a>
Rappresenta l'ARN di una chiave KMS utilizzata per crittografare il codice della funzione ZIP del cliente.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[SourceKMSKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-sourcekmskeyarn)` proprietà di un `AWS::Lambda::Function` `Code` tipo di dati.

 `Tags`   <a name="sam-function-tags"></a>
Una mappa (da stringa a stringa) che specifica i tag aggiunti a questa funzione. Per informazioni dettagliate sulle chiavi e i valori validi per i tag, consulta [Tag Key and Value Requirements](https://docs.aws.amazon.com/lambda/latest/dg/configuration-tags.html#configuration-tags-restrictions) nella *AWS Lambda Developer Guide*.  
Quando lo stack viene creato, aggiunge AWS SAM automaticamente un `lambda:createdBy:SAM` tag a questa funzione Lambda e ai ruoli predefiniti generati per questa funzione.  
*Tipo: Mappa*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-tags)` proprietà di una `AWS::Lambda::Function` risorsa. La `Tags` proprietà in AWS SAM è costituita da coppie chiave-valore (mentre in CloudFormation questa proprietà è costituita da un elenco di `Tag` oggetti). Inoltre, aggiunge AWS SAM automaticamente un `lambda:createdBy:SAM` tag a questa funzione Lambda e ai ruoli predefiniti generati per questa funzione.

 `TenancyConfig`   <a name="sam-function-tenancyconfig"></a>
Configurazione per la modalità di isolamento dei tenant Lambda. Assicura che gli ambienti di esecuzione non vengano mai condivisi tra tenant diversi IDs, fornendo un isolamento a livello di calcolo per le applicazioni multi-tenant.  
*Tipo:* [TenancyConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-tenancyconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[TenancyConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-tenancyconfig)` `AWS::Lambda::Function`

 `Timeout`   <a name="sam-function-timeout"></a>
Il tempo massimo in secondi in cui la funzione può essere eseguita prima che venga interrotta.  
*Tipo*: integer  
*Obbligatorio:* no  
*Di default:* 3  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Timeout](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-timeout)` proprietà di una `AWS::Lambda::Function` risorsa.

 `Tracing`   <a name="sam-function-tracing"></a>
La stringa che specifica la modalità di tracciamento X-Ray della funzione.  
+ `Active`— Attiva il tracciamento a raggi X per la funzione.
+ `Disabled`— Disattiva X-Ray per la funzione.
+ `PassThrough`— Attiva il tracciamento a raggi X per la funzione. La decisione sul campionamento è delegata ai servizi a valle.
Se specificato come `Active` o `PassThrough` e la `Role` proprietà non è impostata, AWS SAM aggiunge la `arn:aws:iam::aws:policy/AWSXrayWriteOnlyAccess` politica al ruolo di esecuzione Lambda che crea per te.  
Per ulteriori informazioni su X-Ray, consulta [Using AWS Lambda with AWS X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html) nella *AWS Lambda Developer* Guide.  
*Valori validi*: [`Active`\$1 `Disabled` \$1`PassThrough`]  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[TracingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-tracingconfig)` proprietà di una `AWS::Lambda::Function` risorsa.

 `VersionDescription`   <a name="sam-function-versiondescription"></a>
Speciifica il `Description` campo che viene aggiunto alla nuova risorsa della versione Lambda.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-version.html#cfn-lambda-version-description)` proprietà di una `AWS::Lambda::Version` risorsa.

 `VersionDeletionPolicy`   <a name="sam-function-versiondeletionpolicy"></a>
Speciifica la politica di eliminazione per la risorsa della versione Lambda che viene creata `AutoPublishAlias` quando viene impostata. Questo controlla se la risorsa della versione viene mantenuta o eliminata quando lo stack viene eliminato.  
*Valori validi*: `Delete`, `Retain` o `Snapshot`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente. Imposta l'`DeletionPolicy`attributo sulla `AWS::Lambda::Version` risorsa generata.

 `VpcConfig`   <a name="sam-function-vpcconfig"></a>
La configurazione che consente a questa funzione di accedere alle risorse private all'interno del tuo cloud privato virtuale (VPC).  
*Tipo:* [VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-vpcconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-vpcconfig.html)` proprietà di una `AWS::Lambda::Function` risorsa.

## Valori restituiti
<a name="sam-resource-function-return-values"></a>

### Ref
<a name="sam-resource-function-return-values-ref"></a>

Quando l'ID logico di questa risorsa viene fornito alla funzione `Ref` intrinseca, restituisce il nome della risorsa della funzione Lambda sottostante.

*Per ulteriori informazioni sull'uso della `Ref` funzione, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)la Guida per l'AWS CloudFormation utente.* 

### Fn: GetAtt
<a name="sam-resource-function-return-values-fn--getatt"></a>

`Fn::GetAtt` restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio. 

Per ulteriori informazioni sull'utilizzo`Fn::GetAtt`, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html)la *Guida per l'AWS CloudFormation utente*. 

`Arn`  <a name="Arn-fn::getatt"></a>
L'ARN della funzione Lambda sottostante.

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

### Funzione semplice
<a name="sam-resource-function-examples-simple-function"></a>

Di seguito è riportato un esempio di base di una [AWS::Serverless::Function](#sam-resource-function) risorsa di tipo di pacchetto `Zip` (impostazione predefinita) e codice funzione in un bucket Amazon S3.

#### YAML
<a name="sam-resource-function-examples-simple-function--yaml"></a>

```
Type: AWS::Serverless::Function
Properties:
  Handler: index.handler
  Runtime: python3.9
  CodeUri: s3://bucket-name/key-name
```

### Esempio di proprietà delle funzioni
<a name="sam-resource-function-examples-function-properties-example"></a>

Di seguito è riportato un esempio di un tipo [AWS::Serverless::Function](#sam-resource-function) di pacchetto `Zip` (impostazione predefinita) che utilizza `InlineCode``Layers`,`Tracing`,`Policies`,`Amazon EFS`, e un'origine di `Api` eventi.

#### YAML
<a name="sam-resource-function-examples-function-properties-example--yaml"></a>

```
Type: AWS::Serverless::Function
DependsOn: MyMountTarget        # This is needed if an AWS::EFS::MountTarget resource is declared for EFS
Properties:
  Handler: index.handler
  Runtime: python3.9
  InlineCode: |
    def handler(event, context):
      print("Hello, world!")
  ReservedConcurrentExecutions: 30
  Layers:
    - Ref: MyLayer
  Tracing: Active
  Timeout: 120
  FileSystemConfigs:
    - Arn: !Ref MyEfsFileSystem
      LocalMountPath: /mnt/EFS
  Policies:
    - AWSLambdaExecute
    - Version: '2012-10-17		 	 	 ' 
      Statement:
        - Effect: Allow
          Action:
            - s3:GetObject
            - s3:GetObjectACL
          Resource: 'arn:aws:s3:::sam-s3-demo-bucket/*'
  Events:
    ApiEvent:
      Type: Api
      Properties:
        Path: /path
        Method: get
```

### ImageConfig esempio
<a name="sam-resource-function-examples-imageconfig-example"></a>

Di seguito è riportato un esempio di una funzione `ImageConfig` for a Lambda di tipo pacchetto. `Image`

#### YAML
<a name="sam-resource-function-examples-imageconfig-example--yaml"></a>

```
HelloWorldFunction:
  Type: AWS::Serverless::Function
  Properties:
    PackageType: Image
    ImageUri: account-id.dkr.ecr.region.amazonaws.com/ecr-repo-name:image-name
    ImageConfig:
      Command:
        - "app.lambda_handler"
      EntryPoint:
        - "entrypoint1"
      WorkingDirectory: "workDir"
```

### RuntimeManagementConfig esempi
<a name="sam-resource-function-examples-runtimemanagementconfig-examples"></a>

Una funzione Lambda configurata per aggiornare il suo ambiente di runtime in base al comportamento corrente:

```
TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    Runtime: python3.9
    RuntimeManagementConfig:
      UpdateRuntimeOn: Auto
```

Una funzione Lambda configurata per aggiornare il suo ambiente di runtime quando la funzione viene aggiornata:

```
TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    Runtime: python3.9
    RuntimeManagementConfig:
      UpdateRuntimeOn: FunctionUpdate
```

Una funzione Lambda configurata per aggiornare manualmente il suo ambiente di runtime:

```
TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    Runtime: python3.9
    RuntimeManagementConfig:
      RuntimeVersionArn: arn:aws:lambda:us-east-1::runtime:4c459dd0104ee29ec65dcad056c0b3ddbe20d6db76b265ade7eda9a066859b1e
      UpdateRuntimeOn: Manual
```

### SnapStart esempi
<a name="sam-resource-function-examples-snapstart-examples"></a>

Esempio di una funzione Lambda SnapStart attivata per le versioni future:

```
TestFunc
  Type: AWS::Serverless::Function
  Properties:
    ...
    SnapStart:
      ApplyOn: PublishedVersions
```

### TenancyConfig esempi
<a name="sam-resource-function-examples-tenancyconfig-examples"></a>

Esempio di una funzione Lambda con la modalità di isolamento del tenant attivata:

```
TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    TenancyConfig:
      TenantIsolationMode: PER_TENANT
```

# DeadLetterQueue
<a name="sam-property-function-deadletterqueue"></a>

Specifica una coda SQS o un argomento SNS a cui ( AWS Lambda Lambda) invia eventi quando non è in grado di elaborarli. *Per ulteriori informazioni sulla funzionalità Dead Letter Queue, consulta [Dead-letter](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-dlq) queues nella Developer Guide.AWS Lambda *

SAM aggiungerà automaticamente l'autorizzazione appropriata al ruolo di esecuzione della funzione Lambda per consentire al servizio Lambda di accedere alla risorsa. sqs: SendMessage verrà aggiunto per le code SQS e SNS:Publish per gli argomenti SNS.

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

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

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

```
  [TargetArn](#sam-function-deadletterqueue-targetarn): String
  [Type](#sam-function-deadletterqueue-type): String
```

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

 `TargetArn`   <a name="sam-function-deadletterqueue-targetarn"></a>
L'Amazon Resource Name (ARN) di una coda di Amazon SQS o Amazon SNS.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[TargetArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-deadletterconfig.html#cfn-lambda-function-deadletterconfig-targetarn)` proprietà del tipo di `AWS::Lambda::Function` `DeadLetterConfig` dati.

 `Type`   <a name="sam-function-deadletterqueue-type"></a>
Il tipo di coda di lettere morte.  
*Valori validi*: `SNS`, `SQS`  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### DeadLetterQueue
<a name="sam-property-function-deadletterqueue--examples--deadletterqueue"></a>

Esempio di Dead Letter Queue per un argomento SNS.

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

```
DeadLetterQueue:
  Type: SNS
  TargetArn: arn:aws:sns:us-east-2:123456789012:my-topic
```

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

# Hooks
<a name="sam-property-function-hooks"></a>

Funzioni Lambda di convalida eseguite prima e dopo lo spostamento del traffico.

**Nota**  
Le funzioni Lambda a cui si fa riferimento in questa proprietà configurano l'`CodeDeployLambdaAliasUpdate`oggetto della risorsa risultante. [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-alias.html) Per ulteriori informazioni, consulta [CodeDeployLambdaAliasUpdate Policy nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatepolicy.html#cfn-attributes-updatepolicy-codedeploylambdaaliasupdate) per l'*AWS CloudFormation utente*.

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

```
  [PostTraffic](#sam-function-hooks-posttraffic): String
  [PreTraffic](#sam-function-hooks-pretraffic): String
```

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

 `PostTraffic`   <a name="sam-function-hooks-posttraffic"></a>
Funzione Lambda che viene eseguita dopo lo spostamento del traffico.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `PreTraffic`   <a name="sam-function-hooks-pretraffic"></a>
Funzione Lambda che viene eseguita prima dello spostamento del traffico.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Hook
<a name="sam-property-function-hooks--examples--hooks"></a>

Esempi di funzioni hook

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

```
Hooks:
  PreTraffic:
    Ref: PreTrafficLambdaFunction
  PostTraffic:
    Ref: PostTrafficLambdaFunction
```

# DurableConfig
<a name="sam-property-function-durableconfig"></a>

Configura impostazioni di esecuzione durevoli per le AWS Lambda funzioni. Le funzioni durevoli possono funzionare fino a un anno e controllano automaticamente i progressi, consentendo flussi di lavoro a lunga durata e applicazioni con tolleranza ai guasti. Per ulteriori informazioni sulle funzioni durevoli, consulta [Funzioni durevoli Lambda nella Guida](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html) per gli *AWS Lambda sviluppatori*.

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

```
  [ExecutionTimeout](#sam-function-durableconfig-executiontimeout): Integer
  [RetentionPeriodInDays](#sam-function-durableconfig-retentionperiodindays): Integer
```

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

 `ExecutionTimeout`   <a name="sam-function-durableconfig-executiontimeout"></a>
La quantità di tempo (in secondi) in cui Lambda consente a una funzione durevole di funzionare prima di interromperla. Il massimo è un anno di 366 giorni o 31.622.400 secondi.  
*Tipo*: integer  
*Obbligatorio:* sì  
*Minimo*: 1  
*Massimo: 3162.400*  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ExecutionTimeout](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-durableconfig.html#cfn-lambda-function-durableconfig-executiontimeout)` proprietà del tipo di `AWS::Lambda::Function` `DurableConfig` dati.

 `RetentionPeriodInDays`   <a name="sam-function-durableconfig-retentionperiodindays"></a>
Il numero di giorni dopo la chiusura di un'esecuzione durevole in cui Lambda conserva la cronologia, da uno a 90 giorni. L'impostazione di default è 14 giorni.  
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 14  
*Minimo*: 1  
*Massimo*: 90  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[RetentionPeriodInDays](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-durableconfig.html#cfn-lambda-function-durableconfig-retentionperiodindays)` proprietà del tipo di `AWS::Lambda::Function` `DurableConfig` dati.

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

### DurableConfig
<a name="sam-property-function-durableconfig--examples--durableconfig"></a>

Esempio di configurazione durevole per una funzione con un timeout di esecuzione di 1 ora e un periodo di conservazione di 7 giorni.

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

```
DurableConfig:
  ExecutionTimeout: 3600
  RetentionPeriodInDays: 7
```

# EventInvokeConfiguration
<a name="sam-property-function-eventinvokeconfiguration"></a>

Opzioni di configurazione per le chiamate [asincrone](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) di Lambda Alias o Version.

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

```
  [DestinationConfig](#sam-function-eventinvokeconfiguration-destinationconfig): EventInvokeDestinationConfiguration
  [MaximumEventAgeInSeconds](#sam-function-eventinvokeconfiguration-maximumeventageinseconds): Integer
  [MaximumRetryAttempts](#sam-function-eventinvokeconfiguration-maximumretryattempts): Integer
```

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

 `DestinationConfig`   <a name="sam-function-eventinvokeconfiguration-destinationconfig"></a>
Oggetto di configurazione che specifica la destinazione di un evento dopo che Lambda lo elabora.  
*Tipo:* [EventInvokeDestinationConfiguration](sam-property-function-eventinvokedestinationconfiguration.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-destinationconfig.html)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa. SAM richiede un parametro aggiuntivo, «Type», che non esiste in CloudFormation.

 `MaximumEventAgeInSeconds`   <a name="sam-function-eventinvokeconfiguration-maximumeventageinseconds"></a>
L'età massima di una richiesta inviata da Lambda a una funzione per l'elaborazione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumEventAgeInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventinvokeconfig.html#cfn-lambda-eventinvokeconfig-maximumeventageinseconds)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa.

 `MaximumRetryAttempts`   <a name="sam-function-eventinvokeconfiguration-maximumretryattempts"></a>
Il numero massimo di tentativi da ripetere prima che la funzione restituisca un errore.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRetryAttempts](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventinvokeconfig.html#cfn-lambda-eventinvokeconfig-maximumretryattempts)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa.

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

### MaximumEventAgeInSeconds
<a name="sam-property-function-eventinvokeconfiguration--examples--maximumeventageinseconds"></a>

MaximumEventAgeInSeconds esempio

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

```
EventInvokeConfig:
  MaximumEventAgeInSeconds: 60
  MaximumRetryAttempts: 2
  DestinationConfig:
    OnSuccess:
      Type: SQS
      Destination: arn:aws:sqs:us-west-2:012345678901:my-queue
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn
```

# EventInvokeDestinationConfiguration
<a name="sam-property-function-eventinvokedestinationconfiguration"></a>

Oggetto di configurazione che specifica la destinazione di un evento dopo che Lambda lo elabora.

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

```
  [OnFailure](#sam-function-eventinvokedestinationconfiguration-onfailure): OnFailure
  [OnSuccess](#sam-function-eventinvokedestinationconfiguration-onsuccess): OnSuccess
```

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

 `OnFailure`   <a name="sam-function-eventinvokedestinationconfiguration-onfailure"></a>
Destinazione per gli eventi la cui elaborazione non è riuscita.  
*Tipo:* [OnFailure](sam-property-function-onfailure.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onfailure.html)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa. Richiede `Type` una proprietà aggiuntiva solo per SAM.

 `OnSuccess`   <a name="sam-function-eventinvokedestinationconfiguration-onsuccess"></a>
Destinazione per gli eventi che sono stati elaborati correttamente.  
*Tipo:* [OnSuccess](sam-property-function-onsuccess.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[OnSuccess](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onsuccess)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa. Richiede `Type` una proprietà aggiuntiva solo per SAM.

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

### OnSuccess
<a name="sam-property-function-eventinvokedestinationconfiguration--examples--onsuccess"></a>

OnSuccess esempio

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

```
EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SQS
      Destination: arn:aws:sqs:us-west-2:012345678901:my-queue
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn
```

# OnFailure
<a name="sam-property-function-onfailure"></a>

Destinazione per gli eventi la cui elaborazione non è riuscita.

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

```
  [Destination](#sam-function-onfailure-destination): String
  [Type](#sam-function-onfailure-type): String
```

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

 `Destination`   <a name="sam-function-onfailure-destination"></a>
L'Amazon Resource Name (ARN) della risorsa di destinazione.  
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onfailure.html)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa. SAM aggiungerà tutte le autorizzazioni necessarie al ruolo IAM generato automaticamente associato a questa funzione per accedere alla risorsa a cui si fa riferimento in questa proprietà.  
*Note aggiuntive*: se il tipo è Lambda/EventBridge, è richiesta la destinazione.

 `Type`   <a name="sam-function-onfailure-type"></a>
Tipo di risorsa a cui si fa riferimento nella destinazione. I tipi supportati sono`SQS`,`SNS`, `S3``Lambda`, e`EventBridge`.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.  
*Note aggiuntive*: se il tipo è SQS/SNS e la `Destination` proprietà viene lasciata vuota, la SQS/SNS risorsa viene generata automaticamente da SAM. Per fare riferimento alla risorsa, usa `<function-logical-id>.DestinationQueue` per SQS o `<function-logical-id>.DestinationTopic` per SNS. Se il tipo è Lambda/EventBridge, `Destination` è obbligatorio.

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

### EventInvoke Esempio di configurazione con destinazioni SQS e Lambda
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sqs-and-lambda-destinations"></a>

In questo esempio non viene fornita alcuna destinazione per la OnSuccess configurazione SQS, quindi SAM crea implicitamente una coda SQS e aggiunge le autorizzazioni necessarie. Inoltre, in questo esempio, nella OnFailure configurazione viene specificata una destinazione per una risorsa Lambda dichiarata nel file modello, quindi SAM aggiunge le autorizzazioni necessarie a questa funzione Lambda per chiamare la funzione Lambda di destinazione.

#### YAML
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sqs-and-lambda-destinations--yaml"></a>

```
EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SQS
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn  # Arn of a Lambda function declared in the template file.
```

### EventInvoke Esempio di configurazione con destinazione SNS
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sns-destination"></a>

In questo esempio viene fornita una destinazione per un argomento SNS dichiarato nel file modello per la OnSuccess configurazione.

#### YAML
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sns-destination--yaml"></a>

```
EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SNS
      Destination:
        Ref: DestinationSNS       # Arn of an SNS topic declared in the tempate file
```

# OnSuccess
<a name="sam-property-function-onsuccess"></a>

Destinazione per gli eventi che sono stati elaborati correttamente.

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

```
  [Destination](#sam-function-onsuccess-destination): String
  [Type](#sam-function-onsuccess-type): String
```

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

 `Destination`   <a name="sam-function-onsuccess-destination"></a>
L'Amazon Resource Name (ARN) della risorsa di destinazione.  
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[OnSuccess](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onsuccess)` proprietà di una `AWS::Lambda::EventInvokeConfig` risorsa. SAM aggiungerà tutte le autorizzazioni necessarie al ruolo IAM generato automaticamente associato a questa funzione per accedere alla risorsa a cui si fa riferimento in questa proprietà.  
*Note aggiuntive*: se il tipo è Lambda/EventBridge, è richiesta la destinazione.

 `Type`   <a name="sam-function-onsuccess-type"></a>
Tipo di risorsa a cui si fa riferimento nella destinazione. I tipi supportati sono`SQS`,`SNS`, `S3``Lambda`, e`EventBridge`.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.  
*Note aggiuntive*: se il tipo è SQS/SNS e la `Destination` proprietà viene lasciata vuota, la SQS/SNS risorsa viene generata automaticamente da SAM. Per fare riferimento alla risorsa, usa `<function-logical-id>.DestinationQueue` per SQS o `<function-logical-id>.DestinationTopic` per SNS. Se il tipo è Lambda/EventBridge, `Destination` è obbligatorio.

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

### EventInvoke Esempio di configurazione con destinazioni SQS e Lambda
<a name="sam-property-function-onsuccess--examples--eventinvoke-configuration-example-with-sqs-and-lambda-destinations"></a>

In questo esempio non viene fornita alcuna destinazione per la OnSuccess configurazione SQS, quindi SAM crea implicitamente una coda SQS e aggiunge le autorizzazioni necessarie. Inoltre, in questo esempio, nella OnFailure configurazione viene specificata una destinazione per una risorsa Lambda dichiarata nel file modello, quindi SAM aggiunge le autorizzazioni necessarie a questa funzione Lambda per chiamare la funzione Lambda di destinazione.

#### YAML
<a name="sam-property-function-onsuccess--examples--eventinvoke-configuration-example-with-sqs-and-lambda-destinations--yaml"></a>

```
EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SQS
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn  # Arn of a Lambda function declared in the template file.
```

### EventInvoke Esempio di configurazione con destinazione SNS
<a name="sam-property-function-onsuccess--examples--eventinvoke-configuration-example-with-sns-destination"></a>

In questo esempio viene fornita una destinazione per un argomento SNS dichiarato nel file modello per la OnSuccess configurazione.

#### YAML
<a name="sam-property-function-onsuccess--examples--eventinvoke-configuration-example-with-sns-destination--yaml"></a>

```
EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SNS
      Destination:
        Ref: DestinationSNS       # Arn of an SNS topic declared in the tempate file
```

# EventSource
<a name="sam-property-function-eventsource"></a>

L'oggetto che descrive l'origine degli eventi che attivano la funzione. Ogni evento è costituito da un tipo e da un insieme di proprietà che dipendono da quel tipo. Per ulteriori informazioni sulle proprietà di ciascuna fonte di eventi, consultate l'argomento corrispondente a quel tipo.

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

```
  [Properties](#sam-function-eventsource-properties): AlexaSkill | Api | CloudWatchEvent | CloudWatchLogs | Cognito | DocumentDB | DynamoDB | EventBridgeRule | HttpApi | IoTRule | Kinesis | MQ | MSK | S3 | Schedule | ScheduleV2 | SelfManagedKafka | SNS | SQS
  [Type](#sam-function-eventsource-type): String
```

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

 `Properties`   <a name="sam-function-eventsource-properties"></a>
Oggetto che descrive le proprietà di questa mappatura degli eventi. L'insieme di proprietà deve essere conforme al tipo definito.  
*Tipo* [[[[: [AlexaSkill](sam-property-function-alexaskill.md)\$1 [Api](sam-property-function-api.md) \$1 \$1 [CloudWatchEvent](sam-property-function-cloudwatchevent.md)\$1 [Cognito [CloudWatchLogs](sam-property-function-cloudwatchlogs.md)](sam-property-function-cognito.md)\$1 DocumentDB \$1 [[DynamoDB](sam-property-function-dynamodb.md)](sam-property-function-documentdb.md) \$1 \$1 [Io \$1 Kinesis \$1 [MQ EventBridgeRule[EventBridgeRule](sam-property-function-eventbridgerule.md)](sam-property-function-msk.md) \$1 MSK HttpApi[HttpApi](sam-property-function-httpapi.md) \$1 S3 TRule](sam-property-function-iotrule.md)[\$1 Pianificazione](sam-property-function-kinesis.md)[\$1 ScheduleV2 [\$1](sam-property-function-mq.md) \$1 SNS \$1 SQS [SelfManagedKafka](sam-property-function-selfmanagedkafka.md)](sam-property-function-s3.md)](sam-property-function-sqs.md)](sam-property-function-sns.md)](sam-property-function-schedulev2.md)](sam-property-function-schedule.md)  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: Questa proprietà è unica e non ha un equivalente. AWS SAM CloudFormation 

 `Type`   <a name="sam-function-eventsource-type"></a>
Il tipo di evento,  
*Valori validi*: `AlexaSkill` `Api``CloudWatchEvent`,`CloudWatchLogs`,`Cognito`,`DocumentDB`,`DynamoDB`,`EventBridgeRule`,`HttpApi`,`IoTRule`,`Kinesis`, `MQ``MSK`,`S3`,`Schedule`,`ScheduleV2`,`SelfManagedKafka`,`SNS`, `SQS`  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### APIEvent
<a name="sam-property-function-eventsource--examples--apievent"></a>

Esempio di utilizzo di un evento API

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

```
ApiEvent:
  Type: Api
  Properties:
    Method: get
    Path: /group/{user}
    RestApiId: 
      Ref: MyApi
```

# AlexaSkill
<a name="sam-property-function-alexaskill"></a>

L'oggetto che descrive un tipo di origine `AlexaSkill` dell'evento.

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

```
  [SkillId](#sam-function-alexaskill-skillid): String
```

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

 `SkillId`   <a name="sam-function-alexaskill-skillid"></a>
L'Alexa Skill ID per la tua Alexa Skill. Per ulteriori informazioni su Skill ID, consulta [Configurare il trigger per una funzione Lambda nella documentazione](https://developer.amazon.com/docs/custom-skills/host-a-custom-skill-as-an-aws-lambda-function.html#configuring-the-alexa-skills-kit-trigger) di Alexa Skills Kit.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### AlexaSkillTrigger
<a name="sam-property-function-alexaskill--examples--alexaskilltrigger"></a>

Esempio di evento Alexa Skill

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

```
AlexaSkillEvent:
  Type: AlexaSkill
```

# Api
<a name="sam-property-function-api"></a>

L'oggetto che descrive un tipo di origine `Api` dell'evento. Se viene definita una [AWS::Serverless::Api](sam-resource-api.md) risorsa, i valori del percorso e del metodo devono corrispondere a un'operazione nella definizione OpenAPI dell'API.

Se [AWS::Serverless::Api](sam-resource-api.md) è definito no, la funzione input e output sono una rappresentazione della richiesta HTTP e della risposta HTTP.

Ad esempio, utilizzando l' JavaScript API, il codice di stato e il corpo della risposta possono essere controllati restituendo un oggetto con le chiavi statusCode e body.

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

```
  [Auth](#sam-function-api-auth): ApiFunctionAuth
  [Method](#sam-function-api-method): String
  [Path](#sam-function-api-path): String
  [RequestModel](#sam-function-api-requestmodel): RequestModel
  [RequestParameters](#sam-function-api-requestparameters): List of [ String | RequestParameter ]
  [RestApiId](#sam-function-api-restapiid): String
  [ResponseTransferMode](#sam-function-api-responsetransfermode): String
  TimeoutInMillis: Integer
```

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

 `Auth`   <a name="sam-function-api-auth"></a>
Configurazione di autenticazione per questo metodo Api\$1Path\$1specifico.  
Utile per sovrascrivere l'`DefaultAuthorizer`impostazione auth config dell'API su un singolo percorso quando non è specificato no `DefaultAuthorizer` o per sovrascrivere l'impostazione predefinita. `ApiKeyRequired`  
*Tipo:* [ApiFunctionAuth](sam-property-function-apifunctionauth.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Method`   <a name="sam-function-api-method"></a>
Metodo HTTP per il quale viene richiamata questa funzione. Le opzioni includono `DELETE``GET`,`HEAD`,`OPTIONS`,`PATCH`, `POST``PUT`, e`ANY`. Per ulteriori informazioni, consulta [Configurare un metodo HTTP](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-settings-method-request.html#setup-method-add-http-method) nella *Guida per gli sviluppatori di API Gateway*.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Path`   <a name="sam-function-api-path"></a>
Percorso Uri per il quale viene richiamata questa funzione. Deve iniziare con`/`.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `RequestModel`   <a name="sam-function-api-requestmodel"></a>
Richiedi il modello da utilizzare per questo specifico metodo Api\$1Path\$1. Questo dovrebbe fare riferimento al nome di un modello specificato nella `Models` sezione di una risorsa. [AWS::Serverless::Api](sam-resource-api.md)  
*Tipo:* [RequestModel](sam-property-function-requestmodel.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `RequestParameters`   <a name="sam-function-api-requestparameters"></a>
Richiedi la configurazione dei parametri per questo metodo Api\$1Path\$1 specifico. Tutti i nomi dei parametri devono iniziare con `method.request` e devono essere limitati a`method.request.header`, o. `method.request.querystring` `method.request.path`  
Un elenco può contenere sia stringhe di nomi di parametri che [RequestParameter](sam-property-function-requestparameter.md)oggetti. Per le stringhe, l'impostazione predefinita delle `Caching` proprietà `Required` and è. `false`  
*Tipo*: Elenco di [String \$1 [RequestParameter](sam-property-function-requestparameter.md)]  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `RestApiId`   <a name="sam-function-api-restapiid"></a>
Identificatore di una RestApi risorsa, che deve contenere un'operazione con il percorso e il metodo indicati. In genere, è impostato per fare riferimento a una [AWS::Serverless::Api](sam-resource-api.md) risorsa definita in questo modello.  
Se non definisci questa proprietà, AWS SAM crea una [AWS::Serverless::Api](sam-resource-api.md) risorsa predefinita utilizzando un `OpenApi` documento generato. Tale risorsa contiene un'unione di tutti i percorsi e i metodi definiti dagli `Api` eventi nello stesso modello che non specificano a`RestApiId`.  
Questo non può fare riferimento a una [AWS::Serverless::Api](sam-resource-api.md) risorsa definita in un altro modello.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

`ResponseTransferMode`  <a name="sam-function-api-responsetransfermode"></a>
La modalità di trasferimento della risposta per l'integrazione della funzione Lambda. Impostato per `RESPONSE_STREAM` abilitare lo streaming di risposte Lambda tramite API Gateway, permettendo alla funzione di trasmettere le risposte ai client. Se impostato su`RESPONSE_STREAM`, API Gateway utilizza l'API Lambda InvokeWithResponseStreaming .  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Valori validi*: `BUFFERED` \$1 `RESPONSE_STREAM`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigateway-method-integration.html#cfn-apigateway-method-integration-responsetransfermode](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigateway-method-integration.html#cfn-apigateway-method-integration-responsetransfermode)proprietà di un`AWS::ApiGateway::Method Integration`.

`TimeoutInMillis`  <a name="sam-function-api-timeoutinmillis"></a>
Timeout personalizzato tra 50 e 29.000 millisecondi.  
Quando si specifica questa proprietà, AWS SAM modifica la definizione OpenAPI. La definizione OpenAPI deve essere specificata in linea utilizzando la proprietà. `DefinitionBody` 
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 29.000 millisecondi o 29 secondi  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

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

### Esempio di base
<a name="sam-property-function-api--examples--apievent"></a>

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

```
Events:
  ApiEvent:
    Type: Api
    Properties:
      Path: /path
      Method: get
      RequestParameters:
        - method.request.header.Authorization
        - method.request.querystring.keyword:
            Required: true
            Caching: false
```

# ApiFunctionAuth
<a name="sam-property-function-apifunctionauth"></a>

Configura l'autorizzazione a livello di evento, per un'API, un percorso e un metodo specifici.

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

```
  [ApiKeyRequired](#sam-function-apifunctionauth-apikeyrequired): Boolean
  [AuthorizationScopes](#sam-function-apifunctionauth-authorizationscopes): List
  [Authorizer](#sam-function-apifunctionauth-authorizer): String
  [InvokeRole](#sam-function-apifunctionauth-invokerole): String
  OverrideApiAuth: Boolean
  [ResourcePolicy](#sam-function-apifunctionauth-resourcepolicy): ResourcePolicyStatement
```

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

 `ApiKeyRequired`   <a name="sam-function-apifunctionauth-apikeyrequired"></a>
Richiede una chiave API per questa API, percorso e metodo.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `AuthorizationScopes`   <a name="sam-function-apifunctionauth-authorizationscopes"></a>
Gli ambiti di autorizzazione da applicare a questa API, percorso e metodo.  
Gli ambiti specificati sostituiranno tutti gli ambiti applicati dalla `DefaultAuthorizer` proprietà, se l'hai specificata.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Authorizer`   <a name="sam-function-apifunctionauth-authorizer"></a>
Il `Authorizer` per una funzione specifica.  
Se hai specificato un autorizzatore globale per la tua `AWS::Serverless::Api` risorsa, puoi sovrascrivere l'autorizzatore impostando su. `Authorizer` `NONE` Per vedere un esempio, consulta [Sostituisci un autorizzatore globale per la tua API REST di Amazon API Gateway](#sam-property-function-apifunctionauth--examples--override).  
Se utilizzi la `DefinitionBody` proprietà di una `AWS::Serverless::Api` risorsa per descrivere la tua API, devi usare `OverrideApiAuth` with `Authorizer` per sovrascrivere l'autorizzazione globale. Per ulteriori informazioni, consulta `OverrideApiAuth`.
*Valori validi*: `AWS_IAM``NONE`, o l'ID logico per qualsiasi autorizzatore definito nel modello. AWS SAM   
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `InvokeRole`   <a name="sam-function-apifunctionauth-invokerole"></a>
Specifica l'uso `InvokeRole` per l'`AWS_IAM`autorizzazione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Default*: `CALLER_CREDENTIALS`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.  
*Note aggiuntive*: `CALLER_CREDENTIALS` maps to`arn:aws:iam:::<user>/`, che utilizza le credenziali del chiamante per richiamare l'endpoint.

`OverrideApiAuth`  <a name="sam-function-apifunctionauth-overrideapiauth"></a>
Specificate come `true` sovrascrivere la configurazione di autorizzazione globale della risorsa. `AWS::Serverless::Api` Questa proprietà è richiesta solo se si specifica un autorizzatore globale e si utilizza la `DefinitionBody` proprietà di una `AWS::Serverless::Api` risorsa per descrivere l'API.  
Quando specifichi `OverrideApiAuth` as`true`, AWS SAM sostituirà l'autorizzazione globale con tutti i valori forniti per`ApiKeyRequired`, `Authorizer` o. `ResourcePolicy` Pertanto, è necessario specificare almeno una di queste proprietà quando si utilizza. `OverrideApiAuth` Per vedere un esempio, consulta [Sostituisci un autorizzatore globale quando viene specificato for DefinitionBody AWS::Serverless::Api](#sam-property-function-apifunctionauth--examples--override2).
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `ResourcePolicy`   <a name="sam-function-apifunctionauth-resourcepolicy"></a>
Configura la politica delle risorse per questo percorso su un'API.  
*Tipo:* [ResourcePolicyStatement](sam-property-function-resourcepolicystatement.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Autenticazione della funzione
<a name="sam-property-function-apifunctionauth--examples--function-auth"></a>

L'esempio seguente specifica l'autorizzazione a livello di funzione.

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

```
Auth:
  ApiKeyRequired: true
  Authorizer: NONE
```

### Sostituisci un autorizzatore globale per la tua API REST di Amazon API Gateway
<a name="sam-property-function-apifunctionauth--examples--override"></a>

Puoi specificare un autorizzatore globale per la tua risorsa. `AWS::Serverless::Api` Di seguito è riportato un esempio che configura un autorizzatore globale predefinito:

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyApiWithLambdaRequestAuth:
    Type: AWS::Serverless::Api
    Properties:
      ...
      Auth:
        Authorizers:
          MyLambdaRequestAuth:
            FunctionArn: !GetAtt MyAuthFn.Arn
        DefaultAuthorizer: MyLambdaRequestAuth
```

Per sovrascrivere l'autorizzatore predefinito per la tua AWS Lambda funzione, puoi specificare as. `Authorizer` `NONE` Di seguito è riportato un esempio:

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  ...
  MyFn:
    Type: AWS::Serverless::Function
    Properties:
      ...
      Events:
        LambdaRequest:
          Type: Api
          Properties:
            RestApiId: !Ref MyApiWithLambdaRequestAuth
            Method: GET
            Auth:
              Authorizer: NONE
```

### Sostituisci un autorizzatore globale quando viene specificato for DefinitionBody AWS::Serverless::Api
<a name="sam-property-function-apifunctionauth--examples--override2"></a>

Quando si utilizza la `DefinitionBody` proprietà per descrivere la `AWS::Serverless::Api` risorsa, il metodo override precedente non funziona. Di seguito è riportato un esempio di utilizzo della `DefinitionBody` proprietà per una `AWS::Serverless::Api` risorsa:

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyApiWithLambdaRequestAuth:
    Type: AWS::Serverless::Api
    Properties:
      ...
      DefinitionBody:
        swagger: 2.0
        ...
        paths:
          /lambda-request:
            ...
      Auth:
        Authorizers:
          MyLambdaRequestAuth:
            FunctionArn: !GetAtt MyAuthFn.Arn
        DefaultAuthorizer: MyLambdaRequestAuth
```

Per sovrascrivere l'autorizzatore globale, utilizzate la `OverrideApiAuth` proprietà. Di seguito è riportato un esempio che utilizza `OverrideApiAuth` per sostituire l'autorizzatore globale con il valore fornito per: `Authorizer`

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyApiWithLambdaRequestAuth:
    Type: AWS::Serverless::Api
    Properties:
      ...
      DefinitionBody:
        swagger: 2-0
        ...
        paths:
          /lambda-request:
            ...
      Auth:
        Authorizers:
          MyLambdaRequestAuth:
            FunctionArn: !GetAtt MyAuthFn.Arn
        DefaultAuthorizer: MyLambdaRequestAuth
    
    MyAuthFn:
      Type: AWS::Serverless::Function
      ...
    
    MyFn:
      Type: AWS::Serverless::Function
        Properties:
          ...
          Events:
            LambdaRequest:
              Type: Api
              Properties:
                RestApiId: !Ref MyApiWithLambdaRequestAuth
                Method: GET
                Auth:
                  Authorizer: NONE
                  OverrideApiAuth: true
                Path: /lambda-token
```

# ResourcePolicyStatement
<a name="sam-property-function-resourcepolicystatement"></a>

Configura una politica delle risorse per tutti i metodi e i percorsi di un'API. Per ulteriori informazioni sulle politiche delle risorse, consulta [Controllare l'accesso a un'API con le politiche delle risorse di API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-resource-policies.html) nella *Guida per sviluppatori di API Gateway*.

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

```
  [AwsAccountBlacklist](#sam-function-resourcepolicystatement-awsaccountblacklist): List
  [AwsAccountWhitelist](#sam-function-resourcepolicystatement-awsaccountwhitelist): List
  [CustomStatements](#sam-function-resourcepolicystatement-customstatements): List
  [IntrinsicVpcBlacklist](#sam-function-resourcepolicystatement-intrinsicvpcblacklist): List
  [IntrinsicVpcWhitelist](#sam-function-resourcepolicystatement-intrinsicvpcwhitelist): List
  [IntrinsicVpceBlacklist](#sam-function-resourcepolicystatement-intrinsicvpceblacklist): List
  [IntrinsicVpceWhitelist](#sam-function-resourcepolicystatement-intrinsicvpcewhitelist): List
  [IpRangeBlacklist](#sam-function-resourcepolicystatement-iprangeblacklist): List
  [IpRangeWhitelist](#sam-function-resourcepolicystatement-iprangewhitelist): List
  [SourceVpcBlacklist](#sam-function-resourcepolicystatement-sourcevpcblacklist): List
  [SourceVpcWhitelist](#sam-function-resourcepolicystatement-sourcevpcwhitelist): List
```

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

 `AwsAccountBlacklist`   <a name="sam-function-resourcepolicystatement-awsaccountblacklist"></a>
Gli AWS account da bloccare.  
*Tipo*: elenco di String  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `AwsAccountWhitelist`   <a name="sam-function-resourcepolicystatement-awsaccountwhitelist"></a>
Gli AWS account da consentire. Per un esempio di utilizzo di questa proprietà, consulta la sezione Esempi in fondo a questa pagina.  
*Tipo*: elenco di String  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `CustomStatements`   <a name="sam-function-resourcepolicystatement-customstatements"></a>
Un elenco di istruzioni personalizzate sulla politica delle risorse da applicare a questa API. Per un esempio di utilizzo di questa proprietà, consulta la sezione Esempi in fondo a questa pagina.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `IntrinsicVpcBlacklist`   <a name="sam-function-resourcepolicystatement-intrinsicvpcblacklist"></a>
L'elenco dei cloud privati virtuali (VPCs) da bloccare, in cui ogni VPC è specificato come riferimento, ad esempio un [riferimento dinamico o una funzione `Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html) [intrinseca](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html). Per un esempio di utilizzo di questa proprietà, consultate la sezione Esempi in fondo a questa pagina.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `IntrinsicVpcWhitelist`   <a name="sam-function-resourcepolicystatement-intrinsicvpcwhitelist"></a>
L'elenco di VPCs to allow, in cui ogni VPC è specificato come riferimento, ad esempio un [riferimento dinamico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html) o una funzione `Ref` [intrinseca](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html).  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `IntrinsicVpceBlacklist`   <a name="sam-function-resourcepolicystatement-intrinsicvpceblacklist"></a>
[L'elenco degli endpoint VPC da bloccare, in cui ogni endpoint VPC è specificato come riferimento, ad esempio un riferimento [dinamico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html) o la funzione intrinseca. `Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `IntrinsicVpceWhitelist`   <a name="sam-function-resourcepolicystatement-intrinsicvpcewhitelist"></a>
[L'elenco degli endpoint VPC da consentire, in cui ogni endpoint VPC è specificato come riferimento, ad esempio un riferimento [dinamico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html) o la funzione intrinseca. `Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) Per un esempio di utilizzo di questa proprietà, consulta la sezione Esempi in fondo a questa pagina.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `IpRangeBlacklist`   <a name="sam-function-resourcepolicystatement-iprangeblacklist"></a>
Gli indirizzi IP o gli intervalli di indirizzi da bloccare. Per un esempio di utilizzo di questa proprietà, consulta la sezione Esempi nella parte inferiore di questa pagina.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `IpRangeWhitelist`   <a name="sam-function-resourcepolicystatement-iprangewhitelist"></a>
Gli indirizzi IP o gli intervalli di indirizzi da consentire.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `SourceVpcBlacklist`   <a name="sam-function-resourcepolicystatement-sourcevpcblacklist"></a>
Gli endpoint VPC o VPC di origine da bloccare. I nomi dei VPC di origine devono iniziare con `"vpc-"` e i nomi degli endpoint VPC di origine devono iniziare con. `"vpce-"` Per un esempio di utilizzo di questa proprietà, consulta la sezione Esempi nella parte inferiore di questa pagina.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `SourceVpcWhitelist`   <a name="sam-function-resourcepolicystatement-sourcevpcwhitelist"></a>
Gli endpoint VPC o VPC di origine da consentire. I nomi dei VPC di origine devono iniziare con `"vpc-"` e i nomi degli endpoint VPC di origine devono iniziare con. `"vpce-"`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

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

### Esempio di politica delle risorse
<a name="sam-property-function-resourcepolicystatement--examples--resource-policy-example"></a>

L'esempio seguente blocca due indirizzi IP e un VPC di origine e consente un AWS account.

#### YAML
<a name="sam-property-function-resourcepolicystatement--examples--resource-policy-example--yaml"></a>

```
Auth:
  ResourcePolicy:
    CustomStatements: [{
                         "Effect": "Allow",
                         "Principal": "*",
                         "Action": "execute-api:Invoke",
                         "Resource": "execute-api:/Prod/GET/pets",
                         "Condition": {
                           "IpAddress": {
                             "aws:SourceIp": "1.2.3.4"
                           }
                         }
                       }]
    IpRangeBlacklist:
      - "10.20.30.40"
      - "1.2.3.4"
    SourceVpcBlacklist:
      - "vpce-1a2b3c4d"
    AwsAccountWhitelist:
      - "111122223333"
    IntrinsicVpcBlacklist:
      - "{{resolve:ssm:SomeVPCReference:1}}" 
      - !Ref MyVPC
    IntrinsicVpceWhitelist:
      - "{{resolve:ssm:SomeVPCEReference:1}}" 
      - !Ref MyVPCE
```

# RequestModel
<a name="sam-property-function-requestmodel"></a>

Configura un modello di richiesta per uno specifico metodo Api\$1Path\$1.

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

```
  [Model](#sam-function-requestmodel-model): String
  [Required](#sam-function-requestmodel-required): Boolean
  [ValidateBody](#sam-function-requestmodel-validatebody): Boolean
  [ValidateParameters](#sam-function-requestmodel-validateparameters): Boolean
```

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

 `Model`   <a name="sam-function-requestmodel-model"></a>
Nome di un modello definito nella proprietà Models di. [AWS::Serverless::Api](sam-resource-api.md)  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Required`   <a name="sam-function-requestmodel-required"></a>
Aggiunge una `required` proprietà nella sezione dei parametri della OpenApi definizione per l'endpoint API specificato.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `ValidateBody`   <a name="sam-function-requestmodel-validatebody"></a>
Specifica se API Gateway utilizza `Model` per convalidare il corpo della richiesta. Per ulteriori informazioni, consulta [Abilitare la convalida delle richieste in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html) nella *Guida per sviluppatori di API Gateway*.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `ValidateParameters`   <a name="sam-function-requestmodel-validateparameters"></a>
Specifica se API Gateway utilizza `Model` per convalidare i parametri del percorso della richiesta, le stringhe di query e le intestazioni. Per ulteriori informazioni, consulta [Abilitare la convalida delle richieste in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html) nella *Guida per sviluppatori di API Gateway*.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Richiedi modello
<a name="sam-property-function-requestmodel--examples--request-model"></a>

Esempio di modello di richiesta

#### YAML
<a name="sam-property-function-requestmodel--examples--request-model--yaml"></a>

```
RequestModel:
  Model: User
  Required: true
  ValidateBody: true
  ValidateParameters: true
```

# RequestParameter
<a name="sam-property-function-requestparameter"></a>

Configura il parametro di richiesta per un metodo Api\$1Path\$1 specifico.

È necessario `Required` specificare una delle due `Caching` proprietà per il parametro di richiesta

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

```
  [Caching](#sam-function-requestparameter-caching): Boolean
  [Required](#sam-function-requestparameter-required): Boolean
```

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

 `Caching`   <a name="sam-function-requestparameter-caching"></a>
Aggiunge una `cacheKeyParameters` sezione alla OpenApi definizione di API Gateway  
*Tipo*: Booleano  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Required`   <a name="sam-function-requestparameter-required"></a>
Questo campo specifica se un parametro è obbligatorio  
*Tipo*: Booleano  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Parametro della richiesta
<a name="sam-property-function-requestparameter--examples--request-parameter"></a>

Esempio di impostazione dei parametri di richiesta

#### YAML
<a name="sam-property-function-requestparameter--examples--request-parameter--yaml"></a>

```
RequestParameters:
  - method.request.header.Authorization:
      Required: true
      Caching: true
```

# CloudWatchEvent
<a name="sam-property-function-cloudwatchevent"></a>

L'oggetto che descrive un tipo di origine `CloudWatchEvent` dell'evento.

AWS Serverless Application Model (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.

**Nota importante**: [EventBridgeRule](sam-property-function-eventbridgerule.md) è il tipo di sorgente di eventi preferito da utilizzare, anziché`CloudWatchEvent`. `EventBridgeRule`e `CloudWatchEvent` utilizza lo stesso servizio, API e CloudFormation risorse sottostanti. Tuttavia, AWS SAM aggiungerà il supporto per le nuove funzionalità solo a`EventBridgeRule`.

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

```
  [Enabled](#sam-function-cloudwatchevent-enabled): Boolean
  [EventBusName](#sam-function-cloudwatchevent-eventbusname): String
  [Input](#sam-function-cloudwatchevent-input): String
  [InputPath](#sam-function-cloudwatchevent-inputpath): String
  [Pattern](#sam-function-cloudwatchevent-pattern): [EventPattern](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-eventpattern)
  [State](#sam-function-cloudwatchevent-state): String
```

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

 `Enabled`   <a name="sam-function-cloudwatchevent-enabled"></a>
Indica se la regola è abilitata.  
Per disabilitare la regola, imposta questa proprietà su. `false`  
Specificate la `State` proprietà `Enabled` o, ma non entrambe.
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile 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. Se questa proprietà è impostata su `true` allora AWS SAM passa`ENABLED`, altrimenti passa`DISABLED`.

 `EventBusName`   <a name="sam-function-cloudwatchevent-eventbusname"></a>
Il bus evento da associare a questa regola. Se si omette questa proprietà, AWS SAM utilizza il bus di 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-cloudwatchevent-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-cloudwatchevent-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.

 `Pattern`   <a name="sam-function-cloudwatchevent-pattern"></a>
Descrive quali eventi vengono instradati nella destinazione specificata. Per ulteriori informazioni, consulta [Events and Event Patterns EventBridge nella](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *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.

 `State`   <a name="sam-function-cloudwatchevent-state"></a>
Lo stato della regola.  
*Valori accettati:* `DISABLED | ENABLED`  
Specificate la `State` proprietà `Enabled` o, ma non entrambe.
▬*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.

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

### CloudWatchEvent
<a name="sam-property-function-cloudwatchevent--examples--cloudwatchevent"></a>

Di seguito è riportato un esempio di tipo di sorgente di `CloudWatchEvent` eventi.

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

```
CWEvent:
  Type: CloudWatchEvent
  Properties:
    Enabled: false
    Input: '{"Key": "Value"}'
    Pattern:
      detail:
        state:
          - running
```

# CloudWatchLogs
<a name="sam-property-function-cloudwatchlogs"></a>

L'oggetto che descrive un tipo di origine `CloudWatchLogs` dell'evento.

Questo evento genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-subscriptionfilter.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-subscriptionfilter.html)risorsa, specifica un filtro di sottoscrizione e lo associa al gruppo di log specificato.

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

```
  [FilterPattern](#sam-function-cloudwatchlogs-filterpattern): String
  [LogGroupName](#sam-function-cloudwatchlogs-loggroupname): String
```

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

 `FilterPattern`   <a name="sam-function-cloudwatchlogs-filterpattern"></a>
Le espressioni di filtraggio che limitano ciò che viene consegnato alla risorsa di destinazione. AWS Per ulteriori informazioni sulla sintassi dei modelli di filtro, consulta [Sintassi di filtri e modelli](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterPattern](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-subscriptionfilter.html#cfn-cwl-subscriptionfilter-filterpattern)` proprietà di una `AWS::Logs::SubscriptionFilter` risorsa.

 `LogGroupName`   <a name="sam-function-cloudwatchlogs-loggroupname"></a>
Il gruppo di log a cui associare il filtro sottoscrizioni. Tutti gli eventi di registro caricati in questo gruppo di log vengono filtrati e consegnati alla AWS risorsa specificata se il modello di filtro corrisponde agli eventi di registro.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[LogGroupName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-subscriptionfilter.html#cfn-cwl-subscriptionfilter-loggroupname)` proprietà di una `AWS::Logs::SubscriptionFilter` risorsa.

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

### Filtro di abbonamento Cloudwatchlogs
<a name="sam-property-function-cloudwatchlogs--examples--cloudwatchlogs-subscription-filter"></a>

Esempio di filtro di abbonamento Cloudwatchlogs

#### YAML
<a name="sam-property-function-cloudwatchlogs--examples--cloudwatchlogs-subscription-filter--yaml"></a>

```
CWLog:
  Type: CloudWatchLogs
  Properties:
    LogGroupName:
      Ref: CloudWatchLambdaLogsGroup
    FilterPattern: My pattern
```

# Cognito
<a name="sam-property-function-cognito"></a>

L'oggetto che descrive un tipo di origine `Cognito` dell'evento.

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

```
  [Trigger](#sam-function-cognito-trigger): List
  [UserPool](#sam-function-cognito-userpool): String
```

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

 `Trigger`   <a name="sam-function-cognito-trigger"></a>
Le informazioni di configurazione del trigger Lambda per il nuovo pool di utenti.  
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[LambdaConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cognito-userpool-lambdaconfig.html)` proprietà di una `AWS::Cognito::UserPool` risorsa.

 `UserPool`   <a name="sam-function-cognito-userpool"></a>
Riferimento a UserPool definito nello stesso modello  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Evento Cognito
<a name="sam-property-function-cognito--examples--cognito-event"></a>

Esempio di evento Cognito

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

```
CognitoUserPoolPreSignup:
  Type: Cognito
  Properties:
    UserPool:
      Ref: MyCognitoUserPool
    Trigger: PreSignUp
```

# DocumentDB
<a name="sam-property-function-documentdb"></a>

L'oggetto che descrive un tipo di origine `DocumentDB` dell'evento. Per ulteriori informazioni, consulta [Using AWS Lambda with Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) nella *AWS Lambda Developer* Guide.

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

Per dichiarare questa entità nel tuo AWS SAM modello, usa la seguente sintassi.

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

```
BatchSize: Integer
Cluster: [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
CollectionName: String
DatabaseName: String
Enabled: Boolean
FilterCriteria: [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
FullDocument: String
KmsKeyArn: String  
MaximumBatchingWindowInSeconds: Integer
SecretsManagerKmsKeyId: String
SourceAccessConfigurations: List
StartingPosition: String
StartingPositionTimestamp: Double
```

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

 `BatchSize`   <a name="sam-function-documentdb-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Cluster`   <a name="sam-function-documentdb-cluster"></a>
L'Amazon Resource Name (ARN) del cluster Amazon DocumentDB.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ EventSourceArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `CollectionName`   <a name="sam-function-documentdb-collectionname"></a>
Il nome della raccolta da utilizzare all'interno del database. Se non specifichi una raccolta, Lambda utilizza tutte le raccolte.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ CollectionName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig-collectionname)` proprietà di un tipo di `AWS::Lambda::EventSourceMapping` `DocumentDBEventSourceConfig` dati.

 `DatabaseName`   <a name="sam-function-documentdb-databasename"></a>
Il nome del database da utilizzare all'interno del cluster Amazon DocumentDB.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ DatabaseName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig-databasename)` proprietà di un tipo di `AWS::Lambda::EventSourceMapping` `DocumentDBEventSourceConfig` dati.

 `Enabled`   <a name="sam-function-documentdb-enabled"></a>
Se`true`, la mappatura della fonte dell'evento è attiva. Per mettere in pausa il polling e la chiamata, imposta su. `false`  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `FilterCriteria`   <a name="sam-function-documentdb-filtercriteria"></a>
Un oggetto che definisce i criteri che determinano se Lambda deve elaborare un evento. *Per ulteriori informazioni, consulta [Filtraggio degli eventi Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) nella Developer Guide.AWS Lambda *  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FullDocument`   <a name="sam-function-documentdb-fulldocument"></a>
Determina cosa invia Amazon DocumentDB al tuo flusso di eventi durante le operazioni di aggiornamento dei documenti. Se impostato su`UpdateLookup`, Amazon DocumentDB invia un delta che descrive le modifiche, insieme a una copia dell'intero documento. Altrimenti, Amazon DocumentDB invia solo un documento parziale contenente le modifiche.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ FullDocument](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig-fulldocument)` proprietà di un tipo di `AWS::Lambda::EventSourceMapping` `DocumentDBEventSourceConfig` dati.

 `KmsKeyArn`   <a name="sam-function-documentdb-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumBatchingWindowInSeconds`   <a name="sam-function-documentdb-maximumbatchingwindowinseconds"></a>
Il tempo massimo in secondi per la raccolta dei record prima di richiamare la funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `SecretsManagerKmsKeyId`   <a name="sam-function-documentdb-secretsmanagerkmskeyid"></a>
L'ID chiave AWS Key Management Service (AWS KMS) di una chiave gestita dal cliente di AWS Secrets Manager. Richiesto quando si utilizza una chiave gestita dal cliente di Secrets Manager con un ruolo di esecuzione Lambda che non include l'`kms:Decrypt`autorizzazione.  
Il valore di questa proprietà è un UUID. Ad esempio: `1abc23d4-567f-8ab9-cde0-1fab234c5d67`.  
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `SourceAccessConfigurations`   <a name="sam-function-documentdb-sourceaccessconfigurations"></a>
Una matrice del protocollo di autenticazione o dell'host virtuale. Specificalo utilizzando il tipo di [SourceAccessConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration.html)dati.  
Per il tipo di origine dell'`DocumentDB`evento, l'unico tipo di configurazione valido è`BASIC_AUTH`.  
+ `BASIC_AUTH`— Il segreto di Secrets Manager che memorizza le credenziali del broker. Per questo tipo, la credenziale deve essere nel seguente formato:. `{"username": "your-username", "password": "your-password"}` È consentito un solo oggetto di tipo`BASIC_AUTH`.
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ SourceAccessConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-sourceaccessconfigurations)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPosition`   <a name="sam-function-documentdb-startingposition"></a>
La posizione in un flusso da cui iniziare la lettura.  
+ `AT_TIMESTAMP`— Specificare l'ora a partire dalla quale iniziare a leggere i record.
+ `LATEST`— Leggi solo i nuovi record.
+ `TRIM_HORIZON`— Elabora tutti i record disponibili.
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ StartingPosition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPositionTimestamp`   <a name="sam-function-documentdb-startingpositiontimestamp"></a>
L'ora da cui iniziare a leggere, in secondi di tempo Unix. Definisce `StartingPositionTimestamp` quando `StartingPosition` è specificato come`AT_TIMESTAMP`.  
*Tipo:* numero a doppia precisione  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ StartingPositionTimestamp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingpositiontimestamp)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

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

### Fonte di eventi Amazon DocumentDB
<a name="sam-property-function-documentdb-examples-example1"></a>

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
    ...
      Events:
        MyDDBEvent:
          Type: DocumentDB
          Properties:
            Cluster: "arn:aws:rds:us-west-2:123456789012:cluster:docdb-2023-01-01"
            BatchSize: 10
            MaximumBatchingWindowInSeconds: 5
            DatabaseName: "db1"
            CollectionName: "collection1"
            FullDocument: "UpdateLookup"
            SourceAccessConfigurations:
              - Type: BASIC_AUTH
                URI: "arn:aws:secretsmanager:us-west-2:123456789012:secret:doc-db"
```

# DynamoDB
<a name="sam-property-function-dynamodb"></a>

L'oggetto che descrive un tipo di origine `DynamoDB` dell'evento. *Per ulteriori informazioni, consulta [Using AWS Lambda with Amazon DynamoDB](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html) nella AWS Lambda Developer Guide.*

AWS SAM genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)risorsa quando viene impostato questo tipo di evento.

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

```
  [BatchSize](#sam-function-dynamodb-batchsize): Integer
  [BisectBatchOnFunctionError](#sam-function-dynamodb-bisectbatchonfunctionerror): Boolean
  [DestinationConfig](#sam-function-dynamodb-destinationconfig): [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)
  [Enabled](#sam-function-dynamodb-enabled): Boolean
  [FilterCriteria](#sam-function-dynamodb-filtercriteria): [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
  [FunctionResponseTypes](#sam-function-dynamodb-functionresponsetypes): List
  KmsKeyArn: String          
  [MaximumBatchingWindowInSeconds](#sam-function-dynamodb-maximumbatchingwindowinseconds): Integer
  [MaximumRecordAgeInSeconds](#sam-function-dynamodb-maximumrecordageinseconds): Integer
  [MaximumRetryAttempts](#sam-function-dynamodb-maximumretryattempts): Integer
  [MetricsConfig](#sam-function-dynamodb-metricsconfig): [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)
  [ParallelizationFactor](#sam-function-dynamodb-parallelizationfactor): Integer
  [StartingPosition](#sam-function-dynamodb-startingposition): String
  StartingPositionTimestamp: Double
  [Stream](#sam-function-dynamodb-stream): String
  [TumblingWindowInSeconds](#sam-function-dynamodb-tumblingwindowinseconds): Integer
```

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

 `BatchSize`   <a name="sam-function-dynamodb-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch.  
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 100  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.  
*Minimum*: `1`  
*Maximum*: `1000`

 `BisectBatchOnFunctionError`   <a name="sam-function-dynamodb-bisectbatchonfunctionerror"></a>
Se la funzione restituisce un errore, dividi il batch in due e riprova.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BisectBatchOnFunctionError](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-bisectbatchonfunctionerror)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `DestinationConfig`   <a name="sam-function-dynamodb-destinationconfig"></a>
Una coda Amazon Simple Queue Service (Amazon SQS) o una destinazione tematica di Amazon Simple Notification Service (Amazon SNS) per i record scartati.  
*Tipo:* [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)` `AWS::Lambda::EventSourceMapping`

 `Enabled`   <a name="sam-function-dynamodb-enabled"></a>
Disabilita la mappatura dell'origine eventi per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FilterCriteria`   <a name="sam-function-dynamodb-filtercriteria"></a>
Un oggetto che definisce i criteri per determinare se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il [filtro AWS Lambda degli eventi nella Guida per](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) gli *AWS Lambda sviluppatori*.  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FunctionResponseTypes`   <a name="sam-function-dynamodb-functionresponsetypes"></a>
Un elenco dei tipi di risposta attualmente applicati alla mappatura delle sorgenti degli eventi. Per ulteriori informazioni, consulta la pagina [Segnalazione di errori degli elementi batch](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-batchfailurereporting) nella *Guida per gli sviluppatori di AWS Lambda *.  
*Valori validi*: `ReportBatchItemFailures`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionResponseTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionresponsetypes)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `KmsKeyArn`   <a name="sam-function-dynamodb-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumBatchingWindowInSeconds`   <a name="sam-function-dynamodb-maximumbatchingwindowinseconds"></a>
Il tempo massimo in secondi per la raccolta dei record prima di richiamare la funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRecordAgeInSeconds`   <a name="sam-function-dynamodb-maximumrecordageinseconds"></a>
L'età massima di un record che Lambda invia a una funzione per l'elaborazione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRecordAgeInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumrecordageinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRetryAttempts`   <a name="sam-function-dynamodb-maximumretryattempts"></a>
Il numero massimo di ripetizioni consentite quando la funzione restituisce un errore.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRetryAttempts](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumretryattempts)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MetricsConfig`   <a name="sam-function-dynamodb-metricsconfig"></a>
Una configurazione opzionale per ottenere metriche avanzate per le mappature delle sorgenti degli eventi che catturano ogni fase dell'elaborazione. Per vedere un esempio, consulta [MetricsConfig evento](#sam-property-function-dynamodb-example-metricsconfigevent).  
*Tipo:* [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `ParallelizationFactor`   <a name="sam-function-dynamodb-parallelizationfactor"></a>
Il numero di batch da elaborare contemporaneamente da ogni shard.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ParallelizationFactor](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-parallelizationfactor)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `StartingPosition`   <a name="sam-function-dynamodb-startingposition"></a>
La posizione in un flusso da cui iniziare la lettura.  
+ `AT_TIMESTAMP`— Specificare l'ora a partire dalla quale iniziare a leggere i record.
+ `LATEST`— Leggi solo i nuovi record.
+ `TRIM_HORIZON`— Elabora tutti i record disponibili.
*Valori validi*: `AT_TIMESTAMP` \$1 `LATEST` \$1 `TRIM_HORIZON`  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPosition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPositionTimestamp`   <a name="sam-function-dynamodb-startingpositiontimestamp"></a>
L'ora da cui iniziare a leggere, in secondi di tempo Unix. Definisce `StartingPositionTimestamp` quando `StartingPosition` è specificato come`AT_TIMESTAMP`.  
*Tipo:* numero a doppia precisione  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPositionTimestamp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingpositiontimestamp)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Stream`   <a name="sam-function-dynamodb-stream"></a>
L'Amazon Resource Name (ARN) del flusso DynamoDB.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventSourceArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `TumblingWindowInSeconds`   <a name="sam-function-dynamodb-tumblingwindowinseconds"></a>
La durata, in secondi, di una finestra di elaborazione. L'intervallo valido è compreso tra 1 e 900 (15 minuti).  
Per ulteriori informazioni, consulta [Tumbling windows](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#streams-tumbling) nella *AWS Lambda Developer Guide*.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[TumblingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-tumblingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

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

### MetricsConfig evento
<a name="sam-property-function-dynamodb-example-metricsconfigevent"></a>

Di seguito è riportato un esempio di risorsa che utilizza la `MetricsConfig` proprietà per acquisire ogni fase dell'elaborazione per le mappature delle sorgenti degli eventi.

```
Resources:
  FilteredEventsFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: s3://sam-demo-bucket/metricsConfig.zip
      Handler: index.handler
      Runtime: nodejs16.x
      Events:
        KinesisStream:
          Type: Kinesis
          Properties:
            Stream: !GetAtt KinesisStream.Arn
            StartingPosition: LATEST
            MetricsConfig:
              Metrics:
              - EventCount
```

### Fonte di eventi DynamoDB per la tabella DynamoDB esistente
<a name="sam-property-function-dynamodb--examples--dynamodb-event-source-for-existing-dynamodb-table"></a>

Fonte di eventi DynamoDB per una tabella DynamoDB già esistente in un account. AWS 

#### YAML
<a name="sam-property-function-dynamodb--examples--dynamodb-event-source-for-existing-dynamodb-table--yaml"></a>

```
Events:
  DDBEvent:
    Type: DynamoDB
    Properties:
      Stream: arn:aws:dynamodb:us-east-1:123456789012:table/TestTable/stream/2016-08-11T21:21:33.291
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false
```

### Evento DynamoDB per la tabella DynamoDB dichiarato nel modello
<a name="sam-property-function-dynamodb--examples--dynamodb-event-for-dynamodb-table-declared-in-template"></a>

Evento DynamoDB per una tabella DynamoDB dichiarata nello stesso file modello.

#### YAML
<a name="sam-property-function-dynamodb--examples--dynamodb-event-for-dynamodb-table-declared-in-template--yaml"></a>

```
Events:
  DDBEvent:
    Type: DynamoDB
    Properties:
      Stream: 
        !GetAtt MyDynamoDBTable.StreamArn   # This must be the name of a DynamoDB table declared in the same template file
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false
```

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

# HttpApi
<a name="sam-property-function-httpapi"></a>

L'oggetto che descrive un'origine di eventi con tipo HttpApi.

Se nell'API esiste una OpenApi definizione per il percorso e il metodo specificati, SAM aggiungerà automaticamente la sezione sull'integrazione e la sicurezza Lambda (se applicabile).

Se nell'API non esiste alcuna OpenApi definizione per il percorso e il metodo specificati, SAM la creerà automaticamente.

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

```
  [ApiId](#sam-function-httpapi-apiid): String
  [Auth](#sam-function-httpapi-auth): HttpApiFunctionAuth
  [Method](#sam-function-httpapi-method): String
  [Path](#sam-function-httpapi-path): String
  [PayloadFormatVersion](#sam-function-httpapi-payloadformatversion): String
  [RouteSettings](#sam-function-httpapi-routesettings): [RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings)
  [TimeoutInMillis](#sam-function-httpapi-timeoutinmillis): Integer
```

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

 `ApiId`   <a name="sam-function-httpapi-apiid"></a>
Identificatore di una [AWS::Serverless::HttpApi](sam-resource-httpapi.md) risorsa definita in questo modello.  
Se non è definita, viene creata una [AWS::Serverless::HttpApi](sam-resource-httpapi.md) risorsa predefinita chiamata `ServerlessHttpApi` utilizzando un OpenApi documento generato contenente un'unione di tutti i percorsi e i metodi definiti dagli eventi Api definiti in questo modello che non specificano un`ApiId`.  
Questo non può fare riferimento a una [AWS::Serverless::HttpApi](sam-resource-httpapi.md) risorsa definita in un altro modello.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Auth`   <a name="sam-function-httpapi-auth"></a>
Configurazione di autenticazione per questo specifico metodo Api\$1Path\$1.  
Utile per sovrascrivere le API `DefaultAuthorizer` o impostare la configurazione di autenticazione su un percorso individuale quando non è specificato. `DefaultAuthorizer`  
*Tipo:* [HttpApiFunctionAuth](sam-property-function-httpapifunctionauth.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Method`   <a name="sam-function-httpapi-method"></a>
Metodo HTTP per il quale viene richiamata questa funzione.  
Se non `Method` viene specificato alcun `Path` e, SAM creerà un percorso API predefinito che indirizza qualsiasi richiesta che non sia mappata a un endpoint diverso per questa funzione Lambda. Può esistere solo uno di questi percorsi predefiniti per API.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Path`   <a name="sam-function-httpapi-path"></a>
Percorso Uri per il quale viene richiamata questa funzione. Deve iniziare con`/`.  
Se non `Method` viene specificato alcun `Path` e, SAM creerà un percorso API predefinito che indirizza qualsiasi richiesta che non sia mappata a un endpoint diverso per questa funzione Lambda. Può esistere solo uno di questi percorsi predefiniti per API.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `PayloadFormatVersion`   <a name="sam-function-httpapi-payloadformatversion"></a>
Specifica il formato del payload inviato a un'integrazione.  
NOTA: PayloadFormatVersion richiede che SAM modifichi la definizione di OpenAPI, quindi funziona solo con inline OpenApi definito nella proprietà. `DefinitionBody`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Predefinito*: 2.0  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `RouteSettings`   <a name="sam-function-httpapi-routesettings"></a>
Le impostazioni del percorso per percorso per questa API HTTP. Per ulteriori informazioni sulle impostazioni del percorso, consulta [AWS::ApiGatewayV2::Stage RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigatewayv2-stage-routesettings.html)la *Guida per gli sviluppatori di API Gateway*.  
Nota: se RouteSettings sono specificate sia nella HttpApi risorsa che nell'origine dell'evento, le AWS SAM unisce alle proprietà dell'origine dell'evento che hanno la precedenza.  
*Tipo:* [RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings)` proprietà di una `AWS::ApiGatewayV2::Stage` risorsa.

 `TimeoutInMillis`   <a name="sam-function-httpapi-timeoutinmillis"></a>
Timeout personalizzato tra 50 e 29.000 millisecondi.  
NOTA: TimeoutInMillis richiede che SAM modifichi la definizione di OpenAPI, quindi funziona solo con inline OpenApi definito nella proprietà. `DefinitionBody`  
*Tipo*: integer  
*Obbligatorio:* no  
Valore *predefinito*: 5000  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### HttpApi Evento predefinito
<a name="sam-property-function-httpapi--examples--default-httpapi-event"></a>

HttpApi Evento che utilizza il percorso predefinito. Tutti i percorsi e i metodi non mappati su questa API verranno indirizzati a questo endpoint.

#### YAML
<a name="sam-property-function-httpapi--examples--default-httpapi-event--yaml"></a>

```
Events:
  HttpApiEvent:
    Type: HttpApi
```

### HttpApi
<a name="sam-property-function-httpapi--examples--httpapi"></a>

HttpApi Evento che utilizza un percorso e un metodo specifici.

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

```
Events:
  HttpApiEvent:
    Type: HttpApi
    Properties:
      Path: /
      Method: GET
```

### HttpApi Autorizzazione
<a name="sam-property-function-httpapi--examples--httpapi-authorization"></a>

HttpApi Evento che utilizza un Authorizer.

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

```
Events:
  HttpApiEvent:
    Type: HttpApi
    Properties:
      Path: /authenticated
      Method: GET
      Auth:
        Authorizer: OpenIdAuth
        AuthorizationScopes:
          - scope1
          - scope2
```

# HttpApiFunctionAuth
<a name="sam-property-function-httpapifunctionauth"></a>

Configura l'autorizzazione a livello di evento.

Configura l'autenticazione per un metodo API \$1 Path \$1 specifico

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

```
  [AuthorizationScopes](#sam-function-httpapifunctionauth-authorizationscopes): List
  [Authorizer](#sam-function-httpapifunctionauth-authorizer): String
```

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

 `AuthorizationScopes`   <a name="sam-function-httpapifunctionauth-authorizationscopes"></a>
Gli ambiti di autorizzazione da applicare a questa API, percorso e metodo.  
Gli ambiti elencati qui sostituiranno tutti gli ambiti applicati da, se ne esiste uno. `DefaultAuthorizer`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Authorizer`   <a name="sam-function-httpapifunctionauth-authorizer"></a>
Il `Authorizer` per una funzione specifica. Per utilizzare l'autorizzazione IAM, specifica `AWS_IAM` e specifica `true` for `EnableIamAuthorizer` nella `Globals` sezione del modello.  
Se hai specificato un Global Authorizer sull'API e desideri rendere pubblica una funzione specifica, esegui l'override `Authorizer` impostando su. `NONE`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Autenticazione della funzione
<a name="sam-property-function-httpapifunctionauth--examples--function-auth"></a>

Specificazione dell'autorizzazione a livello di funzione

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

```
Auth:
  Authorizer: OpenIdAuth
  AuthorizationScopes:
    - scope1
    - scope2
```

### Autorizzazione IAM
<a name="sam-property-function-httpapifunctionauth--examples--iam-authorization"></a>

Specifica l'autorizzazione IAM a livello di evento. Per utilizzare `AWS_IAM` l'autorizzazione a livello di evento, è inoltre necessario specificare `true` for `EnableIamAuthorizer` nella `Globals` sezione del modello. Per ulteriori informazioni, consulta [Sezione Globals del modello AWS SAM](sam-specification-template-anatomy-globals.md).

#### YAML
<a name="sam-property-function-httpapifunctionauth--examples--iam-authorization--yaml"></a>

```
Globals:
  HttpApi:
    Auth:
      EnableIamAuthorizer: true

Resources:
  HttpApiFunctionWithIamAuth:
    Type: AWS::Serverless::Function
    Properties:
      Events:
        ApiEvent:
          Type: HttpApi
          Properties:
            Path: /iam-auth
            Method: GET
            Auth:
              Authorizer: AWS_IAM
      Handler: index.handler
      InlineCode: |
        def handler(event, context):
          return {'body': 'HttpApiFunctionWithIamAuth', 'statusCode': 200}
      Runtime: python3.9
```

# IoTRule
<a name="sam-property-function-iotrule"></a>

L'oggetto che descrive un tipo di sorgente di `IoTRule` eventi.

Crea una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iot-topicrule.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iot-topicrule.html)risorsa per dichiarare una AWS IoT regola. [Per ulteriori informazioni, consulta la documentazione CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iot-topicrule.html)

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

```
  [AwsIotSqlVersion](#sam-function-iotrule-awsiotsqlversion): String
  [Sql](#sam-function-iotrule-sql): String
```

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

 `AwsIotSqlVersion`   <a name="sam-function-iotrule-awsiotsqlversion"></a>
Versione del motore di regole SQL da usare durante la valutazione della regola.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[AwsIotSqlVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iot-topicrule-topicrulepayload.html#cfn-iot-topicrule-topicrulepayload-awsiotsqlversion)` proprietà di una `AWS::IoT::TopicRule TopicRulePayload` risorsa.

 `Sql`   <a name="sam-function-iotrule-sql"></a>
Istruzione SQL usata per eseguire query sull'argomento. Per ulteriori informazioni, vedere [AWS IoT SQL Reference](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html#aws-iot-sql-reference) nella *AWS IoT Developer Guide*.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Sql](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iot-topicrule-topicrulepayload.html#cfn-iot-topicrule-topicrulepayload-sql)` proprietà di una `AWS::IoT::TopicRule TopicRulePayload` risorsa.

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

### Regola IOT
<a name="sam-property-function-iotrule--examples--iot-rule"></a>

Esempio di regola IOT

#### YAML
<a name="sam-property-function-iotrule--examples--iot-rule--yaml"></a>

```
IoTRule:
  Type: IoTRule
  Properties:
    Sql: SELECT * FROM 'topic/test'
```

# Kinesis
<a name="sam-property-function-kinesis"></a>

L'oggetto che descrive un tipo di origine `Kinesis` dell'evento. Per ulteriori informazioni, consulta [Using AWS Lambda with Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html) nella *AWS Lambda Developer* Guide.

AWS SAM genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)risorsa quando questo tipo di evento è impostato.

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

```
  [BatchSize](#sam-function-kinesis-batchsize): Integer
  [BisectBatchOnFunctionError](#sam-function-kinesis-bisectbatchonfunctionerror): Boolean
  [DestinationConfig](#sam-function-kinesis-destinationconfig): [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)
  [Enabled](#sam-function-kinesis-enabled): Boolean
  [FilterCriteria](#sam-function-kinesis-filtercriteria): [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
  [FunctionResponseTypes](#sam-function-kinesis-functionresponsetypes): List
  KmsKeyArn: String          
  [MaximumBatchingWindowInSeconds](#sam-function-kinesis-maximumbatchingwindowinseconds): Integer
  [MaximumRecordAgeInSeconds](#sam-function-kinesis-maximumrecordageinseconds): Integer
  [MaximumRetryAttempts](#sam-function-kinesis-maximumretryattempts): Integer
  [MetricsConfig](#sam-function-kinesis-metricsconfig): [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)
  [ParallelizationFactor](#sam-function-kinesis-parallelizationfactor): Integer
  [StartingPosition](#sam-function-kinesis-startingposition): String
  StartingPositionTimestamp: Double
  [Stream](#sam-function-kinesis-stream): String
  [TumblingWindowInSeconds](#sam-function-kinesis-tumblingwindowinseconds): Integer
```

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

 `BatchSize`   <a name="sam-function-kinesis-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch.  
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 100  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.  
*Minimum*: `1`  
*Maximum*: `10000`

 `BisectBatchOnFunctionError`   <a name="sam-function-kinesis-bisectbatchonfunctionerror"></a>
Se la funzione restituisce un errore, dividi il batch in due e riprova.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BisectBatchOnFunctionError](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-bisectbatchonfunctionerror)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `DestinationConfig`   <a name="sam-function-kinesis-destinationconfig"></a>
Una coda Amazon Simple Queue Service (Amazon SQS) o una destinazione tematica di Amazon Simple Notification Service (Amazon SNS) per i record scartati.  
*Tipo:* [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)` `AWS::Lambda::EventSourceMapping`

 `Enabled`   <a name="sam-function-kinesis-enabled"></a>
Disabilita la mappatura dell'origine eventi per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FilterCriteria`   <a name="sam-function-kinesis-filtercriteria"></a>
Un oggetto che definisce i criteri per determinare se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il [filtro AWS Lambda degli eventi nella Guida per](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) gli *AWS Lambda sviluppatori*.  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FunctionResponseTypes`   <a name="sam-function-kinesis-functionresponsetypes"></a>
Un elenco dei tipi di risposta attualmente applicati alla mappatura delle sorgenti degli eventi. Per ulteriori informazioni, consulta la pagina [Segnalazione di errori degli elementi batch](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-batchfailurereporting) nella *Guida per gli sviluppatori di AWS Lambda *.  
*Valori validi*: `ReportBatchItemFailures`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionResponseTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionresponsetypes)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `KmsKeyArn`   <a name="sam-function-kinesis-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumBatchingWindowInSeconds`   <a name="sam-function-kinesis-maximumbatchingwindowinseconds"></a>
Il tempo massimo in secondi per la raccolta dei record prima di richiamare la funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRecordAgeInSeconds`   <a name="sam-function-kinesis-maximumrecordageinseconds"></a>
L'età massima di un record che Lambda invia a una funzione per l'elaborazione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRecordAgeInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumrecordageinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRetryAttempts`   <a name="sam-function-kinesis-maximumretryattempts"></a>
Il numero massimo di ripetizioni consentite quando la funzione restituisce un errore.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRetryAttempts](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumretryattempts)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MetricsConfig`   <a name="sam-function-kinesis-metricsconfig"></a>
Una configurazione opzionale per ottenere metriche avanzate per le mappature delle sorgenti degli eventi che catturano ogni fase dell'elaborazione. Per vedere un esempio, consulta [MetricsConfig evento](sam-property-function-dynamodb.md#sam-property-function-dynamodb-example-metricsconfigevent).  
*Tipo:* [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `ParallelizationFactor`   <a name="sam-function-kinesis-parallelizationfactor"></a>
Il numero di batch da elaborare contemporaneamente da ogni shard.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ParallelizationFactor](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-parallelizationfactor)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `StartingPosition`   <a name="sam-function-kinesis-startingposition"></a>
La posizione in un flusso da cui iniziare la lettura.  
+ `AT_TIMESTAMP`— Specificare l'ora a partire dalla quale iniziare a leggere i record.
+ `LATEST`— Leggi solo i nuovi record.
+ `TRIM_HORIZON`— Elabora tutti i record disponibili.
*Valori validi*: `AT_TIMESTAMP` \$1 `LATEST` \$1 `TRIM_HORIZON`  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPosition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPositionTimestamp`   <a name="sam-function-kinesis-startingpositiontimestamp"></a>
L'ora da cui iniziare a leggere, in secondi di tempo Unix. Definisce `StartingPositionTimestamp` quando `StartingPosition` è specificato come`AT_TIMESTAMP`.  
*Tipo:* numero a doppia precisione  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPositionTimestamp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingpositiontimestamp)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Stream`   <a name="sam-function-kinesis-stream"></a>
L'Amazon Resource Name (ARN) del flusso di dati o di un consumatore di streaming.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventSourceArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `TumblingWindowInSeconds`   <a name="sam-function-kinesis-tumblingwindowinseconds"></a>
La durata, in secondi, di una finestra di elaborazione. L'intervallo valido è compreso tra 1 e 900 (15 minuti).  
Per ulteriori informazioni, consulta [Tumbling windows](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#streams-tumbling) nella *AWS Lambda Developer Guide*.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[TumblingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-tumblingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

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

### MetricsConfig evento
<a name="sam-property-function-kinesis-example-metricsconfigevent"></a>

Di seguito è riportato un esempio di risorsa che utilizza la `MetricsConfig` proprietà per acquisire ogni fase dell'elaborazione per le mappature delle sorgenti degli eventi.

```
Resources:
  FilteredEventsFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: s3://sam-demo-bucket/metricsConfig.zip
      Handler: index.handler
      Runtime: nodejs16.x
      Events:
        KinesisStream:
          Type: Kinesis
          Properties:
            Stream: !GetAtt KinesisStream.Arn
            StartingPosition: LATEST
            MetricsConfig:
              Metrics:
              - EventCount
```

### Fonte di eventi Kinesis
<a name="sam-property-function-kinesis--examples--kinesis-event-source"></a>

Di seguito è riportato un esempio di sorgente di eventi Kinesis.

#### YAML
<a name="sam-property-function-kinesis--examples--kinesis-event-source--yaml"></a>

```
Events:
  KinesisEvent:
    Type: Kinesis
    Properties:
      Stream: arn:aws:kinesis:us-east-1:123456789012:stream/my-stream
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false
      FilterCriteria: 
        Filters: 
          - Pattern: '{"key": ["val1", "val2"]}'
```

# MQ
<a name="sam-property-function-mq"></a>

L'oggetto che descrive un tipo di origine `MQ` dell'evento. Per ulteriori informazioni, consulta [Using Lambda with Amazon MQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html) nella *AWS Lambda Developer* Guide.

AWS Serverless Application Model (AWS SAM) genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)risorsa quando viene impostato questo tipo di evento.

**Nota**  
Per avere una coda Amazon MQ in un cloud privato virtuale (VPC) che si connette a una funzione Lambda in una rete pubblica, il ruolo di esecuzione della funzione deve includere le seguenti autorizzazioni:   
`ec2:CreateNetworkInterface`
`ec2:DeleteNetworkInterface`
`ec2:DescribeNetworkInterfaces`
`ec2:DescribeSecurityGroups`
`ec2:DescribeSubnets`
`ec2:DescribeVpcs`
*Per ulteriori informazioni, consulta [Autorizzazioni per i ruoli di esecuzione nella Guida](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#events-mq-permissions) per gli sviluppatori.AWS Lambda *

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

Per dichiarare questa entità nel tuo AWS SAM modello, usa la seguente sintassi.

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

```
  [BatchSize](#sam-function-mq-batchsize): Integer
  [Broker](#sam-function-mq-broker): String
  DynamicPolicyName: Boolean
  [Enabled](#sam-function-mq-enabled): Boolean
  [FilterCriteria](#sam-function-mq-filtercriteria): [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
  KmsKeyArn: String 
  [MaximumBatchingWindowInSeconds](#sam-function-mq-maximumbatchingwindowinseconds): Integer
  [Queues](#sam-function-mq-queues): List
  [SecretsManagerKmsKeyId](#sam-function-mq-secretsmanagerkmskeyid): String
  [SourceAccessConfigurations](#sam-function-mq-sourceaccessconfigurations): List
```

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

 `BatchSize`   <a name="sam-function-mq-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch.  
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 100  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.  
*Minimum*: `1`  
*Maximum*: `10000`

 `Broker`   <a name="sam-function-mq-broker"></a>
L'Amazon Resource Name (ARN) del gestore di identità di Amazon MQ.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventSourceArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `DynamicPolicyName`   <a name="sam-function-mq-dynamicpolicyname"></a>
Per impostazione predefinita, il nome della policy AWS Identity and Access Management (IAM) serve `SamAutoGeneratedAMQPolicy` per la compatibilità con le versioni precedenti. Specificate `true` di utilizzare un nome generato automaticamente per la vostra policy IAM. Questo nome includerà l'ID logico dell'origine dell'evento Amazon MQ.  
Quando utilizzi più di una fonte di eventi Amazon MQ, specifica `true` per evitare nomi di policy IAM duplicati.
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `false`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Enabled`   <a name="sam-function-mq-enabled"></a>
Se`true`, la mappatura della fonte dell'evento è attiva. Per mettere in pausa il polling e la chiamata, imposta su. `false`  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `FilterCriteria`   <a name="sam-function-mq-filtercriteria"></a>
Un oggetto che definisce i criteri che determinano se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il [filtro AWS Lambda degli eventi nella Guida per](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) gli *AWS Lambda sviluppatori*.  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `KmsKeyArn`   <a name="sam-function-mq-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumBatchingWindowInSeconds`   <a name="sam-function-mq-maximumbatchingwindowinseconds"></a>
Il tempo massimo in secondi per la raccolta dei record prima di richiamare la funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Queues`   <a name="sam-function-mq-queues"></a>
Il nome della coda di destinazione del broker Amazon MQ da utilizzare.  
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Queues](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-queues)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `SecretsManagerKmsKeyId`   <a name="sam-function-mq-secretsmanagerkmskeyid"></a>
L'ID della chiave AWS Key Management Service (AWS KMS) di una chiave gestita dal cliente da Gestione dei segreti AWS. Richiesto quando si utilizza una chiave gestita dal cliente di Secrets Manager con un ruolo di esecuzione Lambda che non include l'`kms:Decrypt`autorizzazione.  
Il valore di questa proprietà è un UUID. Ad esempio: `1abc23d4-567f-8ab9-cde0-1fab234c5d67`.  
▬*Tipo:* stringa  
*Required*: Conditional  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `SourceAccessConfigurations`   <a name="sam-function-mq-sourceaccessconfigurations"></a>
Una matrice del protocollo di autenticazione o dell'host virtuale. Specificalo utilizzando il tipo di [SourceAccessConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration.html)dati.  
Per il tipo di origine `MQ` dell'evento, gli unici tipi di configurazione validi sono `BASIC_AUTH` e`VIRTUAL_HOST`.  
+ **`BASIC_AUTH`**— Il segreto di Secrets Manager che memorizza le credenziali del broker. Per questo tipo, la credenziale deve essere nel seguente formato:. `{"username": "your-username", "password": "your-password"}` È consentito un solo oggetto di tipo`BASIC_AUTH`.
+ **`VIRTUAL_HOST`**— Il nome dell'host virtuale nel tuo broker RabbitMQ. Lambda utilizzerà l'host di questo Rabbit MQ come origine dell'evento. È consentito un solo oggetto di tipo`VIRTUAL_HOST`.
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[SourceAccessConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-sourceaccessconfigurations)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

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

### Fonte di eventi Amazon MQ
<a name="sam-property-function-mq--examples--amazon-mq-event-source"></a>

Di seguito è riportato un esempio di tipo di origine di `MQ` eventi per un broker Amazon MQ.

#### YAML
<a name="sam-property-function-mq--examples--amazon-mq-event-source--yaml"></a>

```
Events:
  MQEvent:
    Type: MQ
    Properties:
      Broker: arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9
      Queues: List of queues
      SourceAccessConfigurations:
        - Type: BASIC_AUTH
          URI: arn:aws:secretsmanager:us-east-1:01234567890:secret:MyBrokerSecretName
      BatchSize: 200
      Enabled: true
```

# MSK
<a name="sam-property-function-msk"></a>

L'oggetto che descrive un tipo di sorgente di `MSK` eventi. Per ulteriori informazioni, consulta [Using AWS Lambda with Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) nella *AWS Lambda Developer Guide*.

AWS Serverless Application Model (AWS SAM) genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)risorsa quando viene impostato questo tipo di evento.

Per utilizzare Schema Registry, devi definire autorizzazioni specifiche per i ruoli IAM per la tua funzione. Vedi [Configurazione completa con ruoli IAM](#sam-property-function-msk-example-complete) per un esempio della configurazione richiesta.

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

Per dichiarare questa entità nel tuo AWS SAM modello, usa la seguente sintassi.

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

```
  [BatchSize](#sam-function-msk-batchsize): Integer
  [BisectBatchOnFunctionError](#sam-function-msk-bisectbatchonfunctionerror): Boolean
  [ConsumerGroupId](#sam-function-msk-consumergroupid): String
  DestinationConfig: [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-destinationconfig.html)
  [Enabled](#sam-function-msk-enabled): Boolean
  [FilterCriteria](#sam-function-msk-filtercriteria): [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
  [FunctionResponseTypes](#sam-function-msk-functionresponsetypes): List
  KmsKeyArn: String
  [MaximumBatchingWindowInSeconds](#sam-function-msk-maximumbatchingwindowinseconds): Integer
  [MaximumRecordAgeInSeconds](#sam-function-msk-maximumrecordageinseconds): Integer
  [MaximumRetryAttempts](#sam-function-msk-maximumretryattempts): Integer
  [LoggingConfig](#sam-function-msk-loggingconfig): [LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-loggingconfig.html)
  [MetricsConfig](#sam-function-msk-metricsconfig): [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig.html)
  [ProvisionedPollerConfig](#sam-function-msk-provisionedpollerconfig): [ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)
  [SchemaRegistryConfig](#sam-function-msk-schemaregistryconfig): [SchemaRegistryConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-schemaregistryconfig.html)
  SourceAccessConfigurations: [SourceAccessConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-sourceaccessconfigurations)
  [StartingPosition](#sam-function-msk-startingposition): String
  StartingPositionTimestamp: Double
  [Stream](#sam-function-msk-stream): String
  [Topics](#sam-function-msk-topics): List
```

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

 `BatchSize`   <a name="sam-function-msk-batchsize"></a>
Il numero massimo di registri in ogni batch che Lambda estrae dal flusso o dalla coda e invia alla funzione. Lambda passa tutti i registri del batch alla funzione in una singola chiamata, fino al limite di payload per la chiamata sincrona (6 MB).  
*Impostazione predefinita*: 100  
*Intervallo valido*: valore minimo di 1. Valore massimo di 10.000.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `BisectBatchOnFunctionError`   <a name="sam-function-msk-bisectbatchonfunctionerror"></a>
Se la funzione restituisce un errore, dividi il batch in due e riprova.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BisectBatchOnFunctionError](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-bisectbatchonfunctionerror)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `ConsumerGroupId`   <a name="sam-function-msk-consumergroupid"></a>
Una stringa che configura il modo in cui gli eventi verranno letti dagli argomenti di Kafka.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[AmazonManagedKafkaConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `DestinationConfig`   <a name="sam-function-msk-destinationconfig"></a>
Oggetto di configurazione che specifica la destinazione di un evento dopo che Lambda lo elabora.  
Utilizza questa proprietà per specificare la destinazione delle chiamate non riuscite dall'origine dell'evento Amazon MSK.  
*Tipo:* [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-destinationconfig.html)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `Enabled`   <a name="sam-function-msk-enabled"></a>
Disabilita la mappatura dell'origine eventi per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FilterCriteria`   <a name="sam-function-msk-filtercriteria"></a>
Un oggetto che definisce i criteri che determinano se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il [filtro AWS Lambda degli eventi nella Guida per](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) gli *AWS Lambda sviluppatori*.  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FunctionResponseTypes`   <a name="sam-function-msk-functionresponsetypes"></a>
Un elenco dei tipi di risposta attualmente applicati alla mappatura delle sorgenti degli eventi. Per ulteriori informazioni, consulta la pagina [Segnalazione di errori degli elementi batch](https://docs.aws.amazon.com/lambda/latest/dg/kafka-retry-configurations.html) nella *Guida per gli sviluppatori di AWS Lambda *.  
*Valori validi*: `ReportBatchItemFailures`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionResponseTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionresponsetypes)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `KmsKeyArn`   <a name="sam-function-msk-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumBatchingWindowInSeconds`   <a name="sam-function-msk-maximumbatchingwindowinseconds"></a>
Il tempo massimo in secondi per la raccolta dei record prima di richiamare la funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRecordAgeInSeconds`   <a name="sam-function-msk-maximumrecordageinseconds"></a>
L'età massima di un record che Lambda invia a una funzione per l'elaborazione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRecordAgeInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumrecordageinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRetryAttempts`   <a name="sam-function-msk-maximumretryattempts"></a>
Il numero massimo di ripetizioni consentite quando la funzione restituisce un errore.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRetryAttempts](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumretryattempts)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `LoggingConfig`   <a name="sam-function-msk-loggingconfig"></a>
Un oggetto di configurazione che specifica la configurazione di registrazione per la mappatura dell'origine degli eventi.  
*Tipo:* [LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-loggingconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-loggingconfig.html)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `MetricsConfig`   <a name="sam-function-msk-metricsconfig"></a>
Un oggetto di configurazione che specifica la configurazione delle metriche per la mappatura dell'origine degli eventi.  
*Tipo:* [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig.html)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `ProvisionedPollerConfig`   <a name="sam-function-msk-provisionedpollerconfig"></a>
Configurazione per aumentare la quantità di poller utilizzati per calcolare le mappature delle sorgenti degli eventi. Questa configurazione consente un minimo di 1 poller e un massimo di 2000 poller. Per un esempio, fare riferimento a. [ProvisionedPollerConfig esempio](#sam-property-function-msk-example-provisionedpollerconfig)  
*Tipo:* [ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

`SchemaRegistryConfig`  <a name="sam-function-msk-schemaregistryconfig"></a>
Configurazione per l'utilizzo di un registro degli schemi con l'origine degli eventi Kafka.  
Questa funzionalità deve essere `ProvisionedPollerConfig` configurata.
*Tipo*: SchemaRegistryConfig  
*Obbligatorio:* no  
*CloudFormation compatibilità:* questa proprietà viene passata direttamente alla `[AmazonManagedKafkaEventSourceConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-amazonmanagedkafkaeventsourceconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `SourceAccessConfigurations`   <a name="sam-function-msk-sourceaccessconfigurations"></a>
Un array del protocollo di autenticazione, dei componenti VPC o dell'host virtuale per proteggere e definire l'origine eventi.  
*Valori validi*: `CLIENT_CERTIFICATE_TLS_AUTH`  
*Tipo*: elenco di [SourceAccessConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità:* questa proprietà fa parte della [AmazonManagedKafkaEventSourceConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-eventsourcemapping-amazonmanagedkafkaeventsourceconfig)proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `StartingPosition`   <a name="sam-function-msk-startingposition"></a>
La posizione in un flusso da cui iniziare la lettura.  
+ `AT_TIMESTAMP`— Specificare l'ora a partire dalla quale iniziare a leggere i record.
+ `LATEST`— Leggi solo i nuovi record.
+ `TRIM_HORIZON`— Elabora tutti i record disponibili.
*Valori validi*: `AT_TIMESTAMP` \$1 `LATEST` \$1 `TRIM_HORIZON`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPosition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPositionTimestamp`   <a name="sam-function-msk-startingpositiontimestamp"></a>
L'ora da cui iniziare a leggere, in secondi di tempo Unix. Definisce `StartingPositionTimestamp` quando `StartingPosition` è specificato come`AT_TIMESTAMP`.  
*Tipo:* numero a doppia precisione  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPositionTimestamp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingpositiontimestamp)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Stream`   <a name="sam-function-msk-stream"></a>
L'Amazon Resource Name (ARN) del flusso di dati o di un consumatore di streaming.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventSourceArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Topics`   <a name="sam-function-msk-topics"></a>
Il nome dell'argomento Kafka.  
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Topics](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-topics)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

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

### Configurazione completa con ruoli IAM
<a name="sam-property-function-msk-example-complete"></a>

L'esempio seguente mostra una configurazione completa che include la configurazione del ruolo IAM richiesta per l'utilizzo di Schema Registry:

```
Parameters:
  PreCreatedSubnetOne:
    Type: String
  PreCreatedSubnetTwo:
    Type: String
  MskClusterName4:
    Type: String

Resources:
  MyLambdaExecutionRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: '2012-10-17		 	 	 '
        Statement:
        - Action: [sts:AssumeRole]
          Effect: Allow
          Principal:
            Service: [lambda.amazonaws.com]
      Policies:
      - PolicyName: KafkaClusterPermissions
        PolicyDocument:
          Statement:
          - Action: [kafka:DescribeClusterV2, kafka:GetBootstrapBrokers]
            Effect: Allow
            Resource: 'arn:aws:kafka:us-east-1:123456789012:cluster/*'
      - PolicyName: KafkaAuthPolicy
        PolicyDocument:
          Statement:
          - Action: [secretsmanager:GetSecretValue, kms:Decrypt]
            Effect: "Allow"
            Resource: ['arn:aws:secretsmanager:us-west-2:123456789012:secret:kafkaSecret-******',
                        'arn:aws:kms:us-west-2:123456789012:key/keyId']
      - PolicyName: ENIPolicy
        PolicyDocument:
          Statement:
          - Action: [ec2:CreateNetworkInterface,
              ec2:DescribeNetworkInterfaces, ec2:DescribeVpcs, ec2:DeleteNetworkInterface,
              ec2:DescribeSubnets, ec2:DescribeSecurityGroups]
            Effect: Allow
            Resource: '*'
      - PolicyName: SchemaRegistryPolicy
        PolicyDocument:
          Statement:
          - Action: [glue:GetRegistry]
            Effect: Allow
            Resource: 'arn:aws:glue:{region}:{account-id}:registry/{registry-name}'
      - PolicyName: SchemaVersionsPolicy
        PolicyDocument:
          Statement:
          - Action: [glue:GetSchemaVersions]
            Effect: Allow
            Resource: '*'
      ManagedPolicyArns:
      - !Sub arn:${AWS::Partition}:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
      Tags:
      - {Value: SAM, Key: lambda:createdBy}

  MyMskCluster:
    Type: AWS::MSK::Cluster
    Properties:
      BrokerNodeGroupInfo:
        ClientSubnets:
        - Ref: PreCreatedSubnetOne
        - Ref: PreCreatedSubnetTwo
        InstanceType: kafka.t3.small
        StorageInfo:
          EBSStorageInfo:
            VolumeSize: 1
      ClusterName:
        Ref: MskClusterName4
      KafkaVersion: 3.8.x
      NumberOfBrokerNodes: 2

  MyMskStreamProcessor:
    Type: AWS::Serverless::Function
    Properties:
      Runtime: nodejs18.x
      Handler: index.handler
      CodeUri: ${codeuri}
      Role:
        Fn::GetAtt: [MyLambdaExecutionRole, Arn]
      Events:
        MyMskEvent:
          Type: MSK
          Properties:
            StartingPosition: LATEST
            Stream:
              Ref: MyMskCluster
            SourceAccessConfigurations:
            - Type: SASL_SCRAM_512_AUTH
              URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:my-path/my-secret-name-1a2b3c
            Topics:
            - SchemaRegistryTestTopic
            ProvisionedPollerConfig:
              MinimumPollers: 1
            SchemaRegistryConfig:
              AccessConfigs:
              - Type: BASIC_AUTH
                URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:my-path/my-secret-name-1a2b3c
              SchemaValidationConfigs:
              - Attribute: KEY
              EventRecordFormat: JSON
              SchemaRegistryURI: !Sub arn:${AWS::Partition}:glue:us-west-2:123456789012:registry/myregistry
```

### ProvisionedPollerConfig esempio
<a name="sam-property-function-msk-example-provisionedpollerconfig"></a>

```
ProvisionedPollerConfig:
  MinimumPollers: 1
  MaximumPollers: 200
```

### Esempio di Amazon MSK per un cluster esistente
<a name="sam-property-function-msk--examples--amazon-msk-example-for-existing-cluster"></a>

Di seguito è riportato un esempio di un tipo di origine di `MSK` eventi per un cluster Amazon MSK che esiste già in un Account AWS.

#### YAML
<a name="sam-property-function-msk--examples--amazon-msk-example-for-existing-cluster--yaml"></a>

```
Events:
  MSKEvent:
    Type: MSK
    Properties:
      StartingPosition: LATEST
      Stream: arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2
      Topics:
        - MyTopic
```

### Esempio di Amazon MSK per un cluster dichiarato nello stesso modello
<a name="sam-property-function-msk--examples--amazon-msk-example-for-cluster-declared-in-same-template"></a>

Di seguito è riportato un esempio di un tipo di origine di `MSK` eventi per un cluster Amazon MSK dichiarato nello stesso file modello.

#### YAML
<a name="sam-property-function-msk--examples--amazon-msk-example-for-cluster-declared-in-same-template--yaml"></a>

```
Events:
  MSKEvent:
    Type: MSK
    Properties:
      StartingPosition: LATEST
      Stream:
        Ref: MyMskCluster   # This must be the name of an MSK cluster declared in the same template file
      Topics:
        - MyTopic
```

#### Fonte di eventi MSK con registro dello schema
<a name="sam-property-function-msk-example-schemaregistry"></a>

Di seguito è riportato un esempio di un tipo di origine di `MSK` eventi configurato con un registro dello schema.

```
Events:
  MSKEvent:
    Type: MSK
    Properties:
      StartingPosition: LATEST
      Stream:
        Ref: MyMskCluster
      Topics:
        - SchemaRegistryTestTopic
      ProvisionedPollerConfig:
        MinimumPollers: 1
      SchemaRegistryConfig:
        SchemaRegistryURI: !Sub arn:${AWS::Partition}:glue:us-west-2:123456789012:registry/myregistry
        EventRecordFormat: JSON
        SchemaValidationConfigs:
          - Attribute: KEY
          - Attribute: VALUE
```

#### Fonte di eventi MSK con registro degli schemi Confluent
<a name="sam-property-function-msk-example-schemaregistry-confluent"></a>

Di seguito è riportato un esempio di un tipo di origine di `MSK` eventi configurato con un Confluent Schema Registry.

```
Events:
  MSKEvent:
    Type: MSK
    Properties:
      StartingPosition: LATEST
      Stream:
        Ref: MyMskCluster
      Topics:
        - SchemaRegistryTestTopic
      ProvisionedPollerConfig:
        MinimumPollers: 1
      SchemaRegistryConfig:
        SchemaRegistryURI: https://my-schema-registry.confluent.cloud
        AccessConfigs:
          - Type: BASIC_AUTH
            URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:my-secret
        EventRecordFormat: JSON
        SchemaValidationConfigs:
          - Attribute: KEY
          - Attribute: VALUE
```

# S3
<a name="sam-property-function-s3"></a>

L'oggetto che descrive un tipo di origine `S3` dell'evento.

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

```
  [Bucket](#sam-function-s3-bucket): String
  [Events](#sam-function-s3-events): String | List
  [Filter](#sam-function-s3-filter): [NotificationFilter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter.html)
```

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

 `Bucket`   <a name="sam-function-s3-bucket"></a>
Nome bucket S3. Questo bucket deve esistere nello stesso modello.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è simile alla `[BucketName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-name)` proprietà di una `AWS::S3::Bucket` risorsa. Questo è un campo obbligatorio in SAM. Questo campo accetta solo un riferimento al bucket S3 creato in questo modello

 `Events`   <a name="sam-function-s3-events"></a>
L'evento bucket Amazon S3 per il quale richiamare la funzione Lambda. Consulta i [tipi di eventi supportati da Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#supported-notification-event-types) per un elenco di valori validi.  
*Tipo*: Stringa \$1 Elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente alla `[Event](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-lambdaconfig.html#cfn-s3-bucket-notificationconfig-lambdaconfig-event)` proprietà del tipo di `AWS::S3::Bucket` `LambdaConfiguration` dati.

 `Filter`   <a name="sam-function-s3-filter"></a>
Le regole di filtro che determinano quali oggetti Amazon S3 richiamano la funzione Lambda. Per informazioni sul filtraggio dei nomi chiave di Amazon S3, consulta Configuring [Amazon S3 Event Notifications nella Amazon Simple](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) Storage Service User *Guide*.  
*Tipo:* [NotificationFilter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Filter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter.html)` proprietà del tipo di dati. `AWS::S3::Bucket` `LambdaConfiguration`

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

### Evento S3
<a name="sam-property-function-s3--examples--s3-event"></a>

Esempio di evento S3.

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

```
Events:
  S3Event:
    Type: S3
    Properties:
      Bucket:
        Ref: ImagesBucket     # This must be the name of an S3 bucket declared in the same template file
      Events: s3:ObjectCreated:*
      Filter:
        S3Key:
          Rules:
          - Name: prefix      # or "suffix"
            Value: value      # The value to search for in the S3 object key names
```

# Schedule
<a name="sam-property-function-schedule"></a>

L'oggetto che descrive un tipo di origine `Schedule` degli eventi, che imposta la funzione serverless come destinazione di una EventBridge regola Amazon che si attiva in base a una pianificazione. 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 Serverless Application Model (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.

**Nota**  
EventBridge ora offre una nuova funzionalità di pianificazione, [Amazon EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html). Amazon EventBridge Scheduler è uno strumento di pianificazione senza server che ti consente di creare, eseguire e gestire attività da un unico servizio gestito centralizzato. EventBridge Schedulerè altamente personalizzabile e offre una migliore scalabilità rispetto alle regole EventBridge pianificate, con un set più ampio di operazioni API mirate e. Servizi AWS  
Ti consigliamo di utilizzare EventBridge Scheduler per invocare le destinazioni in base a una pianificazione. Per definire questo tipo di origine degli eventi nei tuoi AWS SAM modelli, consulta[ScheduleV2](sam-property-function-schedulev2.md).

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

```
  [DeadLetterConfig](#sam-function-schedule-deadletterconfig): DeadLetterConfig
  [Description](#sam-function-schedule-description): String
  [Enabled](#sam-function-schedule-enabled): Boolean
  [Input](#sam-function-schedule-input): String
  [Name](#sam-function-schedule-name): String
  [RetryPolicy](#sam-function-schedule-retrypolicy): [RetryPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-target.html#cfn-events-rule-target-retrypolicy)
  [Schedule](#sam-function-schedule-schedule): String
  [State](#sam-function-schedule-state): String
```

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

 `DeadLetterConfig`   <a name="sam-function-schedule-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-scheduledeadletterconfig.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.

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

 `Enabled`   <a name="sam-function-schedule-enabled"></a>
Indica se la regola è abilitata.  
Per disabilitare la regola, imposta questa proprietà su`false`.  
Specificate la `State` proprietà `Enabled` o, ma non entrambe.
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile 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. Se questa proprietà è impostata su `true` allora AWS SAM passa`ENABLED`, altrimenti passa`DISABLED`.

 `Input`   <a name="sam-function-schedule-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.

 `Name`   <a name="sam-function-schedule-name"></a>
Nome della regola . Se non specifichi un nome, CloudFormation genera un ID fisico univoco e utilizza tale ID per il 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.

 `RetryPolicy`   <a name="sam-function-schedule-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`

 `Schedule`   <a name="sam-function-schedule-schedule"></a>
L'espressione di programmazione che determina il momento e la frequenza di esecuzione della regola. Per ulteriori informazioni, consulta [Pianificazione di espressioni per regole](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html).  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ScheduleExpression](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-scheduleexpression)` proprietà di una `AWS::Events::Rule` risorsa.

 `State`   <a name="sam-function-schedule-state"></a>
Lo stato della regola.  
*Valori accettati:* `DISABLED | ENABLED`  
Specificate la `State` proprietà `Enabled` o, ma non entrambe.
▬*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.

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

### CloudWatch Pianifica evento
<a name="sam-property-function-schedule--examples--cloudwatch-schedule-event"></a>

CloudWatch Esempio di evento di pianificazione

#### YAML
<a name="sam-property-function-schedule--examples--cloudwatch-schedule-event--yaml"></a>

```
CWSchedule:
  Type: Schedule
  Properties:
    Schedule: 'rate(1 minute)'
    Name: TestSchedule
    Description: test schedule
    Enabled: false
```

# DeadLetterConfig
<a name="sam-property-function-scheduledeadletterconfig"></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-scheduledeadletterconfig-syntax"></a>

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

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

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

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

 `Arn`   <a name="sam-function-scheduledeadletterconfig-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-scheduledeadletterconfig-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-scheduledeadletterconfig-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-scheduledeadletterconfig--examples"></a>

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

DeadLetterConfig

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

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

# ScheduleV2
<a name="sam-property-function-schedulev2"></a>

L'oggetto che descrive un tipo di origine `ScheduleV2` dell'evento, che imposta la funzione serverless come destinazione di un evento Amazon EventBridge Scheduler che si attiva in base a una pianificazione. Per ulteriori informazioni, consulta [Cos'è Amazon EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)? nella Guida per l'*utente di EventBridge Scheduler*.

AWS Serverless Application Model (AWS SAM) genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html)risorsa quando viene impostato questo tipo di evento.

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

```
[DeadLetterConfig](#sam-function-schedulev2-deadletterconfig): DeadLetterConfig
[Description](#sam-function-schedulev2-description): String
[EndDate](#sam-function-schedulev2-enddate): String
[FlexibleTimeWindow](#sam-function-schedulev2-flexibletimewindow): FlexibleTimeWindow
[GroupName](#sam-function-schedulev2-groupname): String
[Input](#sam-function-schedulev2-input): String
[KmsKeyArn](#sam-function-schedulev2-kmskeyarn): String
[Name](#sam-function-schedulev2-name): String
OmitName: Boolean
[PermissionsBoundary](#sam-function-schedulev2-permissionsboundary): String
[RetryPolicy](#sam-function-schedulev2-retrypolicy): RetryPolicy
[RoleArn](#sam-function-schedulev2-rolearn): String
[ScheduleExpression](#sam-function-schedulev2-schedule): String
[ScheduleExpressionTimezone](#sam-function-schedulev2-scheduleexpressiontimezone): String
[StartDate](#sam-function-schedulev2-startdate): String
[State](#sam-function-schedulev2-state): String
```

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

 `DeadLetterConfig`   <a name="sam-function-schedulev2-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 [Configurazione di una coda di lettere non scritte per Scheduler nella Scheduler User Guide](https://docs.aws.amazon.com/scheduler/latest/UserGuide/configuring-schedule-dlq.html). EventBridge 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-scheduledeadletterconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[DeadLetterConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-scheduler-schedule-target.html#cfn-scheduler-schedule-target-deadletterconfig)` proprietà del tipo di dati. `AWS::Scheduler::Schedule` `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.

 `Description`   <a name="sam-function-schedulev2-description"></a>
Una descrizione della pianificazione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-description)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `EndDate`   <a name="sam-function-schedulev2-enddate"></a>
La data, in UTC, prima della quale la pianificazione può richiamare il suo obiettivo. A seconda dell'espressione di ricorrenza della pianificazione, le chiamate potrebbero interrompersi nel momento in cui specifichi **EndDate** o prima.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EndDate](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-enddate)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `FlexibleTimeWindow`   <a name="sam-function-schedulev2-flexibletimewindow"></a>
Consente la configurazione di una finestra all'interno della quale è possibile richiamare una pianificazione.  
*Tipo:* [FlexibleTimeWindow](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-flexibletimewindow)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FlexibleTimeWindow](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-flexibletimewindow)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `GroupName`   <a name="sam-function-schedulev2-groupname"></a>
Il nome del gruppo di pianificazioni da associare a questa pianificazione. Se non è definito, viene utilizzato il gruppo predefinito.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[GroupName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-groupname)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `Input`   <a name="sam-function-schedulev2-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-scheduler-schedule-target.html#cfn-scheduler-schedule-target-input)` proprietà di una `AWS::Scheduler::Schedule Target` risorsa.

 `KmsKeyArn`   <a name="sam-function-schedulev2-kmskeyarn"></a>
L'ARN per una chiave KMS che verrà utilizzata per crittografare i dati dei clienti.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-kmskeyarn)` proprietà di una risorsa. `AWS::Scheduler::Schedule`

 `Name`   <a name="sam-function-schedulev2-name"></a>
Il nome della pianificazione. Se non specifichi un nome, AWS SAM genera un nome nel formato `Function-Logical-IDEvent-Source-Name` e utilizza quell'ID per il nome della pianificazione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-name)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

`OmitName`  <a name="sam-function-schedulev2-omitname"></a>
Per impostazione predefinita, AWS SAM genera e utilizza un nome di pianificazione nel formato di*<Function-logical-ID><event-source-name>*. Imposta questa proprietà in `true` modo da CloudFormation generare un ID fisico univoco e utilizzalo invece per il nome della pianificazione.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `false`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `PermissionsBoundary`   <a name="sam-function-schedulev2-permissionsboundary"></a>
L'ARN della policy utilizzata per impostare il limite delle autorizzazioni per il ruolo.  
Se `PermissionsBoundary` definito, AWS SAM applicherà gli stessi limiti al ruolo IAM di destinazione della pianificazione dello scheduler.
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[PermissionsBoundary](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-permissionsboundary)` proprietà di una `AWS::IAM::Role` risorsa.

 `RetryPolicy`   <a name="sam-function-schedulev2-retrypolicy"></a>
Un oggetto **RetryPolicy** che include informazioni sulle impostazioni dei criteri di nuovi tentativi.  
*Tipo:* [RetryPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-scheduler-schedule-target.html#cfn-scheduler-schedule-target-retrypolicy)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[RetryPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-scheduler-schedule-target.html#cfn-scheduler-schedule-target-retrypolicy)` proprietà del tipo di `AWS::Scheduler::Schedule` `Target` dati.

 `RoleArn`   <a name="sam-function-schedulev2-rolearn"></a>
L'ARN del ruolo IAM che EventBridge Scheduler utilizzerà per la destinazione quando viene richiamata la pianificazione.  
*Tipo:* [RoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-scheduler-schedule-target.html#cfn-scheduler-schedule-target-rolearn)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[RoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-scheduler-schedule-target.html#cfn-scheduler-schedule-target-rolearn)` proprietà del tipo di dati. `AWS::Scheduler::Schedule` `Target`

 `ScheduleExpression`   <a name="sam-function-schedulev2-scheduleexpression"></a>
L'espressione di pianificazione che determina quando e con quale frequenza viene eseguito l'evento di pianificazione dello scheduler.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ScheduleExpression](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-scheduleexpression)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `ScheduleExpressionTimezone`   <a name="sam-function-schedulev2-scheduleexpressiontimezone"></a>
Il fuso orario in cui viene valutata l'espressione di pianificazione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ScheduleExpressionTimezone](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-scheduleexpressiontimezone)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `StartDate`   <a name="sam-function-schedulev2-startdate"></a>
La data, in UTC, dopo la quale la pianificazione può iniziare a richiamare un obiettivo. A seconda dell'espressione di ricorrenza della pianificazione, le chiamate potrebbero interrompersi nel momento in cui specifichi **StartDate** o dopo.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartDate](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-startdate)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

 `State`   <a name="sam-function-schedulev2-state"></a>
Lo stato della pianificazione dello Scheduler.  
*Valori accettati:* `DISABLED | ENABLED`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[State](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-scheduler-schedule.html#cfn-scheduler-schedule-state)` proprietà di una `AWS::Scheduler::Schedule` risorsa.

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

### Esempio di base di definizione di una risorsa ScheduleV2
<a name="sam-property-function-schedulev2--examples--example1"></a>

```
Resources:
  Function:
    Properties:
      ...
      Events:
        ScheduleEvent:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: "rate(1 minute)"
        ComplexScheduleEvent:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: rate(1 minute)
            FlexibleTimeWindow:
              Mode: FLEXIBLE
              MaximumWindowInMinutes: 5
            StartDate: '2022-12-28T12:00:00.000Z'
            EndDate: '2023-01-28T12:00:00.000Z'
            ScheduleExpressionTimezone: UTC
            RetryPolicy:
              MaximumRetryAttempts: 5
              MaximumEventAgeInSeconds: 300
            DeadLetterConfig:
              Type: SQS
```

**Nota**  
L'ID fisico generato di ScheduleV2 non include il nome dello stack.

# SelfManagedKafka
<a name="sam-property-function-selfmanagedkafka"></a>

L'oggetto che descrive un tipo di origine `SelfManagedKafka` dell'evento. *Per ulteriori informazioni, consulta [Utilizzo AWS Lambda con Apache Kafka autogestito](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html) nella Guida per gli sviluppatori.AWS Lambda *

AWS Serverless Application Model (AWS SAM) genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)risorsa quando viene impostato questo tipo di evento.

Per utilizzare Schema Registry, devi definire autorizzazioni di ruolo IAM specifiche per la tua funzione. Vedi [Configurazione completa con ruoli IAM](sam-property-function-msk.md#sam-property-function-msk-example-complete) per un esempio della configurazione richiesta.

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

Per dichiarare questa entità nel AWS SAM modello, utilizza la seguente sintassi.

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

```
  [BatchSize](#sam-function-selfmanagedkafka-batchsize): Integer
  [BisectBatchOnFunctionError](#sam-function-selfmanagedkafka-bisectbatchonfunctionerror): Boolean
  [ConsumerGroupId](#sam-function-selfmanagedkafka-consumergroupid): String
  DestinationConfig: [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-destinationconfig.html)
  [Enabled](#sam-function-selfmanagedkafka-enabled): Boolean
  [FilterCriteria](#sam-function-selfmanagedkafka-filtercriteria): [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
  [KafkaBootstrapServers](#sam-function-selfmanagedkafka-kafkabootstrapservers): List
  [FunctionResponseTypes](#sam-function-selfmanagedkafka-functionresponsetypes): List
  KmsKeyArn: String
  [LoggingConfig](#sam-function-selfmanagedkafka-loggingconfig): LoggingConfig
  [MaximumRecordAgeInSeconds](#sam-function-selfmanagedkafka-maximumrecordageinseconds): Integer
  [MaximumRetryAttempts](#sam-function-selfmanagedkafka-maximumretryattempts): Integer
  [MetricsConfig](#sam-function-selfmanagedkafka-metricsconfig): MetricsConfig
  [ProvisionedPollerConfig](#sam-function-selfmanagedkafka-provisionedpollerconfig): [ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)
  [SchemaRegistryConfig](#sam-function-selfmanagedkafka-schemaregistryconfig): [SchemaRegistryConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-schemaregistryconfig.html)
  [SourceAccessConfigurations](#sam-function-selfmanagedkafka-sourceaccessconfigurations): [SourceAccessConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-sourceaccessconfigurations)
  StartingPosition: String
  StartingPositionTimestamp: Double
  [Topics](#sam-function-selfmanagedkafka-topics): List
```

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

 `BatchSize`   <a name="sam-function-selfmanagedkafka-batchsize"></a>
Il numero massimo di record in ogni batch che Lambda estrae dal tuo stream e invia alla tua funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 100  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.  
*Minimum*: `1`  
*Maximum*: `10000`

 `BisectBatchOnFunctionError`   <a name="sam-function-selfmanagedkafka-bisectbatchonfunctionerror"></a>
Se la funzione restituisce un errore, dividi il batch in due e riprova.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BisectBatchOnFunctionError](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-bisectbatchonfunctionerror)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `ConsumerGroupId`   <a name="sam-function-selfmanagedkafka-consumergroupid"></a>
Una stringa che configura il modo in cui gli eventi verranno letti dagli argomenti di Kafka.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[SelfManagedKafkaEventSourceConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `DestinationConfig`   <a name="sam-function-selfmanagedkafka-destinationconfig"></a>
Oggetto di configurazione che specifica la destinazione di un evento dopo che Lambda lo elabora.  
Utilizzate questa proprietà per specificare la destinazione delle chiamate fallite dalla fonte di eventi Kafka autogestita.  
*Tipo:* [DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-destinationconfig.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[ DestinationConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig)` `AWS::Lambda::EventSourceMapping`

 `Enabled`   <a name="sam-function-selfmanagedkafka-enabled"></a>
Disabilita la mappatura dell'origine eventi per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FilterCriteria`   <a name="sam-function-selfmanagedkafka-filtercriteria"></a>
Un oggetto che definisce i criteri per determinare se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il [filtro AWS Lambda degli eventi nella Guida per](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) gli *AWS Lambda sviluppatori*.  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-filtercriteria)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `KafkaBootstrapServers`   <a name="sam-function-selfmanagedkafka-kafkabootstrapservers"></a>
L'elenco dei server bootstrap per i tuoi broker Kafka. Includi la porta, ad esempio `broker.example.com:xxxx`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `FunctionResponseTypes`   <a name="sam-function-selfmanagedkafka-functionresponsetypes"></a>
Un elenco dei tipi di risposta attualmente applicati alla mappatura delle sorgenti degli eventi. Per ulteriori informazioni, consulta la pagina [Segnalazione di errori degli elementi batch](https://docs.aws.amazon.com/lambda/latest/dg/kafka-retry-configurations.html) nella *Guida per gli sviluppatori di AWS Lambda *.  
*Valori validi*: `ReportBatchItemFailures`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionResponseTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionresponsetypes)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `KmsKeyArn`   <a name="sam-function-selfmanagedkafka-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `LoggingConfig`   <a name="sam-function-selfmanagedkafka-loggingconfig"></a>
La configurazione di registrazione per l'origine dell'evento.  
*Tipo:* [LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-loggingconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-loggingconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRecordAgeInSeconds`   <a name="sam-function-selfmanagedkafka-maximumrecordageinseconds"></a>
L'età massima di un record che Lambda invia a una funzione per l'elaborazione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRecordAgeInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumrecordageinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MetricsConfig`   <a name="sam-function-selfmanagedkafka-metricsconfig"></a>
La configurazione delle metriche per l'origine del tuo evento.  
*Tipo:* [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-metricsconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumRetryAttempts`   <a name="sam-function-selfmanagedkafka-maximumretryattempts"></a>
Il numero massimo di ripetizioni consentite quando la funzione restituisce un errore.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumRetryAttempts](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumretryattempts)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `ProvisionedPollerConfig`   <a name="sam-function-selfmanagedkafka-provisionedpollerconfig"></a>
Configurazione per aumentare la quantità di poller utilizzati per calcolare le mappature delle sorgenti degli eventi. Questa configurazione consente un minimo di 1 poller e un massimo di 2000 poller. Per un esempio, fare riferimento a [ProvisionedPollerConfig esempio](#sam-property-function-selfmanagedkafka-example-provisionedpollerconfig)  
*Tipo:* [ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-provisionedpollerconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

`SchemaRegistryConfig`  <a name="sam-function-selfmanagedkafka-schemaregistryconfig"></a>
Configurazione per l'utilizzo di un registro degli schemi con la fonte di eventi Kafka autogestita.  
Questa funzionalità deve essere configurata`ProvisionedPollerConfig`.
*Tipo:* [SchemaRegistryConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-schemaregistryconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità:* questa proprietà viene passata direttamente alla `[SelfManagedKafkaEventSourceConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `SourceAccessConfigurations`   <a name="sam-function-selfmanagedkafka-sourceaccessconfigurations"></a>
Un array del protocollo di autenticazione, dei componenti VPC o dell'host virtuale per proteggere e definire l'origine eventi.  
*Valori validi*: `BASIC_AUTH | CLIENT_CERTIFICATE_TLS_AUTH | SASL_SCRAM_256_AUTH | SASL_SCRAM_512_AUTH | SERVER_ROOT_CA_CERTIFICATE`  
*Tipo*: elenco di [SourceAccessConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration)  
*Obbligatorio:* sì  
*CloudFormation compatibilità:* questa proprietà fa parte della `[SelfManagedKafkaEventSourceConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPosition`   <a name="sam-function-selfmanagedkafka-startingposition"></a>
La posizione in un flusso da cui iniziare la lettura.  
+ `AT_TIMESTAMP`— Specificare l'ora a partire dalla quale iniziare a leggere i record.
+ `LATEST`— Leggi solo i nuovi record.
+ `TRIM_HORIZON`— Elabora tutti i record disponibili.
*Valori validi*: `AT_TIMESTAMP` \$1 `LATEST` \$1 `TRIM_HORIZON`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPosition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `StartingPositionTimestamp`   <a name="sam-function-selfmanagedkafka-startingpositiontimestamp"></a>
L'ora da cui iniziare a leggere, in secondi di tempo Unix. Definisce `StartingPositionTimestamp` quando `StartingPosition` è specificato come`AT_TIMESTAMP`.  
*Tipo:* numero a doppia precisione  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[StartingPositionTimestamp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingpositiontimestamp)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Topics`   <a name="sam-function-selfmanagedkafka-topics"></a>
Il nome dell'argomento Kafka.  
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Topics](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-topics)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

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

### Configurazione completa con ruoli IAM
<a name="sam-property-function-selfmanagedkafka-example-complete"></a>

L'esempio seguente mostra una configurazione completa che include la configurazione del ruolo IAM richiesta per l'utilizzo di Schema Registry:

```
Parameters:
  PreCreatedSubnetOne:
    Type: String
  PreCreatedSubnetTwo:
    Type: String

Resources:
  MyLambdaExecutionRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: '2012-10-17		 	 	 '
        Statement:
        - Action: [sts:AssumeRole]
          Effect: Allow
          Principal:
            Service: [lambda.amazonaws.com]
      Policies:
      - PolicyName: KafkaAuthPolicy
        PolicyDocument:
          Statement:
          - Action: [secretsmanager:GetSecretValue, kms:Decrypt]
            Effect: "Allow"
            Resource: ['arn:aws:secretsmanager:us-west-2:123456789012:secret:kafkaSecret-******',
                        'arn:aws:kms:us-west-2:123456789012:key/keyId']
      - PolicyName: ENIPolicy
        PolicyDocument:
          Statement:
          - Action: [ec2:CreateNetworkInterface,
              ec2:DescribeNetworkInterfaces, ec2:DescribeVpcs, ec2:DeleteNetworkInterface,
              ec2:DescribeSubnets, ec2:DescribeSecurityGroups]
            Effect: Allow
            Resource: '*'
      - PolicyName: SchemaRegistryPolicy
        PolicyDocument:
          Statement:
          - Action: [glue:GetRegistry]
            Effect: Allow
            Resource: 'arn:aws:glue:{region}:{account-id}:registry/{registry-name}'
      - PolicyName: SchemaVersionsPolicy
        PolicyDocument:
          Statement:
          - Action: [glue:GetSchemaVersions]
            Effect: Allow
            Resource: '*'
      ManagedPolicyArns:
      - !Sub arn:${AWS::Partition}:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
      Tags:
      - {Value: SAM, Key: lambda:createdBy}

  MyKafkaProcessor:
    Type: AWS::Serverless::Function
    Properties:
      Runtime: nodejs18.x
      Handler: index.handler
      CodeUri: ${codeuri}
      Role:
        Fn::GetAtt: [MyLambdaExecutionRole, Arn]
      Events:
        SelfManagedKafkaEvent:
          Type: SelfManagedKafka
          Properties:
            KafkaBootstrapServers:
              - my-kafka-broker-1:9092
              - my-kafka-broker-2:9092
            Topics:
              - SchemaRegistryTestTopic
            StartingPosition: LATEST
            SourceAccessConfigurations:
              - Type: VPC_SUBNET
                URI: subnet:subnet-12345678
              - Type: VPC_SECURITY_GROUP
                URI: security_group:sg-12345678
              - Type: BASIC_AUTH
                URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:my-path/my-secret-name-1a2b3c
            ProvisionedPollerConfig:
              MinimumPollers: 1
            SchemaRegistryConfig:
              AccessConfigs:
              - Type: BASIC_AUTH
                URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:my-path/my-secret-name-1a2b3c
              SchemaValidationConfigs:
              - Attribute: KEY
              EventRecordFormat: JSON
              SchemaRegistryURI: !Sub arn:${AWS::Partition}:glue:us-west-2:123456789012:registry/myregistry
```

### ProvisionedPollerConfig esempio
<a name="sam-property-function-selfmanagedkafka-example-provisionedpollerconfig"></a>

```
ProvisionedPollerConfig:
  MinimumPollers: 1
  MaximumPollers: 200
```

### Fonte di eventi Kafka autogestita
<a name="sam-property-function-selfmanagedkafka--examples--self-managed-kafka-event-source"></a>

Di seguito è riportato un esempio di tipo di sorgente di `SelfManagedKafka` eventi.

#### YAML
<a name="sam-property-function-selfmanagedkafka--examples--self-managed-kafka-event-source--yaml"></a>

```
Events:
  SelfManagedKafkaEvent:
    Type: SelfManagedKafka
    Properties:
      BatchSize: 1000
      Enabled: true
      KafkaBootstrapServers:
        - abc.xyz.com:xxxx
      SourceAccessConfigurations:
        -  Type: BASIC_AUTH
           URI: arn:aws:secretsmanager:us-west-2:123456789012:secret:my-path/my-secret-name-1a2b3c
      Topics:
        - MyKafkaTopic
```

### Fonte di eventi Kafka gestita autonomamente con Schema Registry AWS Glue
<a name="sam-property-function-selfmanagedkafka-example-schemaregistry"></a>

Di seguito è riportato un esempio di un tipo di sorgente di `SelfManagedKafka` eventi configurato con AWS Glue Schema Registry.

```
Events:
  SelfManagedKafkaEvent:
    Type: SelfManagedKafka
    Properties:
      KafkaBootstrapServers:
        - abc.xyz.com:9092
      Topics:
        - SchemaRegistryTestTopic
      StartingPosition: LATEST
      ProvisionedPollerConfig:
        MinimumPollers: 1
      SchemaRegistryConfig:
        SchemaRegistryURI: !Sub arn:${AWS::Partition}:glue:us-west-2:123456789012:registry/myregistry
        EventRecordFormat: JSON
        SchemaValidationConfigs:
          - Attribute: KEY
          - Attribute: VALUE
      SourceAccessConfigurations:
        - Type: VPC_SUBNET
          URI: subnet:subnet-12345678
        - Type: VPC_SECURITY_GROUP
          URI: security_group:sg-12345678
```

### Fonte di eventi Kafka gestita autonomamente con Confluent Schema Registry
<a name="sam-property-function-selfmanagedkafka-example-schemaregistry-confluent"></a>

Di seguito è riportato un esempio di un tipo di sorgente di `SelfManagedKafka` eventi configurato con Confluent Schema Registry.

```
Events:
  SelfManagedKafkaEvent:
    Type: SelfManagedKafka
    Properties:
      KafkaBootstrapServers:
        - abc.xyz.com:9092
      Topics:
        - SchemaRegistryTestTopic
      StartingPosition: LATEST
      ProvisionedPollerConfig:
        MinimumPollers: 1
      SchemaRegistryConfig:
        SchemaRegistryURI: https://my-schema-registry.confluent.cloud
        AccessConfigs:
          - Type: BASIC_AUTH
            URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:my-secret
        EventRecordFormat: JSON
        SchemaValidationConfigs:
          - Attribute: KEY
          - Attribute: VALUE
      SourceAccessConfigurations:
        - Type: VPC_SUBNET
          URI: subnet:subnet-12345678
        - Type: VPC_SECURITY_GROUP
          URI: security_group:sg-12345678
        - Type: BASIC_AUTH
          URI: !Sub arn:${AWS::Partition}:secretsmanager:us-west-2:123456789012:secret:kafka-secret
```

# SNS
<a name="sam-property-function-sns"></a>

L'oggetto che descrive un tipo di origine `SNS` dell'evento.

SAM genera [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html)una risorsa quando viene impostato questo tipo di evento

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

```
  [FilterPolicy](#sam-function-sns-filterpolicy): [SnsFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)
  FilterPolicyScope: String
  RedrivePolicy: Json
  [Region](#sam-function-sns-region): String
  [SqsSubscription](#sam-function-sns-sqssubscription): Boolean | SqsSubscriptionObject
  [Topic](#sam-function-sns-topic): String
```

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

 `FilterPolicy`   <a name="sam-function-sns-filterpolicy"></a>
Il codice JSON della policy di filtro assegnato alla sottoscrizione. Per ulteriori informazioni, consulta [GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)Amazon Simple Notification Service API Reference.  
*Tipo:* [SnsFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)` proprietà di una `AWS::SNS::Subscription` risorsa.

 `FilterPolicyScope`   <a name="sam-function-sns-filterpolicyscope"></a>
Questo attributo consente di scegliere l'ambito di filtraggio utilizzando uno dei seguenti tipi di valori di stringa:  
+ `MessageAttributes`— Il filtro viene applicato agli attributi del messaggio.
+ `MessageBody`— Il filtro viene applicato al corpo del messaggio.
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Default*: `MessageAttributes`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla ` [ FilterPolicyScope](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicyscope)` proprietà di una `AWS::SNS::Subscription` risorsa.

 `RedrivePolicy`   <a name="sam-function-sns-redrivepolicy"></a>
Quando è specificato, invia i messaggi non recapitabili alla coda DLQ di Amazon SQS specificata. I messaggi che non possono essere recapitati a causa di errori client (ad esempio, quando l'endpoint sottoscritto non è raggiungibile) o errori del server (ad esempio, quando il servizio che alimenta l'endpoint sottoscritto diventa non disponibile) vengono mantenuti nella coda DLQ per ulteriori analisi o elaborazione.  
*Per ulteriori informazioni sulla politica di redrive e sulle code di lettera morta di Amazon SQS, consulta la pagina Amazon SQS Dead-letter [queues nella Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) Developer Guide.*  
*Type*: Json  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[ RedrivePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-redrivepolicy)` `AWS::SNS::Subscription`

 `Region`   <a name="sam-function-sns-region"></a>
Per le sottoscrizioni in più Regioni, la Regione in cui si trova l'argomento.  
Se non viene specificata alcuna regione, CloudFormation utilizza la regione del chiamante come impostazione predefinita.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-region)` proprietà di una `AWS::SNS::Subscription` risorsa.

 `SqsSubscription`   <a name="sam-function-sns-sqssubscription"></a>
Imposta questa proprietà su true o specifica di `SqsSubscriptionObject` abilitare l'invio in batch delle notifiche degli argomenti SNS in una coda SQS. L'impostazione di questa proprietà per `true` creare una nuova coda SQS, mentre se si specifica a si utilizza una coda SQS esistente. `SqsSubscriptionObject`  
*Tipo: Boolean \$1 [SqsSubscriptionObject](sam-property-function-sqssubscriptionobject.md)*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Topic`   <a name="sam-function-sns-topic"></a>
L'ARN dell'argomento a cui effettuare la sottoscrizione  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[TopicArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#topicarn)` proprietà di una `AWS::SNS::Subscription` risorsa.

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

### Esempio di origine degli eventi SNS
<a name="sam-property-function-sns--examples--sns-event-source-example"></a>

Esempio di origine di eventi SNS

#### YAML
<a name="sam-property-function-sns--examples--sns-event-source-example--yaml"></a>

```
Events:
  SNSEvent:
    Type: SNS
    Properties:
      Topic: arn:aws:sns:us-east-1:123456789012:my_topic
      SqsSubscription: true
      FilterPolicy:
        store:
          - example_corp
        price_usd:
          - numeric:
              - ">="
              - 100
```

# SqsSubscriptionObject
<a name="sam-property-function-sqssubscriptionobject"></a>

Specificate un'opzione di coda SQS esistente per l'evento SNS

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

```
  [BatchSize](#sam-function-sqssubscriptionobject-batchsize): String
  [Enabled](#sam-function-sqssubscriptionobject-enabled): Boolean
  [QueueArn](#sam-function-sqssubscriptionobject-queuearn): String
  [QueuePolicyLogicalId](#sam-function-sqssubscriptionobject-queuepolicylogicalid): String
  [QueueUrl](#sam-function-sqssubscriptionobject-queueurl): String
```

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

 `BatchSize`   <a name="sam-function-sqssubscriptionobject-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch per la coda SQS.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Impostazione predefinita*: 10  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Enabled`   <a name="sam-function-sqssubscriptionobject-enabled"></a>
Disattiva la mappatura delle sorgenti degli eventi SQS per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Impostazione* predefinita: True  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `QueueArn`   <a name="sam-function-sqssubscriptionobject-queuearn"></a>
Specificare un arn di coda SQS esistente.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `QueuePolicyLogicalId`   <a name="sam-function-sqssubscriptionobject-queuepolicylogicalid"></a>
Assegna un nome LogicalID personalizzato per la [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)risorsa.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `QueueUrl`   <a name="sam-function-sqssubscriptionobject-queueurl"></a>
Specificare l'URL della coda associato alla `QueueArn` proprietà.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Evento SQS for SNS esistente
<a name="sam-property-function-sqssubscriptionobject--examples--existing-sqs-for-sns-event"></a>

Esempio di aggiunta di una coda SQS esistente per l'iscrizione a un argomento SNS.

#### YAML
<a name="sam-property-function-sqssubscriptionobject--examples--existing-sqs-for-sns-event--yaml"></a>

```
QueuePolicyLogicalId: CustomQueuePolicyLogicalId
QueueArn:
  Fn::GetAtt: MyCustomQueue.Arn
QueueUrl:
  Ref: MyCustomQueue
BatchSize: 5
```

# SQS
<a name="sam-property-function-sqs"></a>

L'oggetto che descrive un tipo di origine `SQS` dell'evento. Per ulteriori informazioni, consulta [Using AWS Lambda with Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html) nella *AWS Lambda Developer* Guide.

SAM genera [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html)risorse quando viene impostato questo tipo di evento

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

```
  [BatchSize](#sam-function-sqs-batchsize): Integer
  [Enabled](#sam-function-sqs-enabled): Boolean
  [FilterCriteria](#sam-function-sqs-filtercriteria): [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)
  [FunctionResponseTypes](#sam-function-sqs-functionresponsetypes): List
  KmsKeyArn: String
  [MaximumBatchingWindowInSeconds](#sam-function-sqs-maximumbatchingwindowinseconds): Integer
  [MetricsConfig](#sam-function-sqs-metricsconfig): [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)
  [ProvisionedPollerConfig](#sam-function-sqs-provisionedpollerconfig): [ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)
  [Queue](#sam-function-sqs-queue): String
  ScalingConfig: [ScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-scalingconfig.html)
```

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

 `BatchSize`   <a name="sam-function-sqs-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch.  
*Tipo*: integer  
*Obbligatorio:* no  
*Impostazione predefinita*: 10  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.  
*Minimum*: `1`  
*Maximum*: `10000`

 `Enabled`   <a name="sam-function-sqs-enabled"></a>
Disabilita la mappatura dell'origine eventi per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Enabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FilterCriteria`   <a name="sam-function-sqs-filtercriteria"></a>
Un oggetto che definisce i criteri per determinare se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il [filtro AWS Lambda degli eventi nella Guida per](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) gli *AWS Lambda sviluppatori*.  
*Tipo:* [FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterCriteria](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `FunctionResponseTypes`   <a name="sam-function-sqs-functionresponsetypes"></a>
 Un elenco dei tipi di risposta attualmente applicati alla mappatura delle sorgenti degli eventi. Per ulteriori informazioni, consulta [Segnalazione degli errori relativi agli elementi in batch](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-batchfailurereporting) nella Guida per gli *AWS Lambda sviluppatori*.   
 *Valori validi*: `ReportBatchItemFailures`   
 Tipo: elenco   
 *Obbligatorio:* no   
 *CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FunctionResponseTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionresponsetypes)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa. 

 `KmsKeyArn`   <a name="sam-function-sqs-kmskeyarn"></a>
L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MaximumBatchingWindowInSeconds`   <a name="sam-function-sqs-maximumbatchingwindowinseconds"></a>
Il tempo massimo, in secondi, per raccogliere i record prima di richiamare la funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `MetricsConfig`   <a name="sam-function-sqs-metricsconfig"></a>
Una configurazione opzionale per ottenere metriche avanzate per le mappature delle sorgenti degli eventi che catturano ogni fase dell'elaborazione. Per vedere un esempio, consulta [MetricsConfig evento](sam-property-function-dynamodb.md#sam-property-function-dynamodb-example-metricsconfigevent).  
*Tipo:* [MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MetricsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig)` proprietà di una risorsa. `AWS::Lambda::EventSourceMapping`

 `ProvisionedPollerConfig`   <a name="sam-function-sqs-provisionedpollerconfig"></a>
Configurazione per aumentare la quantità di poller utilizzati per calcolare le mappature delle sorgenti degli eventi. Questa configurazione consente un minimo di 2 poller e un massimo di 2000 poller. Per un esempio, fare riferimento a. [ProvisionedPollerConfig esempio](#sam-property-function-sqs-example-provisionedpollerconfig)  
*Tipo:* [ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ProvisionedPollerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `Queue`   <a name="sam-function-sqs-queue"></a>
L'ARN della coda.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EventSourceArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn)` proprietà di una `AWS::Lambda::EventSourceMapping` risorsa.

 `ScalingConfig`   <a name="sam-function-sqs-scalingconfig"></a>
Configurazione scalabile dei poller SQS per controllare la frequenza di richiamo e impostare il numero massimo di richiami simultanei.  
*Tipo:* `[ScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-scalingconfig.html)`  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[ ScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-scalingconfig.html)` `AWS::Lambda::EventSourceMapping`

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

### MetricsConfig evento
<a name="sam-property-function-sqs-example-metricsconfigevent"></a>

Di seguito è riportato un esempio di risorsa che utilizza la `MetricsConfig` proprietà per acquisire ogni fase dell'elaborazione per le mappature delle sorgenti degli eventi.

```
Resources:
  FilteredEventsFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: s3://sam-demo-bucket/metricsConfig.zip
      Handler: index.handler
      Runtime: nodejs16.x
      Events:
        KinesisStream:
          Type: Kinesis
          Properties:
            Stream: !GetAtt KinesisStream.Arn
            StartingPosition: LATEST
            MetricsConfig:
              Metrics:
              - EventCount
```

### Evento SQS di base
<a name="sam-property-function-sqs--examples--sqs-event"></a>

```
Events:
  SQSEvent:
    Type: SQS
    Properties:
      Queue: arn:aws:sqs:us-west-2:012345678901:my-queue
      BatchSize: 10
      Enabled: false
      FilterCriteria:
        Filters:
          - Pattern: '{"key": ["val1", "val2"]}'
```

### Configura il reporting parziale in batch per la tua coda SQS
<a name="sam-property-function-sqs--examples--sqs-partial-batch"></a>

```
Events:
  SQSEvent:
    Type: SQS
    Properties:
      Enabled: true
      FunctionResponseTypes:
        - ReportBatchItemFailures
      Queue: !GetAtt MySqsQueue.Arn
      BatchSize: 10
```

### Funzione Lambda con un evento SQS con scalabilità configurata
<a name="sam-property-function-sqs--examples--sqs-event-scaling"></a>

```
MyFunction:
  Type: AWS::Serverless::Function
  Properties:
    ...
    Events:
      MySQSEvent:
        Type: SQS
        Properties:
          ...
          ScalingConfig:
            MaximumConcurrency: 10
```

### ProvisionedPollerConfig esempio
<a name="sam-property-function-sqs-example-provisionedpollerconfig"></a>

```
MyFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs18.x
    Timeout: 30
    Events:
      SQSEvent:
        Type: SQS
        Properties:
          Queue: !GetAtt MyQueue.Arn
          BatchSize: 10
          Enabled: True
          ProvisionedPollerConfig:
            MaximumPollers: 300
            MinimumPollers: 10
```

# FunctionCode
<a name="sam-property-function-functioncode"></a>

Il [pacchetto di distribuzione](https://docs.aws.amazon.com/lambda/latest/dg/deployment-package-v2.html) per una funzione Lambda.

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

```
  [Bucket](#sam-function-functioncode-bucket): String
  [Key](#sam-function-functioncode-key): String
  [Version](#sam-function-functioncode-version): String
```

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

 `Bucket`   <a name="sam-function-functioncode-bucket"></a>
Un bucket Amazon S3 nella stessa AWS regione della tua funzione.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[S3Bucket](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-code.html#cfn-lambda-function-code-s3bucket)` proprietà del tipo di `AWS::Lambda::Function` `Code` dati.

 `Key`   <a name="sam-function-functioncode-key"></a>
La chiave Amazon S3 del pacchetto di implementazione.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[S3Key](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-code.html#cfn-lambda-function-code-s3key)` proprietà del tipo di `AWS::Lambda::Function` `Code` dati.

 `Version`   <a name="sam-function-functioncode-version"></a>
Per gli oggetti con versione, la versione dell'oggetto del pacchetto di implementazione da utilizzare.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[S3ObjectVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-function-code.html#cfn-lambda-function-code-s3objectversion)` proprietà del tipo di `AWS::Lambda::Function` `Code` dati.

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

### FunctionCode
<a name="sam-property-function-functioncode--examples--functioncode"></a>

`CodeUri`: Esempio di codice funzionale

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

```
CodeUri:
  Bucket: sam-s3-demo-bucket-name
  Key: mykey-name
  Version: 121212
```

# FunctionUrlConfig
<a name="sam-property-function-functionurlconfig"></a>

Crea un URL di AWS Lambda funzione con i parametri di configurazione specificati. L'URL di una funzione Lambda è un endpoint HTTPS che puoi usare per richiamare la tua funzione.

Per impostazione predefinita, l'URL della funzione che crei utilizza la `$LATEST` versione della tua funzione Lambda. Se si specifica un `AutoPublishAlias` per la funzione Lambda, l'endpoint si connette all'alias della funzione specificato.

Per ulteriori informazioni, consulta la [funzione Lambda URLs](https://docs.aws.amazon.com/lambda/latest/dg/lambda-urls.html) nella *AWS Lambda Developer* Guide.

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

```
[AuthType](#sam-function-functionurlconfig-authtype): String
[Cors](#sam-function-functionurlconfig-cors): [Cors](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-url-cors.html)
[InvokeMode](#sam-function-functionurlconfig-invokemode): String
```

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

 `AuthType`   <a name="sam-function-functionurlconfig-authtype"></a>
Il tipo di autorizzazione per l'URL della funzione. Per utilizzare AWS Identity and Access Management (IAM) per autorizzare le richieste, imposta su. `AWS_IAM` Per l'accesso aperto, imposta su. `NONE`  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[AuthType](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-url.html#cfn-lambda-url-authtype)` proprietà di una `AWS::Lambda::Url` risorsa.

 `Cors`   <a name="sam-function-functionurlconfig-cors"></a>
Le impostazioni CORS (cross-origin resource sharing) per l'URL della funzione.  
*Type*: [Cors](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-url-cors.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Cors](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-url-cors.html)` proprietà di una `AWS::Lambda::Url` risorsa.

 `InvokeMode`  <a name="sam-function-functionurlconfig-invokemode"></a>
La modalità in cui verrà richiamato l'URL della funzione. Per fare in modo che la funzione restituisca la risposta al termine dell'invocazione, imposta su. `BUFFERED` Per fare in modo che la funzione trasmetta in streaming la risposta, imposta su. `RESPONSE_STREAM` Il valore predefinito è `BUFFERED`.  
*Valori validi*: `BUFFERED` o `RESPONSE_STREAM`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*AWS CloudFormation compatibilità*: questa proprietà viene passata direttamente alla [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-url.html#cfn-lambda-url-invokemode](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-url.html#cfn-lambda-url-invokemode)proprietà di una `AWS::Lambda::Url` risorsa.

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

### URL della funzione
<a name="sam-property-function-functionurlconfig--examples--function-url"></a>

L'esempio seguente crea una funzione Lambda con un URL di funzione. L'URL della funzione utilizza l'autorizzazione IAM.

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

```
HelloWorldFunction:
  Type: AWS::Serverless::Function
  Properties:
    CodeUri: hello_world/
    Handler: index.handler
    Runtime: nodejs20.x
    FunctionUrlConfig:
      AuthType: AWS_IAM
      InvokeMode: RESPONSE_STREAM

Outputs:
  MyFunctionUrlEndpoint:
      Description: "My Lambda Function URL Endpoint"
      Value:
        Fn::GetAtt: HelloWorldFunctionUrl.FunctionUrl
```

# CapacityProviderConfig
<a name="sam-property-function-capacityproviderconfig"></a>

Configura il provider di capacità a cui verranno allegate le versioni pubblicate della funzione. Ciò consente l'esecuzione della funzione su EC2 istanze di proprietà del cliente gestite da Lambda.

**Nota**  
Questa configurazione determina il tipo di calcolo di una funzione e deve essere specificata durante la prima implementazione della funzione. Non può essere aggiunta o rimossa dopo la creazione della risorsa funzionale.

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

```
[Arn](#sam-function-capacityproviderconfig-arn): String
[ExecutionEnvironmentMemoryGiBPerVCpu](#sam-function-capacityproviderconfig-executionenvironmentmemorygibpervcpu): Float
[PerExecutionEnvironmentMaxConcurrency](#sam-function-capacityproviderconfig-perexecutionenvironmentmaxconcurrency): Integer
```

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

 `Arn`   <a name="sam-function-capacityproviderconfig-arn"></a>
L'ARN del fornitore di capacità da utilizzare per questa funzione.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica per SAM.

 `ExecutionEnvironmentMemoryGiBPerVCpu`   <a name="sam-function-capacityproviderconfig-executionenvironmentmemorygibpervcpu"></a>
Il rapporto tra memoria (in GiB) e vCPU per ogni ambiente di esecuzione.  
Il rapporto di memoria per CPU non può superare la memoria totale della funzione di 2048 MB. I memory-to-CPU rapporti supportati sono 2 GB, 4 GB o 8 GB per CPU.
*Tipo: Float*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ExecutionEnvironmentMemoryGiBPerVCpu](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-lambdamanagedinstancescapacityproviderconfig)` proprietà di una `AWS::Lambda::Function` risorsa.

 `PerExecutionEnvironmentMaxConcurrency`   <a name="sam-function-capacityproviderconfig-perexecutionenvironmentmaxconcurrency"></a>
Il numero massimo di esecuzioni simultanee per ambiente di esecuzione (sandbox).  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[PerExecutionEnvironmentMaxConcurrency](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-lambdamanagedinstancescapacityproviderconfig)` proprietà di una risorsa. `AWS::Lambda::Function`

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

### configurazione del provider di capacità
<a name="sam-property-function-capacityproviderconfig-examples-basic"></a>

L'esempio seguente mostra una configurazione di un provider di capacità che fa riferimento a una risorsa del provider di capacità.

```
CapacityProviderConfig:
  Arn: !GetAtt MyCapacityProvider.Arn
  ExecutionEnvironmentMemoryGiBPerVCpu: 4.0
  PerExecutionEnvironmentMaxConcurrency: 100
```

# FunctionScalingConfig
<a name="sam-property-function-functionscalingconfig"></a>

Configura il comportamento di scalabilità per le versioni della funzione Lambda, controllando il numero di ambienti di esecuzione (sandbox) che possono essere creati. Questa configurazione si applica sia alla versione \$1LATEST.PUBLISHED che alla versione della funzione numerica.

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

```
[MinExecutionEnvironments](#sam-function-functionscalingconfig-minexecutionenvironments): Integer
[MaxExecutionEnvironments](#sam-function-functionscalingconfig-maxexecutionenvironments): Integer
```

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

 `MinExecutionEnvironments`   <a name="sam-function-functionscalingconfig-minexecutionenvironments"></a>
Il numero minimo di ambienti di esecuzione da mantenere per la versione della funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*Default*: `3`  
*Minimum*: `0`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MinExecutionEnvironments](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-functionscalingconfig-minexecutionenvironments)` proprietà di una `AWS::Lambda::Function` risorsa.

 `MaxExecutionEnvironments`   <a name="sam-function-functionscalingconfig-maxexecutionenvironments"></a>
Il numero massimo di ambienti di esecuzione che possono essere creati per la versione della funzione.  
*Tipo*: integer  
*Obbligatorio:* no  
*Default*: `3`  
*Minimum*: `0`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaxExecutionEnvironments](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-functionscalingconfig-maxexecutionenvironments)` proprietà di una `AWS::Lambda::Function` risorsa.

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

### Configurazione del ridimensionamento delle funzioni
<a name="sam-property-function-functionscalingconfig-examples-basic"></a>

L'esempio seguente mostra una configurazione di ridimensionamento delle funzioni con ambienti di esecuzione minimi e massimi.

```
FunctionScalingConfig:
  MinExecutionEnvironments: 5
  MaxExecutionEnvironments: 100
```