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 S3-Konsole, AWS Command Line Interface (AWS CLI), AWS SDKs oder die Amazon S3 S3-REST-API verwenden.

Wichtig

Die Amazon-Ressourcennamen (ARNs) für Object Lambda Access Points verwenden den Servicenamen s3-object-lambda. Folglich beginnen die ARNs von Object Lambda Access Points mit arn:aws::s3-object-lambda und nicht mit arn:aws::s3, was andere Zugriffspunkte verwenden.

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

Um einen Object Lambda Access Point mit den AWS CLI oder AWS SDKs zu verwenden, 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-Konsole oder der AWS CLI finden.

Verwenden der S3-Konsole

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

1. Melden Sie sich bei der Amazon S3 S3-Konsole an AWS Management Console und öffnen Sie sie 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 aus, dessen ARN Sie kopieren möchten.

4. Klicken Sie auf Copy ARN (ARN kopieren).

Verwenden Sie den AWS CLI

Um den ARN für Ihren Object Lambda Access Point 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 111122223333durch Ihre AWS-Konto ID.

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

2. Überprüfen Sie die Befehlsausgabe, um den ARN des Object Lambda Access Point zu finden, 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-Bucketnamens oder des Amazon-Ressourcennamens (ARN) des Object Lambda Access Point in einer Anforderung für Zugriffspunkt-Operationen auf Datenebene 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 Regeln für die Benennung von Buckets.

Das folgende Beispiel zeigt den ARN und den Alias für einen Object Lambda Access Point namens 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 Amazon S3 S3-Konsole an AWS Management Console und öffnen Sie sie 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 Datentyp ObjectLambdaAccessPointAlias in der REST-API finden Sie unter CreateAccessPointForObjectLambda und ObjectLambdaAccessPointAlias in der API-Referenz zu Amazon Simple Storage Service.

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 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 unter Liste der Fehlercodes in der API-Referenz zu Amazon Simple Storage Service.

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.