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

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

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 dei punti di accesso Amazon S3. Puoi effettuare richieste tramite i punti di accesso Object Lambda utilizzando la console Amazon S3 AWS Command Line Interface ,AWS CLI() AWS SDKs o l'API REST di Amazon S3.

Importante

Gli Amazon Resource Names (ARNs) per gli access point Object Lambda utilizzano un nome di servizio di. s3-object-lambda Pertanto, Object Lambda Access Point ARNs inizia conarn:aws::s3-object-lambda, invece diarn:aws::s3, che viene utilizzato con 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 SDKs, è necessario 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.

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

  1. Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Nel riquadro di navigazione sinistro, scegli Punti di accesso Lambda dell'oggetto.

  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 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 111122223333 con 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à con i 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 a AWS Management Console e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Nel riquadro di navigazione sinistro, scegli Punti di accesso Lambda dell'oggetto.

  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, 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 ObjectLambdaAccessPointAlias dati nell'API REST, vedere CreateAccessPointForObjectLambda e ObjectLambdaAccessPointAliasnel riferimento all'API di riferimento 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à con i punti di accesso.

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 degli alias dei punti di accesso.