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à.
# Creazione di punti di accesso Object Lambda
**Nota**
A partire dal 7 novembre 2025, S3 Object Lambda è disponibile solo per i clienti esistenti che attualmente utilizzano il servizio e per alcuni AWS partner Partner Network (APN). Per funzionalità simili a Lambda per oggetti S3, consulta [Modifica della disponibilità di Lambda per oggetti Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html).
Un punto di accesso Lambda per oggetti è associato esattamente a un punto di accesso standard, che si specifica durante la creazione. Per creare un punto di accesso Lambda per oggetti, sono necessarie le seguenti risorse:
+ **Un punto di accesso S3 standard.** Quando lavori con gli access point Object Lambda, questo punto di accesso standard è noto come punto di *accesso di supporto* ed è collegato a un bucket S3 o a un volume FSx Amazon for OpenZFS. Per informazioni sulla creazione di punti di accesso standard, consulta la sezione [Creazione di un access point](creating-access-points.md).
+ ** AWS Lambda Una funzione.** Puoi creare una funzione Lambda personalizzata oppure utilizzare una funzione predefinita. Per ulteriori informazioni sulla creazione delle funzioni Lambda, consulta [Scrittura di funzioni Lambda per i punti di accesso Lambda per oggetti S3](olap-writing-lambda.md). Per ulteriori informazioni sulle funzioni incorporate, consulta [Utilizzo delle AWS funzioni Lambda integrate](olap-examples.md).
+ **(Facoltativo) Una politica AWS Identity and Access Management (IAM).** I punti di accesso Amazon S3 supportano le policy delle risorse IAM che consentono di controllare l'utilizzo del punto di accesso per risorsa, utente o altre condizioni. Per ulteriori informazioni sulla creazione di queste policy, consulta [Configurazione delle policy IAM per i punti di accesso Lambda per oggetti](olap-policies.md).
Nelle sezioni seguenti viene descritto come creare un punto di accesso Lambda per oggetti utilizzando:
+ La Console di gestione AWS
+ Il AWS Command Line Interface (AWS CLI)
+ Un AWS CloudFormation modello
+ Il AWS Cloud Development Kit (AWS CDK)
Per ulteriori informazioni su come creare un punto di accesso Lambda per oggetti tramite REST API, consulta [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPointForObjectLambda.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPointForObjectLambda.html) nella *Documentazione di riferimento delle API di Amazon Simple Storage Service*.
## Creazione di un punto di accesso Lambda per oggetti
Utilizza una delle procedure riportate di seguito per creare il punto di accesso Lambda per oggetti.
### Utilizzo della console S3
**Per creare un punto di accesso Lambda per oggetti utilizzando la console**
1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nella barra di navigazione, scegli il nome del file attualmente visualizzato Regione AWS. Quindi, scegli la Regione a cui passare.
1. Nel riquadro di navigazione sinistro, scegli **Punti di accesso Lambda dell'oggetto**.
1. Nella pagina **Punti di accesso Lambda dell'oggetto**, scegli **Crea punto di accesso per le espressioni Lambda dell'oggetto**.
1. In **Object Lambda Access Point name** (Nome punto di accesso Object Lambda), specifica il nome da utilizzare per il punto di accesso.
Come per i punti di accesso standard, esistono regole per la denominazione dei punti di accesso Lambda per oggetti. Per ulteriori informazioni, consulta [Regole di denominazione dei punti di accesso](access-points-restrictions-limitations-naming-rules.md#access-points-names).
1. In **Supporting Access Point** (Punto di accesso di supporto), specifica o seleziona il punto di accesso standard da utilizzare. Il punto di accesso deve trovarsi nella Regione AWS stessa posizione degli oggetti che desiderate trasformare. Per informazioni sulla creazione di punti di accesso standard, consulta la sezione [Creazione di un access point](creating-access-points.md).
1. In **Configurazione della trasformazione** puoi aggiungere una funzione che trasforma i dati per il punto di accesso Lambda per oggetti. Esegui una delle seguenti operazioni:
+ Se hai già una AWS Lambda funzione nel tuo account, puoi sceglierla nella funzione **Invoke Lambda**. Qui puoi inserire l'Amazon Resource Name (ARN) di una funzione Lambda nel tuo o Account AWS scegliere una funzione Lambda dal menu a discesa.
+ Se desideri utilizzare una funzione AWS incorporata, scegli il nome della funzione in **funzione AWS integrata** e seleziona **Crea funzione Lambda**. Verrai indirizzato alla console Lambda dove potrai implementare una funzione integrata nel tuo. Account AWS Per ulteriori informazioni sulle funzioni integrate, consulta [Utilizzo delle AWS funzioni Lambda integrate](olap-examples.md).
In **S3 APIs**, scegli una o più operazioni API da richiamare. Per ogni API selezionata, devi specificare una funzione Lambda da richiamare.
1. (Facoltativo) In **Payload**, aggiungi il testo JSON da fornire come input alla funzione Lambda. Puoi configurare payload con parametri diversi per diversi punti di accesso Lambda per oggetti che invocano la stessa funzione Lambda, estendendo così la flessibilità della funzione stessa.
**Importante**
Quando utilizzi i punti di accesso Lambda per oggetti, assicurati che il payload non contenga informazioni riservate.
1. (Facoltativo) In **Range and part number** (Intervallo e numero parte), devi abilitare l'opzione se vuoi elaborare le richieste `GET` e `HEAD` con intestazioni di intervallo e numero di parte. Selezionando questa opzione confermi che la funzione Lambda è in grado di riconoscere ed elaborare queste richieste. Per ulteriori informazioni sulle intestazioni di intervalli e numeri di parte, consulta [Utilizzo delle intestazioni Range e partNumber](range-get-olap.md).
1. (Facoltativo) In **Parametri di richiesta** seleziona **Abilita** o **Disabilita** per aggiungere il monitoraggio Amazon S3 al punto di accesso Lambda per oggetti. Le metriche delle richieste vengono fatturate alla tariffa standard di Amazon CloudWatch.
1. (Facoltativo) In **Object Lambda Access Point policy** (Policy punto di accesso Object Lambda), imposta una policy delle risorse. Le policy delle risorse concedono le autorizzazioni per il punto di accesso Lambda per oggetti specificato e possono controllare l'utilizzo del punto di accesso per risorsa, utente o altre condizioni. Per ulteriori informazioni sulle policy delle risorse per i punti di accesso Object Lambda, consulta [Configurazione delle policy IAM per i punti di accesso Lambda per oggetti](olap-policies.md).
1. In **Block Public Access settings for this Object Lambda Access Point** (Impostazioni blocco accesso pubblico per questo punto di accesso Object Lambda), seleziona le impostazioni di Blocco dell'accesso pubblico Amazon S3 da applicare al punto di accesso. Tutte le impostazioni di blocco dell'accesso pubblico sono abilitate per impostazione predefinita per i nuovi punti di accesso Object Lambda. È consigliabile non modificare questa impostazione predefinita. Amazon S3 attualmente non supporta la modifica delle impostazioni di blocco dell'accesso pubblico dei punti di accesso dopo la creazione del punto di accesso Object Lambda.
Per ulteriori informazioni sull'utilizzo del blocco dell'accesso pubblico in Amazon S3, consulta [Gestione dell’accesso pubblico ai punti di accesso per bucket per uso generico](access-points-bpa-settings.md).
1. Seleziona **Create Object Lambda Access Point** (Crea punto di accesso Object Lambda).
### Utilizzando il AWS CLI
**Per creare un punto di accesso Object Lambda utilizzando un modello AWS CloudFormation**
**Nota**
Per utilizzare i seguenti comandi, sostituisci `{{user input placeholders}}` con le tue specifiche informazioni.
1. Scarica il pacchetto di distribuzione delle AWS Lambda funzioni `s3objectlambda_deployment_package.zip` nella configurazione predefinita di [S3 Object Lambda](https://github.com/aws-samples/amazon-s3-object-lambda-default-configuration).
1. Esegui il seguente comando `put-object` per caricare il pacchetto in un bucket Amazon S3.
```
aws s3api put-object --bucket {{Amazon S3 bucket name}} --key s3objectlambda_deployment_package.zip --body release/s3objectlambda_deployment_package.zip
```
1. Scarica il AWS CloudFormation modello nella configurazione `s3objectlambda_defaultconfig.yaml` predefinita di [S3 Object Lambda](https://github.com/aws-samples/amazon-s3-object-lambda-default-configuration).
1. Esegui il seguente comando `deploy` per implementare il modello nell' Account AWS in uso.
```
aws cloudformation deploy --template-file s3objectlambda_defaultconfig.yaml \
--stack-name {{CloudFormation stack name}} \
--parameter-overrides ObjectLambdaAccessPointName={{Object Lambda Access Point name}} \
SupportingAccessPointName={{Amazon S3 access point}} S3BucketName={{Amazon S3 bucket}} \
LambdaFunctionS3BucketName={{Amazon S3 bucket containing your Lambda package}} \
LambdaFunctionS3Key={{Lambda object key}} LambdaFunctionS3ObjectVersion={{Lambda object version}} \
LambdaFunctionRuntime={{Lambda function runtime}} --capabilities {{capability_IAM}}
```
Puoi configurare questo AWS CloudFormation modello per richiamare operazioni Lambda `GET` `LIST` e API. `HEAD` Per ulteriori informazioni sulla modifica della configurazione predefinita del modello, consulta [Automatizza la configurazione di S3 Object Lambda con un modello CloudFormation](olap-using-cfn-template.md).
**Per creare un Object Lambda Access Point utilizzando AWS CLI**
**Nota**
Per utilizzare i seguenti comandi, sostituisci `{{user input placeholders}}` con le tue specifiche informazioni.
Nell'esempio seguente viene creato un punto di accesso Lambda per oggetti denominato {{`my-object-lambda-ap`}} per il bucket {{`amzn-s3-demo-bucket1`}} nell'account {{`111122223333`}}. L'esempio presuppone che sia già stato creato un punto di accesso standard denominato {{`example-ap`}}. Per informazioni sulla creazione di un punto di accesso standard, consulta la sezione [Creazione di un access point](creating-access-points.md).
Questo esempio utilizza la funzione AWS predefinita. `decompress` Per ulteriori informazioni sulle funzioni incorporate, consulta [Utilizzo delle AWS funzioni Lambda integrate](olap-examples.md).
1. Creare un bucket. In questo esempio verrà utilizzato {{`amzn-s3-demo-bucket1`}}. Per ulteriori informazioni sulla creazione dei bucket, consulta la sezione [Creazione di un bucket per uso generico](create-bucket-overview.md).
1. Creare un punto di accesso standard e collegarlo al bucket. In questo esempio verrà utilizzato {{`example-ap`}}. Per informazioni sulla creazione di punti di accesso standard, consulta la sezione [Creazione di un access point](creating-access-points.md).
1. Esegui una delle seguenti operazioni:
+ Crea una funzione Lambda nel tuo account da utilizzare per trasformare l'oggetto Amazon S3. Per ulteriori informazioni sulla creazione delle funzioni Lambda, consulta [Scrittura di funzioni Lambda per i punti di accesso Lambda per oggetti S3](olap-writing-lambda.md). Per utilizzare la funzione personalizzata con AWS CLI, consulta [Using Lambda with the AWS CLI](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-awscli.html) nella *AWS Lambda Developer* Guide.
+ Usa una funzione AWS Lambda predefinita. Per ulteriori informazioni sulle funzioni incorporate, consulta [Utilizzo delle AWS funzioni Lambda integrate](olap-examples.md).
1. Crea un file di configurazione JSON denominato `my-olap-configuration.json`. In questa configurazione, fornisci il punto di accesso di supporto e il nome della risorsa Amazon (ARN) per la funzione Lambda creata nei passaggi precedenti o l'ARN per la funzione predefinita che stai utilizzando.
**Example**
```
{
"SupportingAccessPoint" : "arn:aws:s3:{{us-east-1}}:{{111122223333}}:accesspoint/{{example-ap}}",
"TransformationConfigurations": [{
"Actions" : ["GetObject", "HeadObject", "ListObjects", "ListObjectsV2"],
"ContentTransformation" : {
"AwsLambda": {
"FunctionPayload" : "{\"compressionType\":\"gzip\"}",
"FunctionArn" : "arn:aws:lambda:{{us-east-1}}:{{111122223333}}:function/compress"
}
}
}]
}
```
1. Esegui il comando `create-access-point-for-object-lambda` per creare il punto di accesso Lambda per oggetti.
```
aws s3control create-access-point-for-object-lambda --account-id {{111122223333}} --name {{my-object-lambda-ap}} --configuration file://{{my-olap-configuration.json}}
```
1. (Facoltativo) Crea un file di policy JSON denominato `my-olap-policy.json`.
L'aggiunta di una policy delle risorse per il punto di accesso Object Lambda può controllare l'utilizzo del punto di accesso per risorsa, utente o altre condizioni. Questa policy delle risorse concede l'autorizzazione `GetObject` per l'account {{`444455556666`}} al punto di accesso Lambda per oggetti specificato.
**Example**
```
{
"Version": "2008-10-17",
"Statement": [
{
"Sid": "Grant account {{444455556666}} GetObject access",
"Effect": "Allow",
"Action": "s3-object-lambda:GetObject",
"Principal": {
"AWS": "arn:aws:iam::{{444455556666}}:root"
},
"Resource": "{{your-object-lambda-access-point-arn}}"
}
]
}
```
1. (Facoltativo) Esegui il comando `put-access-point-policy-for-object-lambda` per impostare la policy delle risorse.
```
aws s3control put-access-point-policy-for-object-lambda --account-id {{111122223333}} --name {{my-object-lambda-ap}} --policy file://{{my-olap-policy.json}}
```
1. (Facoltativo) Specifica un payload.
Un payload è un file JSON opzionale che puoi fornire alla tua AWS Lambda funzione come input. Puoi configurare payload con parametri diversi per diversi punti di accesso Lambda per oggetti che invocano la stessa funzione Lambda, estendendo così la flessibilità della funzione stessa.
La seguente configurazione del punto di accesso Lambda per oggetti mostra un payload con due parametri.
```
{
"SupportingAccessPoint": "{{AccessPointArn}}",
"CloudWatchMetricsEnabled": {{false}},
"TransformationConfigurations": [{
"Actions": ["GetObject", "HeadObject", "ListObjects", "ListObjectsV2"],
"ContentTransformation": {
"AwsLambda": {
"FunctionArn": "{{FunctionArn}}",
"FunctionPayload": "{\"res-x\": \"100\",\"res-y\": \"100\"}"
}
}
}]
}
```
La seguente configurazione del punto di accesso Lambda per oggetti mostra un payload con un parametro e con `GetObject-Range`, `GetObject-PartNumber`, `HeadObject-Range` e `HeadObject-PartNumber` abilitati.
```
{
"SupportingAccessPoint":"{{AccessPointArn}}",
"CloudWatchMetricsEnabled": {{false}},
"AllowedFeatures": ["GetObject-Range", "GetObject-PartNumber", "HeadObject-Range", "HeadObject-PartNumber"],
"TransformationConfigurations": [{
"Action": ["GetObject", "HeadObject", "ListObjects", "ListObjectsV2"],
"ContentTransformation": {
"AwsLambda": {
"FunctionArn":"{{FunctionArn}}",
"FunctionPayload": "{\"compression-amount\": \"5\"}"
}
}
}]
}
```
**Importante**
Quando utilizzi i punti di accesso Lambda per oggetti, assicurati che il payload non contenga informazioni riservate.
### Utilizzo della AWS CloudFormation console e del modello
È possibile creare un punto di accesso Lambda per oggetti utilizzando la configurazione predefinita fornita da Amazon S3. Puoi scaricare un AWS CloudFormation modello e il codice sorgente della funzione Lambda dal [GitHub repository](https://github.com/aws-samples/amazon-s3-object-lambda-default-configuration) e distribuire queste risorse per configurare un Object Lambda Access Point funzionale.
Per informazioni sulla modifica della configurazione predefinita del AWS CloudFormation modello, consulta. [Automatizza la configurazione di S3 Object Lambda con un modello CloudFormation](olap-using-cfn-template.md)
Per informazioni sulla configurazione degli access point Object Lambda CloudFormation utilizzando senza il modello, [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3objectlambda-accesspoint.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3objectlambda-accesspoint.html)consultate la Guida per *AWS CloudFormation l'*utente.
**Per caricare il pacchetto di implementazione della funzione Lambda**
1. Scarica il pacchetto di distribuzione delle AWS Lambda funzioni `s3objectlambda_deployment_package.zip` nella configurazione predefinita di [S3 Object Lambda](https://github.com/aws-samples/amazon-s3-object-lambda-default-configuration).
1. Carica il pacchetto in un bucket Amazon S3
**Per creare un punto di accesso Object Lambda utilizzando la console AWS CloudFormation**
1. Scarica il AWS CloudFormation modello nella configurazione `s3objectlambda_defaultconfig.yaml` predefinita di [S3 Object Lambda](https://github.com/aws-samples/amazon-s3-object-lambda-default-configuration).
1. [Accedi alla console di AWS gestione e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com /cloudformation.](https://console.aws.amazon.com/cloudformation/)
1. Esegui una delle seguenti operazioni:
+ **Se non l'hai mai usato AWS CloudFormation prima, nella AWS CloudFormation home page, scegli Crea stack.**
+ Se l'hai AWS CloudFormation già usato, nel riquadro di navigazione a sinistra, scegli **Stacks**. Scegli **Create stack** (Crea stack), quindi **With new resources (standard)** Con nuove risorse (standard).
1. Per **Prerequisito - Prepara modello**, scegliere **Il modello è pronto**.
1. In **Specify template** (Specifica modello), scegli **Upload a template file** (Carica un file modello), quindi carica `s3objectlambda_defaultconfig.yaml`.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Specifica dettagli della pila**, immetti un nome per la pila.
1. Nella sezione **Parameters** (Parametri), specifica i seguenti parametri definiti nel modello dello stack:
1. Per **CreateNewSupportingAccessPoint**, esegui una delle seguenti operazioni:
+ Se disponi già di un punto di accesso di supporto per il bucket S3 in cui hai caricato il modello, scegli **false**.
+ Se intendi creare un nuovo punto di accesso per questo bucket, scegli **true**.
1. Infatti **EnableCloudWatchMonitoring**, scegli **true** o **false**, a seconda che tu voglia abilitare i parametri e gli allarmi delle CloudWatch richieste Amazon.
1. (Facoltativo) Per **LambdaFunctionPayload**, aggiungi il testo JSON che desideri fornire alla funzione Lambda come input. Puoi configurare payload con parametri diversi per diversi punti di accesso Lambda per oggetti che invocano la stessa funzione Lambda, estendendo così la flessibilità della funzione stessa.
**Importante**
Quando utilizzi i punti di accesso Lambda per oggetti, assicurati che il payload non contenga informazioni riservate.
1. Per **LambdaFunctionRuntime**, inserisci il tuo runtime preferito per la funzione Lambda. Le scelte disponibili sono `nodejs14.x`, `python3.9`, `java11`.
1. Per **LambdaFunctionS3 BucketName**, inserisci il nome del bucket Amazon S3 in cui hai caricato il pacchetto di distribuzione.
1. Per **LambdaFunctionS3Key, inserisci la chiave** oggetto Amazon S3 in cui hai caricato il pacchetto di distribuzione.
1. Per **LambdaFunctionS3 ObjectVersion**, inserisci la versione dell'oggetto Amazon S3 in cui hai caricato il pacchetto di distribuzione.
1. Per **ObjectLambdaAccessPointName**, inserisci un nome per il tuo Object Lambda Access Point.
1. Per **S3 BucketName**, inserisci il nome del bucket Amazon S3 che verrà associato al tuo access point Object Lambda.
1. Per **SupportingAccessPointName**, inserisci il nome del tuo access point di supporto.
**Nota**
Questo è un punto di accesso associato al bucket Amazon S3 scelto nel passaggio precedente. **Se non disponi di punti di accesso associati al tuo bucket Amazon S3, puoi configurare il modello in modo che ne crei uno per te scegliendo true for. **CreateNewSupportingAccessPoint****
1. Scegli **Next (Successivo)**.
1. Nella pagina **Configure stack options (Configura opzioni pila)**, scegliere **Next (Successivo)**.
Per ulteriori informazioni sulle impostazioni facoltative in questa pagina, consulta la sezione [Impostazione delle opzioni dello stack AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-add-tags.html) nella *Guida per l'utente di AWS CloudFormation *.
1. Nella pagina **Revisione**, scegliere **Crea pila**.
### Utilizzando il AWS Cloud Development Kit (AWS CDK)
*Per ulteriori informazioni sulla configurazione degli access point Object Lambda utilizzando AWS CDK, [`AWS::S3ObjectLambda`vedete Construct](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3objectlambda-readme.html) Library nell'AWS Cloud Development Kit (AWS CDK) API Reference.*