Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用 Amazon S3 双堆栈端点

Amazon S3 双堆栈端点支持通过 IPv6 和 IPv4 向 S3 存储桶发出请求。本节介绍如何使用双堆栈端点。

Amazon S3 双堆栈端点

当您向双堆栈端点发出请求时，存储桶 URL 解析为 IPv6 或 IPv4 地址。有关如何通过 IPv6 访问存储桶的更多信息，请参阅通过 IPv6 向 Amazon S3 发出请求。

当使用 REST API 时，您通过使用端点名称（URI）直接访问 Amazon S3 端点。通过使用虚拟托管类型或路径类型端点名称，您可以通过双堆栈端点访问 S3 存储桶。Amazon S3 只支持区域双堆栈端点名称，这意味着，您必须在名称中指定区域。

双堆栈虚拟托管类型和路径类型端点名称使用以下命名惯例：

有关端点名称样式的更多信息，请参阅访问和列出 Amazon S3 存储桶。有关 Amazon S3 端点的列表，请参阅《Amazon Web Services 一般参考》中的区域和端点。

如果使用 Amazon Command Line Interface（Amazon CLI）和 Amazon SDK，可使用参数或标志以更改为双堆栈端点。您还可以在配置文件中直接将双堆栈端点指定为覆盖 Amazon S3 端点。下面几节介绍如何从 Amazon CLI 和 Amazon SDK 使用双堆栈端点。

从 Amazon CLI 使用双堆栈端点

本节提供用于向双堆栈端点发出请求的 Amazon CLI 命令示例。有关设置 Amazon CLI 的说明，请参阅使用 Amazon CLI 进行 Amazon S3 开发。

在 Amazon Config 文件中的配置文件中将配置值 use_dualstack_endpoint 设置为 true，使 s3 和 s3api Amazon CLI 命令发出的所有 Amazon S3 请求定向到指定区域的双堆栈端点。您可以在配置文件或命令中使用 --region 选项指定区域。

通过 Amazon CLI 使用双堆栈端点时，支持 path 和 virtual 寻址类型。配置文件中设置的寻址类型控制着主机名或 URL 中是否包含存储桶名称。默认情况下，CLI 尝试使用虚拟类型，但是如果需要，会改为使用路径类型。有关更多信息，请参阅 Amazon CLI Amazon S3 配置。

您也可以使用命令进行配置更改，如下例所示，在默认配置文件中将 use_dualstack_endpoint 设置为 true，将 addressing_style 设置为 virtual。

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

如果需要只对指定的 Amazon CLI 命令（并非所有命令）使用双堆栈端点，可以使用以下任一方法：

从 Amazon SDK 使用双堆栈端点

本节提供一些示例，介绍如何使用 Amazon SDK 来访问双堆栈端点。

Amazon SDK for Java双堆栈端点示例

以下示例演示如何使用 Amazon SDK for Java 在创建 Amazon S3 客户端时启用双堆栈端点。

有关创建和测试有效 Java 示例的说明，请参阅《Amazon SDK for Java 开发人员指南》中的入门。

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

如果要在 Windows 上使用Amazon SDK for Java，可能必须设置以下 Java 虚拟机 (JVM) 属性：

java.net.preferIPv6Addresses=true

Amazon .NET SDK 双堆栈端点示例

在使用 Amazon SDK for .NET 时，请使用 AmazonS3Config 类来启用双堆栈端点，如下例所示。

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

有关所列对象的完整 .NET 示例，请参阅以编程方式列出对象键。

有关设置和运行代码示例的信息，请参阅《适用于 .NET 的 Amazon SDK 开发人员指南》中的适用于 .NET 的 Amazon SDK 入门。

从 REST API 使用双堆栈端点

有关如何使用 REST API 向双堆栈端点发出请求的信息，请参阅通过使用 REST API 向双堆栈终端节点发出请求。