Menggunakan S3 pada titik akhir dual-stack Outposts

S3 di Outposts dual-stack endpoint mendukung permintaan ke S3 pada bucket Outposts over dan. IPv6 IPv4 Bagian ini menjelaskan cara menggunakan S3 pada titik akhir dual-stack Outposts.

S3 pada titik akhir tumpukan ganda Outposts

Saat Anda membuat permintaan ke titik akhir dual-stack, URL bucket S3 on Outposts akan menyelesaikan ke alamat atau alamat. IPv6 IPv4 Untuk informasi selengkapnya tentang mengakses bucket S3 on Outposts, lihat. IPv6 Membuat permintaan ke S3 di Outposts over IPv6

Untuk mengakses bucket S3 di Outposts melalui endpoint dual-stack, gunakan nama endpoint gaya jalur. S3 di Outposts hanya mendukung nama titik akhir dual-stack Regional, yang berarti Anda harus menentukan Region sebagai bagian dari nama.

Untuk FIPs titik akhir gaya jalur tumpukan ganda, gunakan konvensi penamaan berikut:

s3-outposts-fips.region.api.aws

Untuk dual-stack non- FIPS endpoint, gunakan konvensi penamaan berikut:

s3-outposts.region.api.aws

catatan

Nama titik akhir bergaya host virtual tidak didukung di S3 di Outposts.

Menggunakan titik akhir tumpukan ganda dari AWS CLI

Bagian ini memberikan contoh AWS CLI perintah yang digunakan untuk membuat permintaan ke endpoint dual-stack. Untuk petunjuk tentang pengaturan AWS CLI, lihatMemulai dengan menggunakan AWS CLI dan SDK untuk Java.

Anda menetapkan nilai konfigurasi use_dualstack_endpoint ke true dalam profil dalam AWS Config file Anda untuk mengarahkan semua permintaan Amazon S3 yang dibuat oleh s3api AWS CLI perintah s3 dan ke titik akhir tumpukan ganda untuk Wilayah yang ditentukan. Anda menentukan Wilayah dalam file konfigurasi atau dalam perintah menggunakan --region opsi.

Saat menggunakan titik akhir tumpukan ganda dengan AWS CLI, hanya gaya path pengalamatan yang didukung. Gaya pengalamatan, yang diatur dalam file konfigurasi, menentukan apakah nama bucket ada di nama host atau di file. URL Untuk informasi selengkapnya, silakan lihat s3outposts di Panduan Pengguna AWS CLI .

Untuk menggunakan titik akhir tumpukan ganda melalui AWS CLI, gunakan --endpoint-url parameter dengan https://s3-outposts-fips.region.api.aws titik akhir http://s3.dualstack.region.amazonaws.com atau untuk perintah apa pun atau. s3control s3outposts

Sebagai contoh:

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

Menggunakan S3 pada titik akhir tumpukan ganda Outposts dari AWS SDKs

Bagian ini memberikan contoh cara mengakses endpoint dual-stack dengan menggunakan. AWS SDKs

Contoh titik akhir tumpukan ganda AWS SDK for Java 2.x

Contoh berikut menunjukkan cara menggunakan S3OutpostsClient kelas S3ControlClient dan untuk mengaktifkan titik akhir dual-stack saat membuat klien S3 di Outposts menggunakan file. AWS SDK for Java 2.x Untuk petunjuk tentang membuat dan menguji contoh Java yang berfungsi untuk Amazon S3 di Outposts, lihat. Memulai dengan menggunakan AWS CLI dan SDK untuk Java

contoh — Buat S3ControlClient kelas dengan titik akhir dual-stack diaktifkan

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();
        }
    }
}

contoh — Buat S3OutpostsClient dengan titik akhir dual-stack diaktifkan

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();
        }
    }
}

Jika Anda menggunakan AWS SDK for Java 2.x pada Windows, Anda mungkin harus mengatur properti Java virtual machine (JVM) berikut:

java.net.preferIPv6Addresses=true