Utilizzo dei punti di accesso Amazon S3 Object Lambda

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 degli access point. Puoi effettuare richieste tramite i punti di accesso Object Lambda utilizzando la console Amazon S3 AWS Command Line Interface ,AWS CLI() AWS , gli SDK o l'API REST 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 Object Lambda con AWS CLI o AWS SDK, devi conoscere l'Amazon Resource Name (ARN) del punto di accesso Object Lambda. 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.

Utilizzo della console S3

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

1. Accedi AWS Management Console 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).

Usando il AWS CLI

Per trovare l'ARN per il tuo punto di accesso Object Lambda utilizzando il 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 dell'account 111122223333con il tuo Account AWS ID.

   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 con i AWS servizi.

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.

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

Utilizzo della console S3

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

1. Accedi AWS Management Console 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.

Usando il AWS CLI

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, sostituire user input placeholders con le proprie informazioni. Per informazioni su come creare un punto di accesso Object Lambda utilizzando il AWS CLI, vedere. Per creare un Object Lambda Access Point utilizzando 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 con i AWS servizi.

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

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.