Abrufen eines S3-on-Outposts-Buckets mithilfe der AWS CLI und des 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?.

Die folgenden Beispiele veranschaulichen, wie Sie mithilfe der AWS CLI und AWS SDK for Java einen S3-on-Outposts-Bucket abrufen.

Anmerkung

Wenn Sie mit Amazon S3 on Outposts über die AWS CLI oder AWS-SDKs arbeiten, geben Sie den Zugriffspunkt-ARN für den Outpost anstelle des Bucket-Namens an. Der Zugriffspunkt-ARN nimmt das folgende Format an, wobei region der AWS-Region-Code für die Region ist, in der sich der Outpost befindet:

arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point

Weitere Informationen zu S3-in-Outposts-ARNs finden Sie unter Ressourcen-ARNs für S3 on Outposts.

Verwendung der AWS CLI

Im folgenden Beispiel wird ein S3-on-Outposts-Bucket mit der AWS CLI abgerufen. Zum Verwenden dieses Befehls ersetzen Sie user input placeholder durch Ihre eigenen Informationen. Weitere Informationen über diesen Befehl finden Sie unter get-bucket in der AWS CLI-Referenz.

aws s3control get-bucket --account-id 123456789012 --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket"

Verwenden des AWS-SDKs für Java

Im folgenden Beispiel für S3 on Outposts wird ein Bucket mit dem SDK for Java abgerufen. Weitere Informationen finden Sie unter GetBucket in der API-Referenz zu Amazon Simple Storage Service.

import com.amazonaws.services.s3control.model.*;

public void getBucket(String bucketArn) {

    GetBucketRequest reqGetBucket = new GetBucketRequest()
            .withBucket(bucketArn)
            .withAccountId(AccountId);

    GetBucketResult respGetBucket = s3ControlClient.getBucket(reqGetBucket);
    System.out.printf("GetBucket Response: %s%n", respGetBucket.toString());

}