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.
Erste Schritte mit der AWS CLI und dem SDK for Java
Mit Amazon S3 in 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 Management Console, AWS Command Line Interface (AWS CLI), AWS-SDKs oder die 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 Management Console.
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
-
Im folgenden Beispiel wird ein S3-on-Outposts-Bucket (s3-outposts:CreateBucket
) mit dem SDK für Java erstellt.
import com.amazonaws.services.s3control.model.*;
public String createBucket(String bucketName) {
CreateBucketRequest reqCreateBucket = new CreateBucketRequest()
.withBucket(bucketName)
.withOutpostId(OutpostId)
.withCreateBucketConfiguration(new CreateBucketConfiguration());
CreateBucketResult respCreateBucket = s3ControlClient.createBucket(reqCreateBucket);
System.out.printf("CreateBucket Response: %s%n", respCreateBucket.toString());
return respCreateBucket.getBucketArn();
}
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.
Zugriffspunkte 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
-
Im folgenden Beispiel für SDK für Java wird ein Zugriffspunkt für einen Outposts-Bucket erstellt. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie user input placeholders
durch Ihre Informationen.
import com.amazonaws.services.s3control.model.*;
public String createAccessPoint(String bucketArn, String accessPointName) {
CreateAccessPointRequest reqCreateAP = new CreateAccessPointRequest()
.withAccountId(AccountId)
.withBucket(bucketArn)
.withName(accessPointName)
.withVpcConfiguration(new VpcConfiguration().withVpcId("vpc-12345
"));
CreateAccessPointResult respCreateAP = s3ControlClient.createAccessPoint(reqCreateAP);
System.out.printf("CreateAccessPoint Response: %s%n", respCreateAP.toString());
return respCreateAP.getAccessPointArn();
}
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
-
Im folgenden SDK für Java-Beispiel wird ein Endpunkt für einen Outpost erstellt. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie user input placeholders
durch Ihre Informationen.
import com.amazonaws.services.s3outposts.AmazonS3Outposts;
import com.amazonaws.services.s3outposts.AmazonS3OutpostsClientBuilder;
import com.amazonaws.services.s3outposts.model.CreateEndpointRequest;
import com.amazonaws.services.s3outposts.model.CreateEndpointResult;
public void createEndpoint() {
AmazonS3Outposts s3OutpostsClient = AmazonS3OutpostsClientBuilder
.standard().build();
CreateEndpointRequest createEndpointRequest = new CreateEndpointRequest()
.withOutpostId("op-0d79779cef3c30a40
")
.withSubnetId("subnet-8c7a57c5
")
.withSecurityGroupId("sg-ab19e0d1
")
.withAccessType("CustomerOwnedIp")
.withCustomerOwnedIpv4Pool("ipv4pool-coip-12345678901234567");
// Use .withAccessType and .withCustomerOwnedIpv4Pool only when the access type is
// customer-owned IP address pool (CoIP pool)
CreateEndpointResult createEndpointResult = s3OutpostsClient.createEndpoint(createEndpointRequest);
System.out.println("Endpoint is created and its ARN is " + createEndpointResult.getEndpointArn());
}
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.