Verwenden von Amazon S3 Objekt-Lambda-Zugriffspunkten

Sie können Anforderungen über Amazon S3 Object Lambda Access Points ebenso vornehmen wie über andere Zugriffspunkte. Weitere Informationen darüber, wie Sie Anforderungen über einen Zugriffspunkt vornehmen können, finden Sie unter Verwenden von Zugriffspunkten. Sie können Anfragen über Object Lambda Access Points stellen, indem Sie die Amazon S3-Konsole, AWS Command Line Interface (AWS CLI) AWS SDKs, oder Amazon S3 REST API verwenden.

Wichtig

Die Amazon-Ressourcennamen (ARNs) für Object Lambda Access Points verwenden den Dienstnamen. s3-object-lambda Somit ARNs beginnt Object Lambda Access Point mit demarn:aws::s3-object-lambda, was mit anderen Access Points verwendet wirdarn:aws::s3, und nicht mit dem, was mit anderen Access Points verwendet wird.

So finden Sie den Lambda Access Point ARN für Ihr Objekt

Um einen Object Lambda Access Point mit dem AWS CLI oder zu verwenden AWS SDKs, müssen Sie den Amazon-Ressourcennamen (ARN) des Object Lambda Access Points kennen. Die folgenden Beispiele zeigen, wie Sie den ARN für einen Object Lambda Access Point mithilfe der Amazon S3 S3-Konsole oder AWS CLI finden.

Verwenden der S3-Konsole

So finden Sie den Lambda Access Point ARN für Ihren Object mithilfe der Konsole

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

2. Wählen Sie im linken Navigationsbereich Objekt-Lambda-Zugriffspunkte aus.

3. Wählen Sie das Optionsfeld neben dem Object Lambda Access Point, dessen ARN Sie kopieren möchten.

4. Wählen Sie die Option CopyARN Kopieren aus.

Verwenden Sie den AWS CLI

Um den Lambda Access Point ARN für Ihren Object zu finden, verwenden Sie den AWS CLI

1. Führen Sie den folgenden Befehl aus, um eine Liste der Object Lambda Access Points abzurufen, die mit Ihrem AWS-Konto verbunden sind. Bevor Sie den Befehl ausführen, ersetzen Sie die Konto-ID 111122223333 mit Ihrer AWS-Konto ID.

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

2. Überprüfen Sie die Befehlsausgabe, um den Object Lambda Access Point zu findenARN, den Sie verwenden möchten. Die Ausgabe des vorherigen Befehls sollte dem folgenden Beispiel gleichen.

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

So verwenden Sie einen Alias im Bucket-Stil für den Object Lambda Access Point Ihres S3-Buckets

Wenn Sie einen Object Lambda Access Point erstellen, generiert Amazon S3 automatisch einen eindeutigen Alias für den Object Lambda Access Point. Sie können diesen Alias anstelle eines Amazon S3 S3-Bucket-Namens oder des Object Lambda Access Point Amazon Resource Name (ARN) in einer Anfrage für Access Point-Datenebenenoperationen verwenden. Eine Liste dieser Vorgänge finden Sie unter Kompatibilität des Access Points mit Diensten AWS.

Ein Aliasname eines Object Lambda Access Point wird innerhalb desselben Namespace wie ein Amazon-S3-Bucket erstellt. Dieser Aliasname wird automatisch generiert und kann nicht geändert werden. Für einen vorhandenen Object Lambda Access Point wird automatisch ein Alias zur Verwendung zugewiesen. Ein Aliasname eines Object Lambda Access Point erfüllt alle Anforderungen eines gültigen Amazon-S3-Bucketnamens und besteht aus den folgenden Teilen:

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

Anmerkung

Das Suffix --ol-s3 ist für Aliasnamen von Object Lambda Access Points reserviert und kann nicht für die Bucket-Namen oder die Namen von Object Lambda Access Points verwendet werden. Weitere Informationen zu Amazon-S3-Bucket-Benennungsregeln finden Sie unter Allgemeine Benennungsregeln für Buckets.

Die folgenden Beispiele zeigen den ARN und den Object Lambda Access Point-Alias für einen Object Lambda Access Point mit dem Namen: my-object-lambda-access-point

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

• Alias des Object Lambda Access Point – my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3

Wenn Sie einen Object Lambda Access Point verwenden, können Sie den Aliasnamen des Object Lambda Access Point verwenden, ohne dass umfangreiche Codeänderungen erforderlich sind.

Wenn Sie einen Object Lambda Access Point löschen, wird der Aliasname des Object Lambda Access Point inaktiv und die Bereitstellung wird aufgehoben.

So finden Sie den Alias für Ihren Object Lambda Access Point

Verwenden der S3-Konsole

So finden Sie den Alias für Ihren Object Lambda Access Point mithilfe der Konsole

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

2. Wählen Sie im linken Navigationsbereich Objekt-Lambda-Zugriffspunkte aus.

3. Kopieren Sie den Wert unter Alias des Objekt-Lambda-Zugriffspunkts für den Object Lambda Access Point, den Sie verwenden möchten.

Verwenden Sie den AWS CLI

Wenn Sie einen Object Lambda Access Point erstellen, generiert Amazon S3 automatisch einen Aliasnamen für den Object Lambda Access Point wie im folgenden Beispielbefehl gezeigt. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen. Informationen zum Erstellen eines Object Lambda Access Points mithilfe von finden Sie AWS CLI unterSo erstellen Sie einen Object Lambda Access Point mit dem 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"
    }
}

Der generierte Aliasname des Object Lambda Access Point besteht aus zwei Feldern:

• Das Feld Value ist der Aliaswert des Object Lambda Access Point.

• Das Feld Status ist der Status des Alias des Object Lambda Access Point. Wenn der Status PROVISIONING lautet, stellt Amazon S3 den Alias des Object Lambda Access Point bereit und der Alias kann noch nicht verwendet werden. Wenn der Status READY lautet, wurde der Alias des Object Lambda Access Point erfolgreich bereitgestellt und kann verwendet werden.

Weitere Informationen zum ObjectLambdaAccessPointAlias Datentyp in der finden Sie REST API unter CreateAccessPointForObjectLambda und ObjectLambdaAccessPointAliasin der Amazon Simple Storage Service API Reference.

So verwenden Sie den Alias des Object Lambda Access Point

Sie können einen Alias eines Object Lambda Access Point anstelle eines Amazon-S3-Bucketnamens für die unter Kompatibilität des Access Points mit Diensten AWS aufgeführten Operationen verwenden.

Im folgenden AWS CLI Beispiel für den get-bucket-location Befehl wird der Access Point-Alias des Buckets verwendet, um den Wert zurückzugeben AWS-Region , in dem sich der Bucket befindet. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

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

Wenn der Alias des Object Lambda Access Point in einer Anforderung nicht gültig ist, wird der Fehlercode InvalidAccessPointAliasError zurückgegeben. Weitere Informationen zu InvalidAccessPointAliasError finden Sie in der Liste der Fehlercodes in der Amazon Simple Storage Service API Reference.

Die Einschränkungen eines Alias eines Object Lambda Access Point sind die gleichen wie bei einem Zugriffspunkt-Alias. Weitere Informationen zu den Einschränkungen eines Zugriffspunkt-Alias finden Sie unter Einschränkungen.