Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Referenzierung von Access Points im Stil von Access Points mit ARNs Aliasnamen oder virtuell gehostet URIs
Nachdem Sie einen Access Point erstellt haben, können Sie mit diesen Endpunkten eine Reihe von Vorgängen ausführen. Wenn Sie auf einen Access Point verweisen, können Sie Amazon Resource Names (ARNs), den Access Point-Alias oder den URI im virtual-hosted-Stil verwenden.
Zugriffspunkt ARNs
Access Points haben Amazon-Ressourcennamen (ARNs). Access ARNs Points ähneln Bucket ARNs, sind jedoch explizit typisiert und kodieren die ID des Access Points AWS-Region und die AWS-Konto ID des Besitzers des Access Points. Weitere Informationen zu ARNs finden Sie unter Identifizieren von AWS Ressourcen mit Amazon-Ressourcennamen (ARNs) im IAM-Benutzerhandbuch.
Der Access Point ARNs verwendet das folgende Format:
arn:aws:s3:
region
:account-id
:accesspoint/resource
-
arn:aws:s3:
repräsentiert den Zugangspunkt namensus-west-2
:123456789012
:accesspoint/test
, der dem Kontotest
in der Region123456789012
gehört.us-west-2
-
arn:aws:s3:
repräsentiert alle Zugangspunkte unter dem Kontous-west-2
:123456789012
:accesspoint/*
in der Region123456789012
.us-west-2
ARNs Verwenden Sie für Objekte, auf die über einen Access Point zugegriffen wird, das folgende Format:
arn:aws:s3:
region
:account-id
:accesspoint/access-point-name
/object/resource
-
arn:aws:s3:
repräsentiert das Objektus-west-2
:123456789012
:accesspoint/test
/object/unit-01
, auf das durch den Zugangspunkt namensunit-01
zugegriffen wird, das dem Kontotest
in der Region123456789012
gehört.us-west-2
-
arn:aws:s3:
repräsentiert alle Objekte für den Zugangspunkt namensus-west-2
:123456789012
:accesspoint/test
/object/*
im Kontotest
in der Region123456789012
.us-west-2
-
arn:aws:s3:
repräsentiert alle Objekte unter dem Präfixus-west-2
:123456789012
:accesspoint/test
/object/unit-01
/finance
/*
für den Zugangspunkt namensunit-01/finance/
im Kontotest
in der Region123456789012
.us-west-2
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 mit Access Points.
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:
(für Access Points, die an einen Amazon S3 S3-Bucket angeschlossen sind)ACCESS POINT NAME
-METADATA-s3alias
(für Access Points, die an eine Nicht-S3-Bucket-Datenquelle angeschlossen sind)ACCESS POINT NAME
-METADATA-ext-s3alias
Anmerkung
Die -ext-s3alias
Suffixe -s3alias
und sind für Aliasnamen von Access Points reserviert und können nicht für Bucket- oder Access Point-Namen verwendet werden. Weitere Informationen zu Amazon-S3-Bucket-Benennungsregeln finden Sie unter Benennungsregeln für Allzweck-Buckets.
Aliase für Access Points, Anwendungsfälle und Einschrä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
durch Ihre Informationen.user
input placeholders
aws s3control create-access-point --bucket
amzn-s3-demo-bucket1
--namemy-access-point
--account-id111122223333
{ "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 mit Access Points.
Im folgenden AWS CLI Beispiel für den get-object
Befehl wird der Access Point-Alias des Buckets verwendet, um Informationen über das angegebene Objekt zurückzugeben. Zum Ausführen dieses Befehls ersetzen Sie
durch Ihre Informationen.user input placeholders
aws s3api get-object --bucket
my-access-point
-aqfqprnstn7aefdfbarligizwgyfouse1a
-s3alias --keydir/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 den Alias des Access Points
-
Aliase können nicht von Kunden konfiguriert werden.
-
Aliasse können auf einem Zugriffspunkt nicht gelöscht, geändert oder deaktiviert werden.
-
Sie können diesen Zugriffspunkt-Aliasnamen anstelle eines Amazon-S3-Bucket-Namen für manche Datenebenen-Operationen verwenden. Eine Liste dieser Vorgänge finden Sie unter Kompatibilität der Access Points mit S3-Vorgängen.
-
Sie können einen Aliasnamen für Amazon S3-Kontrollebenenvorgänge nicht verwenden. Eine Liste der Amazon S3-Kontrollebenenvorgänge finden Sie unter Amazon S3-Kontrolle in der API-Referenz für Amazon Simple Storage Service.
-
Sie können S3-Zugangspunkt-Aliasse nicht als Quelle oder Ziel für Verschieben-Operationen in der Amazon-S3-Konsole verwenden.
-
Aliase können nicht in AWS Identity and Access Management (IAM-) Richtlinien verwendet werden.
-
Aliase können nicht als Protokollierungsziel für S3-Server-Zugriffsprotokolle verwendet werden.
-
Aliase können nicht als Protokollierungsziel für AWS CloudTrail -Protokolle verwendet werden.
-
Amazon SageMaker AI GroundTruth unterstützt keine Access Point-Aliase.
URI im Virtual-Hosted-Stil
Access Points unterstützen nur Adressierung. virtual-host-style Bei einer URI im Stil eines virtuellen Hostings AWS-Region ist der Name des Access Points, AWS-Konto, und Teil des Domainnamens in der URL. Weitere Informationen zu virtuellem Hosting finden Sie unter. Virtuelles Hosting von Allzweck-Buckets
URI im Virtual-Hosted-Stil für Access Points verwenden das folgende Format:
https://
access-point-name
-account-id
.s3-accesspoint.region
.amazonaws.com
Anmerkung
-
Wenn der Name Ihres Zugriffspunkts Bindestriche (-) enthält, fügen Sie die Bindestriche in die URL ein und fügen einen weiteren Bindestrich vor der Konto-ID ein. Wenn Sie beispielsweise einen Zugangspunkt namens
verwenden möchten, der im Besitz des Kontosfinance-docs
in der Region123456789012
ist, würde die entsprechende URLus-west-2
https://
lauten.finance-docs
-123456789012
.s3-accesspoint.us-west-2
.amazonaws.com -
S3 Access Points unterstützen keinen Zugriff über HTTP. Access Points unterstützen nur den sicheren Zugriff über HTTPS.