Erste Schritte mit der AWS CLI und dem SDK for Java - Amazon S3 on Outposts

Erste Schritte mit der AWS CLI und dem SDK for Java

Mit Amazon S3 on Outposts können Sie S3-Buckets auf Ihren AWS-Outposts erstellen und Objekte für Anwendungen, die einen lokalen Datenzugriff, eine lokale Datenverarbeitung und eine lokale Datenresidenz erfordern, auf einfache Weise On-Premise speichern und abrufen. S3 on Outposts bietet eine neue Speicherklasse namens S3 Outposts (OUTPOSTS). Sie nutzt die Amazon-S3-APIs und ist darauf ausgelegt, Daten über mehrere Geräte und Server hinweg in Ihrem AWS Outposts dauerhaft und redundant zu speichern. Sie kommunizieren mit Ihrem Outpost-Bucket über einen Zugriffspunkt und eine Endpunktverbindung über eine Virtual Private Cloud (VPC). Sie können bei Outpost-Buckets dieselben APIs und Funktionen wie in Amazon-S3-Buckets verwenden, inklusive Zugriffsrichtlinien, Verschlüsselung und Markierungen. Sie können S3 on Outposts über die AWS-Managementkonsole, AWS Command Line Interface (AWS CLI), AWS-SDKs oder REST-API verwenden. Weitere Informationen finden Sie unter . Was ist Amazon S3 on Outposts?

Für die ersten Schritte mit S3 on Outposts müssen Sie einen Bucket, einen Zugriffspunkt und einen Endpunkt erstellen. Anschließend können Sie Ihre Objekte in den Bucket hochladen. Die folgenden Beispiele veranschaulichen, wie Sie die ersten Schritte mit S3 on Outposts mithilfe der AWS CLI und des SDK for Java ausführen können. Die ersten Schritte mit der Konsole finden Sie unter Erste Schritte unter Verwendung der AWS-Managementkonsole.

Schritt 1: Erstellen eines Buckets

Die folgenden Beispiele für AWS CLI und SDK für Java veranschaulichen, wie Sie einen S3-on-Outposts-Bucket erstellen.

AWS CLI

Im folgenden Beispiel wird ein S3-on-Outposts-Bucket (s3-outposts:CreateBucket) mithilfe der AWS CLI erstellt. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3control create-bucket --bucket example-outposts-bucket --outpost-id op-01ac5d28a6a232904
SDK for Java

Beispiele für die Erstellung eines S3 Outposts-Buckets mit dem AWS-SDK für Java finden Sie unter CreateOutpostsBucket.java in den Codebeispielen für AWS-SDK für Java 2.x.

Schritt 2: Erstellen eines Zugriffspunkts

Um auf Ihren Amazon-S3-on-Outposts-Bucket zuzugreifen, müssen Sie einen Zugriffspunkt erstellen und konfigurieren. Diese Beispiele veranschaulichen, wie Sie einen Zugriffspunkt mithilfe der AWS CLI und des SDK for Java erstellen.

Zugangspunkte vereinfachen die skalierbare Verwaltung des Datenzugriffs auf freigegebene Datensätze in Amazon S3. Zugriffspunkte sind benannte Netzwerkendpunkte, die Buckets zugeordnet sind, mit denen Sie Amazon S3-Objekt-Vorgänge ausführen können, z. B. GetObject und PutObject. Bei S3 on Outposts müssen Sie Zugriffspunkte verwenden, um auf ein Objekt in einem Outposts-Bucket zuzugreifen. Zugriffspunkte unterstützen ausschließlich die virtuelle, Host-artige Adressierung.

AWS CLI

Im folgenden AWS CLI-Beispiel wird ein Zugriffspunkt für einen Outposts-Bucket erstellt. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345
SDK for Java

Beispiele dafür, wie Sie mit dem AWS SDK für Java einen Zugangspunkt für einen S3 Outposts-Bucket erstellen, finden Sie unter CreateOutpostsAccessPoint.java in den Codebeispielen für AWS SDK für Java 2.x.

Schritt 3: Erstellen eines Endpunkts

Wenn Sie Anforderungen an einen Zugriffspunkt für Amazon S3 on Outposts weiterleiten möchten, müssen Sie einen S3-on-Outposts-Endpunkt erstellen und konfigurieren. Zum Erstellen eines Endpunkts muss Ihr Service-Link eine aktive Verbindung mit Ihrer Outposts-Heimatregion aufweisen. Jeder Virtual Private Cloud (VPC) in Ihrem Outpost kann ein Endpunkt zugeordnet sein. Weitere Informationen zu Endpunktkontingenten finden Sie unter Netzwerkanforderungen von S3 on Outposts. Sie müssen einen Endpunkt erstellen, um auf Ihre Outposts-Buckets zugreifen und Objekt-Operationen ausführen zu können. Weitere Informationen finden Sie unter Endpunkte.

Diese Beispiele veranschaulichen, wie Sie einen Endpunkt mithilfe der AWS CLI und des SDK for Java erstellen. Weitere Informationen zu den erforderlichen Berechtigungen für das Erstellen und Verwalten von Endpunkten finden Sie unter Berechtigungen für S3-on-Outposts-Endpunkte.

AWS CLI

Im folgenden AWS CLI-Beispiel wird ein Endpunkt für einen Outpost mithilfe des VPC-Ressourcenzugriffstyps erstellt. Die VPC ist vom Subnetz abgeleitet. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1

Im folgenden AWS CLI-Beispiel wird ein Endpunkt für einen Outpost mit dem Zugriffstyp des kundeneigenen IP-Adresspools (CoIP-Pool) erstellt. Zum Ausführen dieses Befehls ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1 --access-type CustomerOwnedIp --customer-owned-ipv4-pool ipv4pool-coip-12345678901234567
SDK for Java

Beispiele dafür, wie Sie mit dem AWS SDK für Java einen Endpunkt für einen S3 Outpost erstellen, finden Sie unter CreateOutpostsEndpunkt.java in den Codebeispielen für AWS SDK für Java 2.x.

Schritt 4: Hochladen eines Objekts in einen S3-on-Outposts-Bucket

Informationen zum Hochladen eines Objekts finden Sie unter Hochladen eines Objekts in einen S3-on-Outposts-Bucket.