Utilizzo dei punti di accesso Amazon S3 Object Lambda - Amazon Simple Storage Service
Come trovare l'ARN per un punto di accesso Lambda per oggettiCome utilizzare un alias in stile bucket per il punto di accesso Lambda per oggetti

Utilizzo dei punti di accesso Amazon S3 Object Lambda

Nota

A partire dal 7 novembre 2025, Lambda per oggetti S3 sarà disponibile solo per i clienti esistenti che attualmente utilizzano il servizio e per alcuni partner della Rete dei partner AWS (APN). Se desideri utilizzare il servizio, registrati prima del 7 novembre 2025. Per funzionalità simili a Lambda per oggetti S3, consulta Modifica della disponibilità di Lambda per oggetti Amazon S3.

Le richieste tramite gli punti di accesso Lambda per oggetti Amazon S3 si effettuano esattamente come le richieste tramite altri punti di accesso. Per ulteriori informazioni su come effettuare le richieste tramite un punto di accesso, consulta Utilizzo dei punti di accesso Amazon S3 per bucket per uso generico. È possibile effettuare richieste tramite i punti di accesso Lambda per oggetti utilizzando la console Amazon S3, la AWS Command Line Interface (AWS CLI), gli SDK AWS o la REST API di Amazon S3.

Importante

Il nome della risorsa Amazon (ARN) del punto di accesso Lambda per oggetti utilizza un nome di servizio di s3-object-lambda. Quindi, gli ARN degli punti di accesso Lambda per oggetti iniziano con arn:aws::s3-object-lambda, anziché arn:aws::s3, che viene utilizzato per altri punti di accesso.

Come trovare l'ARN per un punto di accesso Lambda per oggetti

Per utilizzare un punto di accesso Lambda per oggetti con la AWS CLI o gli SDK AWS, devi conoscere il nome della risorsa Amazon (ARN) del punto di accesso Lambda per oggetti. Gli esempi seguenti mostrano come trovare l'ARN di un punto di accesso Lambda per oggetti utilizzando la console Amazon S3 o la AWS CLI.

Per trovare l'ARN per un punto di accesso Lambda per oggetti

  1. Accedi alla Console di gestione AWS e apri la console Amazon S3 all’indirizzo https://console.aws.amazon.com/s3/.

  2. Nel pannello di navigazione a sinistra, scegli Object Lambda Access Points (Punti di accesso Object Lambda).

  3. Seleziona il pulsante di opzione accanto al punto di accesso Lambda per oggetti di cui vuoi copiare l'ARN.

  4. Scegli Copy ARN (Copia ARN).

Per trovare l'ARN per un punto di accesso per le espressioni Lambda dell'oggetto utilizzando la AWS CLI

  1. Per recuperare un elenco degli punti di accesso Lambda per oggetti associati al tuo Account AWS, esegui il comando riportato di seguito. Prima di eseguire il comando, sostituisci l'ID account 111122223333 con l'ID del tuo Account AWS.

    aws s3control list-access-points-for-object-lambda --account-id 111122223333

  2. Esamina l'output del comando per trovare l'ARN del punto di accesso Lambda per oggetti che desideri utilizzare. L'output del comando precedente dovrebbe essere simile all'esempio seguente.

    {
    "ObjectLambdaAccessPointList": [
        {
            "Name": "my-object-lambda-ap",
            "ObjectLambdaAccessPointArn": "arn:aws:s3-object-lambda:us-east-1:111122223333:accesspoint/my-object-lambda-ap"
        },
        ...
    ]
}

Come utilizzare un alias in stile bucket per il punto di accesso Lambda per oggetti del bucket S3

Quando crei un punto di accesso Lambda per oggetti, Amazon S3 genera automaticamente un alias univoco per il tuo punto di accesso Lambda per oggetti. Puoi utilizzare questo alias del punto di accesso al posto di un nome del bucket Amazon S3 o del nome della risorsa Amazon (ARN) del punto di accesso Lambda per oggetti in una richiesta per qualsiasi operazione del piano dati del punto di accesso. Per un elenco di queste operazioni, consulta Compatibilità dei punti di accesso.

Un nome alias del punto di accesso Lambda per oggetti viene creato nello stesso spazio dei nomi di un bucket Amazon S3. Questo nome alias viene generato automaticamente e non può essere modificato. Per un punto di accesso Lambda per oggetti esistente, l'alias viene assegnato automaticamente. Un nome alias del punto di accesso Lambda per oggetti soddisfa tutti i requisiti di un nome bucket Amazon S3 valido e comprende le seguenti parti:

Object Lambda Access Point name prefix-metadata--ol-s3

Nota

Il suffisso --ol-s3 è riservato ai nomi alias dei punti di accesso Lambda per oggetti e non può essere utilizzato per i nomi dei bucket o dei punti di accesso Lambda per oggetti. Per ulteriori informazioni sulle regole di denominazione dei bucket Amazon S3, consulta Regole di denominazione dei bucket per uso generico.

Negli esempi seguenti viene illustrato l'ARN e l'alias per un punto di accesso Lambda per oggetti denominato my-object-lambda-access-point.

  • ARN – arn:aws:s3-object-lambda:region:account-id:accesspoint/my-object-lambda-access-point

  • Alias del punto di accesso Lambda per oggetti – my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3

Quando si utilizza un punto di accesso Lambda per oggetti, è possibile utilizzare il nome alias del punto di accesso Lambda per oggetti senza la necessità di modifiche estese al codice.

Quando si elimina un punto di accesso Lambda per oggetti, il nome alias del punto di accesso Lambda per oggetti diventa inattivo e non viene allocato.

Come trovare l'alias per il punto di accesso Lambda per oggetti

Per trovare l'alias per il tuo punto di accesso Lambda per oggetti utilizzando la console

  1. Accedi alla Console di gestione AWS e apri la console Amazon S3 all’indirizzo https://console.aws.amazon.com/s3/.

  2. Nel pannello di navigazione a sinistra, scegli Object Lambda Access Points (Punti di accesso Object Lambda).

  3. Per il punto di accesso Lambda per oggetti che desideri utilizzare, copia il valore dell'alias del punto di accesso Lambda per oggetti.

Quando crei un punto di accesso Lambda per oggetti, Amazon S3 genera automaticamente un nome alias del punto di accesso Lambda per oggetti, come mostrato nell'esempio seguente. Per eseguire questo comando, sostituisci user input placeholders con le informazioni appropriate. Per informazioni su come creare un punto di accesso Lambda per oggetti utilizzando la AWS CLI, consulta Per creare un punto di accesso Lambda per oggetti utilizzando la AWS CLI.

aws s3control create-access-point-for-object-lambda --account-id 111122223333 --name my-object-lambda-access-point --configuration file://my-olap-configuration.json
{
    "ObjectLambdaAccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point",
    "Alias": {
        "Value": "my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3",
        "Status": "READY"
    }
}

Il nome alias del punto di accesso Lambda per oggetti generato ha due campi:

  • Il campo Value è il valore dell'alias del punto di accesso Lambda per oggetti.

  • Il campo Status è lo stato dell'alias del punto di accesso Lambda per oggetti. Se lo stato è PROVISIONING, Amazon S3 alloca l'alias del punto di accesso Lambda per oggetti, ma l'alias non è ancora pronto per l'uso. Se lo stato è READY, l'alias del punto di accesso Lambda per oggetti è stato allocato correttamente ed è pronto per l'uso.

Per ulteriori informazioni sul tipo di dati ObjectLambdaAccessPointAlias nella REST API, consulta CreateAccessPointForObjectLambda e ObjectLambdaAccessPointAlias nella Documentazione di riferimento delle API di Amazon Simple Storage Service.

Come utilizzare l'alias del punto di accesso Lambda per oggetti

Puoi utilizzare l'alias del punto di accesso Lambda per oggetti al posto di un nome bucket Amazon S3 per le operazioni elencate in Compatibilità dei punti di accesso.

L' esempio della AWS CLI seguente del comando get-bucket-location utilizza l'alias del punto di accesso del bucket per restituire la Regione AWS in cui si trova il bucket. Per eseguire questo comando, sostituisci user input placeholders con le informazioni appropriate.

aws s3api get-bucket-location --bucket my-object-lambda-acc-w7i37nq6xuzgax3jw3oqtifiusw2a--ol-s3
            
{
    "LocationConstraint": "us-west-2"
}

Se l'alias del punto di accesso Lambda per oggetti in una richiesta non è valido, viene restituito il codice di errore InvalidAccessPointAliasError. Per ulteriori informazioni su InvalidAccessPointAliasError consulta Elenco dei codici di errore nella Documentazione di riferimento delle API di Amazon Simple Storage Service.

Le limitazioni di un alias del punto di accesso Lambda per oggetti sono le stesse di un alias del punto di accesso. Per ulteriori informazioni sulle limitazioni di un alias del punto di accesso, consulta Limitazioni degli alias del punto di accesso.