Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan titik akhir tumpukan ganda Amazon S3

Titik akhir tumpukan ganda Amazon S3 mendukung permintaan ke bucket S3 melalui IPv6 dan IPv4. Bagian ini menjelaskan cara untuk menggunakan titik akhir tumpukan ganda.

Titik akhir tumpukan ganda Amazon S3

Saat Anda membuat permintaan ke titik akhir tumpukan ganda, URL bucket memutuskan ke alamat IPv6 atau IPv4. Untuk informasi lebih lanjut tentang mengakses bucket melalui IPv6, lihat Membuat permintaan ke Amazon S3 melalui IPv6.

Saat menggunakan API REST, Anda secara langsung mengakses titik akhir Amazon S3 dengan menggunakan nama titik akhir (URI). Anda dapat mengakses bucket S3 melalui titik akhir tumpukan ganda dengan menggunakan nama titik akhir cara hosting virtual dan cara jejak. Amazon S3 hanya mendukung nama titik akhir tumpukan ganda regional, yang berarti Anda harus menentukan wilayah sebagai bagian dari nama.

Gunakan konvensi penamaan berikut untuk nama titik akhir cara hosting virtual dan cara jejak:

Untuk informasi selengkapnya, tentang gaya nama titik akhir, lihat Mengakses dan mencantumkan bucket Amazon S3. Untuk daftar titik akhir Amazon S3, lihat Wilayah dan Titik Akhir di Referensi Umum AWS.

Saat menggunakan AWS Command Line Interface (AWS CLI) dan AWS SDK, Anda dapat menggunakan parameter atau flag untuk mengubah ke titik akhir tumpukan ganda. Anda juga dapat menentukan titik akhir tumpukan ganda secara langsung sebagai pembatalan titik akhir Amazon S3 dalam berkas config. Bagian berikut menjelaskan cara menggunakan titik akhir dual-stack dari AWS CLI dan SDK. AWS

Menggunakan titik akhir dual-stack dari AWS CLI

Bagian ini memberikan contoh AWS CLI perintah yang digunakan untuk membuat permintaan ke titik akhir tumpukan ganda. Untuk petunjuk tentang pengaturan AWS CLI, lihatMengembangkan dengan Amazon S3 menggunakan AWS CLI.

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

Saat menggunakan titik akhir dual-stack dengan AWS CLI, keduanya path dan gaya virtual pengalamatan didukung. Cara pengalamatan, diatur dalam berkas config, mengontrol apakah nama bucket ada dalam nama host atau bagian dari URL. Secara default, CLI akan mencoba menggunakan cara virtual jika memungkinkan, tetapi akan kembali ke cara jejak jika perlu. Untuk informasi selengkapnya, lihat Konfigurasi Amazon S3 AWS CLI.

Anda juga dapat membuat perubahan konfigurasi dengan menggunakan perintah, seperti ditunjukkan dalam contoh berikut, yang menetapkan use_dualstack_endpoint ke true dan addressing_style ke virtual di profil default.

$ aws configure set default.s3.use_dualstack_endpoint true
$ aws configure set default.s3.addressing_style virtual

Jika Anda ingin menggunakan titik akhir tumpukan ganda hanya untuk AWS CLI perintah tertentu (tidak semua perintah), Anda dapat menggunakan salah satu metode berikut:

Menggunakan titik akhir dual-stack dari AWS SDK

Bagian ini memberikan contoh cara mengakses titik akhir tumpukan ganda dengan menggunakan AWS SDK.

AWS SDK untuk Java contoh titik akhir tumpukan ganda

Contoh berikut menunjukkan cara mengaktifkan titik akhir tumpukan ganda saat membuat klien Amazon S3 menggunakan AWS SDK untuk Java.

Untuk petunjuk tentang membuat dan menguji sampel Java yang berfungsi, lihat Memulai di Panduan Peng AWS SDK untuk Java embang.

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;

public class DualStackEndpoints {

    public static void main(String[] args) {
        Regions clientRegion = Regions.DEFAULT_REGION;
        String bucketName = "*** Bucket name ***";

        try {
            // Create an Amazon S3 client with dual-stack endpoints enabled.
            AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(clientRegion)
                    .withDualstackEnabled(true)
                    .build();

            s3Client.listObjects(bucketName);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it, so it returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

Jika Anda menggunakan AWS SDK untuk Java pada Windows, Anda mungkin harus mengatur properti mesin virtual Java (JVM) berikut:

java.net.preferIPv6Addresses=true

AWS Contoh titik akhir tumpukan ganda .NET SDK

Saat menggunakan AWS SDK untuk.NET, Anda menggunakan AmazonS3Config kelas untuk mengaktifkan penggunaan titik akhir tumpukan ganda seperti yang ditunjukkan pada contoh berikut.

using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
using System;
using System.Threading.Tasks;

namespace Amazon.DocSamples.S3
{
    class DualStackEndpointTest
    {
        private const string bucketName = "*** bucket name ***";
        // Specify your bucket region (an example region is shown).
        private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2;
        private static IAmazonS3 client;

        public static void Main()
        {
            var config = new AmazonS3Config
            {
                UseDualstackEndpoint = true,
                RegionEndpoint = bucketRegion
            };
            client = new AmazonS3Client(config);
            Console.WriteLine("Listing objects stored in a bucket");
            ListingObjectsAsync().Wait();
        }

        private static async Task ListingObjectsAsync()
        {
            try
            {
                var request = new ListObjectsV2Request
                {
                    BucketName = bucketName,
                    MaxKeys = 10
                };
                ListObjectsV2Response response;
                do
                {
                    response = await client.ListObjectsV2Async(request);

                    // Process the response.
                    foreach (S3Object entry in response.S3Objects)
                    {
                        Console.WriteLine("key = {0} size = {1}",
                            entry.Key, entry.Size);
                    }
                    Console.WriteLine("Next Continuation Token: {0}", response.NextContinuationToken);
                    request.ContinuationToken = response.NextContinuationToken;
                } while (response.IsTruncated == true);
            }
            catch (AmazonS3Exception amazonS3Exception)
            {
                Console.WriteLine("An AmazonS3Exception was thrown. Exception: " + amazonS3Exception.ToString());
            }
            catch (Exception e)
            {
                Console.WriteLine("Exception: " + e.ToString());
            }
        }
    }
}

Untuk informasi tentang menyiapkan dan menjalankan contoh kode, lihat Mem ulai dengan AWS SDK untuk.NET di Panduan Pengembang AWS SDK untuk.NET.

Menggunakan titik akhir tumpukan ganda dari API REST

Untuk informasi tentang permintaan sampai ke titik akhir tumpukan ganda dengan menggunakan API REST, lihat Membuat permintaan ke titik akhir tumpukan ganda menggunakan API REST.