Verwenden eines Alias im Bucket-Stil für Ihren S3-Bucket-Zugriffspunkt - Amazon Simple Storage Service

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.

Verwenden eines Alias im Bucket-Stil für Ihren S3-Bucket-Zugriffspunkt

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 Access Point-Alias anstelle eines Amazon-Ressourcennamens (ARN) für Operationen auf der Datenebene des Access Points verwenden. Eine Liste dieser Vorgänge finden Sie unter Kompatibilität des Access Points mit Diensten AWS.

Im Folgenden finden Sie ein Beispiel ARN und einen Zugriffspunkt-Alias für einen Access Point mit dem Namenmy-access-point.

  • ARNarn:aws:s3:region:account-id:accesspoint/my-access-point

  • Zugriffspunkt-Aliasmy-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias

Weitere Informationen zu finden Sie ARNs unter Amazon Resource Names (ARNs) in der Allgemeine AWS-Referenz.

Aliasname für Zugriffspunkte

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 prefix-metadata-s3alias

Anmerkung

Das Suffix -s3alias ist für Zugriffspunkt-Aliasnamen reserviert und kann nicht für Bucket- oder Zugriffspunkt-Namen verwendet werden. Weitere Informationen zu Amazon-S3-Bucket-Benennungsregeln finden Sie unter Regeln für die Benennung von Buckets.

Zugriffspunkt-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 des Access Points mit Diensten AWS.

Das folgende AWS CLI Beispiel für den get-object Befehl verwendet den Access Point-Alias 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

  • 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 Zugriffspunkt-Kompatibilität mit S3-Vorgänge.

  • Sie können einen Aliasnamen für Amazon S3-Kontrollebenenvorgänge nicht verwenden. Eine Liste der Vorgänge auf der Amazon S3-Steuerebene finden Sie unter Amazon S3 Control in der Amazon Simple Storage Service API Reference.

  • Sie können S3-Zugriffspunkt-Aliase nicht als Quelle oder Ziel für Move-Operationen in der Amazon S3 S3-Konsole verwenden.

  • Aliase können nicht in Richtlinien AWS Identity and Access Management (IAM) verwendet werden.

  • Aliase können nicht als Protokollierungsziel für S3-Server-Zugriffsprotokolle verwendet werden.

  • Aliase können nicht als Ziel für AWS CloudTrail die Protokollierung von Protokollen verwendet werden.

  • Amazon unterstützt SageMaker GroundTruth keine Access Point-Aliase.