Verwenden von Dual-Stack-Endpunkten von S3 on Outposts - Amazon S3 on Outposts

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 von Dual-Stack-Endpunkten von S3 on Outposts

S3 auf Outposts Dual-Stack-Endpunkte unterstützen Anfragen an S3 auf Outposts-Buckets über und. IPv6 IPv4 In diesem Abschnitt wird die Verwendung von Dual-Stack-Endpunkten von S3 on Outposts beschrieben.

Dual-Stack-Endpunkte von S3 on Outposts

Wenn Sie eine Anfrage an einen Dual-Stack-Endpunkt stellen, wird die Bucket-URL von S3 on Outposts in eine Adresse IPv6 oder eine Adresse aufgelöst. IPv4 Weitere Informationen zum Zugriff auf einen S3 on Outposts Bucket over finden Sie IPv6 unterAnfragen an S3 auf Outposts stellen über IPv6.

Verwenden Sie einen Endpunktnamen im Path-Style, um über einen Dual-Stack-Endpunkt auf einen Bucket von S3 on Outposts zuzugreifen. S3 on Outposts unterstützt nur regionale Dual-Stack-Endpunktnamen, d. h. Sie müssen die Region als Teil des Namens angeben.

Verwenden Sie für einen FIPs Endpunkt im Stil eines Dual-Stack-Pfads die folgende Benennungskonvention:

s3-outposts-fips.region.api.aws

Dual-Stack-Endpunkte ohne FIPS verwenden die folgende Namenskonvention:

s3-outposts.region.api.aws
Anmerkung

Virtuell gehostete Endpunktnamen werden in S3 on Outposts nicht unterstützt.

Verwenden Sie Dual-Stack-Endpunkte aus dem AWS CLI

Dieser Abschnitt enthält Beispiele für AWS CLI Befehle, mit denen Anfragen an einen Dual-Stack-Endpunkt gestellt werden. Anweisungen zur Einrichtung von finden Sie AWS CLI unterErste Schritte mit dem AWS CLI und SDK for Java.

Sie legen den Konfigurationswert true in einem Profil in Ihrer AWS Config Datei use_dualstack_endpoint auf fest, um alle Amazon S3 S3-Anfragen, die von den s3api AWS CLI Befehlen s3 und gestellt werden, an den Dual-Stack-Endpunkt für die angegebene Region weiterzuleiten. Sie geben die Region in der Konfigurationsdatei oder in einem Befehl mit der Option --region an.

Bei der Verwendung von Dual-Stack-Endpunkten mit dem wird nur der AWS CLIpath Adressierungsstil unterstützt. Der Adressierungsstil, der in der Konfigurationsdatei festgelegt wird, bestimmt, ob der Bucket-Name im Hostnamen oder in der URL enthalten ist. Weitere Informationen finden Sie unter s3outposts im AWS CLI -Benutzerhandbuch.

Um einen Dual-Stack-Endpunkt über den zu verwenden AWS CLI, verwenden Sie den --endpoint-url Parameter mit dem https://s3-outposts-fips.region.api.aws Endpunkt http://s3.dualstack.region.amazonaws.com oder für alle s3control OR-Befehle. s3outposts

Zum Beispiel:

$ aws s3control list-regional-buckets --endpoint-url https://s3-outposts.region.api.aws

Verwendung von S3 auf Outposts-Dual-Stack-Endpunkten von AWS SDKs

Dieser Abschnitt enthält Beispiele für den Zugriff auf einen Dual-Stack-Endpunkt mithilfe von. AWS SDKs

Beispiel für einen AWS SDK for Java 2.x -Dual-Stack-Endpunkt

Das folgende Beispiel veranschaulicht, wie Sie beim Erstellen eines S3-in-Outposts-Clients mit AWS SDK for Java 2.x die Klassen S3ControlClient und S3OutpostsClient verwenden, um Dual-Stack-Endpunkte zu aktivieren. Anweisungen zum Erstellen und Testen eines funktionierenden Java-Beispiels für Amazon S3 on Outposts finden Sie unter Erste Schritte mit dem AWS CLI und SDK for Java.

Beispiel – Eine S3ControlClient-Klasse mit aktivierten Dual-Stack-Endpunkten erstellen
import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.ListRegionalBucketsRequest; import software.amazon.awssdk.services.s3control.model.ListRegionalBucketsResponse; import software.amazon.awssdk.services.s3control.model.S3ControlException; public class DualStackEndpointsExample1 { public static void main(String[] args) { Region clientRegion = Region.of("us-east-1"); String accountId = "111122223333"; String navyId = "9876543210"; try { // Create an S3ControlClient with dual-stack endpoints enabled. S3ControlClient s3ControlClient = S3ControlClient.builder() .region(clientRegion) .dualstackEnabled(true) .build(); ListRegionalBucketsRequest listRegionalBucketsRequest = ListRegionalBucketsRequest.builder() .accountId(accountId) .outpostId(navyId) .build(); ListRegionalBucketsResponse listBuckets = s3ControlClient.listRegionalBuckets(listRegionalBucketsRequest); System.out.printf("ListRegionalBuckets Response: %s%n", listBuckets.toString()); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 on Outposts couldn't process // it, so it returned an error response. e.printStackTrace(); } catch (S3ControlException e) { // Unknown exceptions will be thrown as an instance of this type. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 on Outposts couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3 on Outposts. e.printStackTrace(); } } }
Beispiel – Eine S3OutpostsClient-Klasse mit aktivierten Dual-Stack-Endpunkten erstellen
import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3outposts.S3OutpostsClient; import software.amazon.awssdk.services.s3outposts.model.ListEndpointsRequest; import software.amazon.awssdk.services.s3outposts.model.ListEndpointsResponse; import software.amazon.awssdk.services.s3outposts.model.S3OutpostsException; public class DualStackEndpointsExample2 { public static void main(String[] args) { Region clientRegion = Region.of("us-east-1"); try { // Create an S3OutpostsClient with dual-stack endpoints enabled. S3OutpostsClient s3OutpostsClient = S3OutpostsClient.builder() .region(clientRegion) .dualstackEnabled(true) .build(); ListEndpointsRequest listEndpointsRequest = ListEndpointsRequest.builder().build(); ListEndpointsResponse listEndpoints = s3OutpostsClient.listEndpoints(listEndpointsRequest); System.out.printf("ListEndpoints Response: %s%n", listEndpoints.toString()); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 on Outposts couldn't process // it, so it returned an error response. e.printStackTrace(); } catch (S3OutpostsException e) { // Unknown exceptions will be thrown as an instance of this type. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 on Outposts couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3 on Outposts. e.printStackTrace(); } } }

Wenn Sie das AWS SDK for Java 2.x unter Windows verwenden, müssen Sie möglicherweise die folgende JVM-Eigenschaft (Java Virtual Machine) festlegen:

java.net.preferIPv6Addresses=true