Referenzierung von Zugangspunkten mit ARNs, Zugangspunkt-Aliasnamen oder URIs im Stil virtueller Hosts

Nachdem Sie einen Zugangspunkt erstellt haben, können Sie diese Endpunkte verwenden, um eine Reihe von Vorgängen auszuführen. Wenn Sie auf einen Zugangspunkt verweisen, können Sie die Amazon Resource Names (ARNs), den Zugangspunkt-Alias oder den URI im virtual-hosted-Stil verwenden.

Zugangspunkt-ARN

Zugriffspunkte haben Amazon-Ressourcennamen (ARN). Zugangspunkt-ARNs ähneln Bucket-ARNs, werden jedoch explizit eingegeben und kodieren die AWS-Region des Zugangspunkts und die AWS-Konto-ID des Eigentümers des Zugangspunkts. Weitere Informationen zu ARNs finden Sie unter Identifizieren von AWS-Ressourcen mit Amazon-Ressourcenname (ARN) im IAM-Benutzerhandbuch.

ARNs von Zugangspunkte mit mehreren Regionen verwenden das folgende Format:

arn:aws:s3:region:account-id:accesspoint/resource

ARNs für Objekte, auf die über einen Zugangspunkt zugegriffen wird, haben das Format:

arn:aws:s3:region:account-id:accesspoint/access-point-name/object/resource

Zugriffspunkt-Aliasse

Wenn Sie einen Zugriffspunkt erstellen, generiert Amazon S3 automatisch einen Alias, den Sie anstelle eines Amazon S3-Bucket-Namens für den Datenzugriff verwenden können. Sie können diesen Zugriffspunkt-Alias anstelle eines Amazon-Ressourcennamens (ARN) für Zugriffspunkt-Operationen auf Datenebene verwenden. Eine Liste dieser Vorgänge finden Sie unter Kompatibilität von Zugangspunkten.

Ein Zugriffspunkt-Aliasname wird innerhalb desselben Namespace wie ein Amazon S3-Bucket erstellt. Dieser Aliasname wird automatisch generiert und kann nicht geändert werden. Ein Zugriffspunkt-Aliasname erfüllt alle Anforderungen eines gültigen Amazon S3-Bucket-Namens und besteht aus den folgenden Teilen:

ACCESS POINT NAME-METADATA-s3alias (für Zugangspunkte, die an einen Amazon-S3-Bucket angeschlossen sind)

ACCESS POINT NAME-METADATA-ext-s3alias (für Zugangspunkte, die an eine Datenquelle angeschlossen sind, die nicht zu einem S3-Bucket gehört)

Zugangspunkt-Alias-Anwendungsfälle und -beschränkungen

Bei der Übernahme von Zugriffspunkten können Sie Zugriffspunkt-Aliasnamen verwenden, ohne dass umfangreiche Codeänderungen erforderlich sind.

Wenn Sie einen Zugriffspunkt erstellen, generiert Amazon S3 automatisch einen Zugriffspunkt-Aliasnamen, wie im folgenden Beispiel gezeigt. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3control create-access-point --bucket amzn-s3-demo-bucket1 --name my-access-point --account-id 111122223333
{
    "AccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point",
    "Alias": "my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias"
}

Sie können diesen Zugriffspunkt-Aliasnamen anstelle eines Amazon S3-Bucket-Namen für jeden Datenebenen-Vorgang verwenden. Eine Liste dieser Vorgänge finden Sie unter Kompatibilität von Zugangspunkten.

Das folgende AWS CLI-Beispiel für den get-object-Befehl verwendet den Zugriffspunkt des Buckets, um Informationen über das angegebene Objekt zurückzugeben. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3api get-object --bucket my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias --key dir/my_data.rtf my_data.rtf
            
{
    "AcceptRanges": "bytes",
    "LastModified": "2020-01-08T22:16:28+00:00",
    "ContentLength": 910,
    "ETag": "\"00751974dc146b76404bb7290f8f51bb\"",
    "VersionId": "null",
    "ContentType": "text/rtf",
    "Metadata": {}
}

Einschränkungen für Zugangspunkt-Alias

URI im virtuellen Hosting-Stil

Zugriffspunkte unterstützen ausschließlich die virtuelle, Host-artige Adressierung. In einer URI im Stil eines virtuellen Hosts sind der Zugangspunktname, AWS-Konto und AWS-Region Teil des Domainnamens in der URL. Weitere Informationen über virtuelles Hosting finden Sie unter Virtuelles Hosting von Allzweck-Buckets.

Der Virtual-Hosted-Stil für Zugangspunkte verwendet das folgende Format:

https://access-point-name-account-id.s3-accesspoint.region.amazonaws.com