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 Amazon S3 S3-Zugriffspunkten. Sie können Anfragen über Object Lambda Access Points stellen, indem Sie die Amazon S3 S3-Konsole AWS Command Line Interface (AWS CLI) oder die Amazon S3 S3-REST-API verwenden. AWS SDKs

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 ARN für Ihren Object Lambda Access Point

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-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 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 aus, dessen ARN Sie kopieren möchten.

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

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 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 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 111122223333 durch 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"
           },
           ...
       ]
   }

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 111122223333 durch 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-Bucket-Namens 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 mit Access Points.

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-Bucket-Namens 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 Benennungsregeln für Allzweck-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 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 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 REST-API finden Sie unter CreateAccessPointForObjectLambda und ObjectLambdaAccessPointAliasin der Amazon Simple Storage Service API-Referenz.

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 REST-API finden Sie unter CreateAccessPointForObjectLambda und ObjectLambdaAccessPointAliasin der Amazon Simple Storage Service API-Referenz.

So verwenden Sie den Alias des Object Lambda Access Point

Sie können einen Alias eines Object Lambda Access Point anstelle eines Amazon-S3-Bucket-Namens für die unter Kompatibilität mit Access Points 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 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 für den Alias des Access Points.