Amazon.S3.AmazonS3Config.UseAccelerateEndpoint summary is not correct anymore

[congthanhnguyenOL]

Describe the issue

The <remarks/> of Amazon.S3.AmazonS3Config.UseAccelerateEndpoint states that This option cannot be used at the same time as UseDualstackEndpoint.

However, in the Requirements for using Transfer Acceleration section from the official document of AWS, it is stated that we can use dualstack endpoints in conjunction with the accelerate endpoint.

One of which must be incorrect. In my experiment we can actually use the accelerate endpoint and the dualstack endpoint at the same time.

Links

aws-sdk-net/sdk/src/Services/S3/Custom/AmazonS3Config.cs

Line 84 in f99aaf0

/// This option cannot be used at the same time as UseDualstackEndpoint.

https://docs.aws.amazon.com/AmazonS3/latest/userguide/transfer-acceleration.html#transfer-acceleration-requirements

[ashishdhingra]

Per S3 documentation at:

• Using Amazon S3 dual-stack endpoints, below are some notes:

  • You can use transfer acceleration with dual-stack endpoints. For more information, see [Getting started with Amazon S3 Transfer Acceleration ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/transfer-acceleration-getting-started.html).

  • When using the AWS CLI you currently cannot use transfer acceleration with dual-stack endpoints. However, support for the AWS CLI is coming soon. For more information, see [Enabling and using S3 Transfer Acceleration ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/transfer-acceleration.html#transfer-acceleration-requirements).

• Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration, To access the bucket that is enabled for Transfer Acceleration, you must use the endpoint bucket-name.s3-accelerate.amazonaws.com. Or, use the dual-stack endpoint bucket-name.s3-accelerate.dualstack.amazonaws.com to connect to the enabled bucket over IPv6. You can continue to use the regular endpoints for standard data transfer.

AWS SDK for .NET S3 code is handcrafted. I could not see any validation that limits use of both UseDualstackEndpoint and UseAccelerateEndpoint at the same time. In the generated AmazonS3EndpointResolver.MapEndpointsParameters(), it's using these values from AmazonS3Config if set. Perhaps the documentation issue!

@congthanhnguyenOL Could you please share the sample code for reproduction which demonstrates that you are able to use the accelerate endpoint and the dualstack endpoint at the same time.

Thanks,
Ashish

[congthanhnguyenOL]

Hi @ashishdhingra

The following code executed successfully.

using Amazon.S3;
using Amazon.S3.Model;

var config = new AmazonS3Config
{
    UseAccelerateEndpoint = true,
    UseDualstackEndpoint = true,
};
var s3 = new AmazonS3Client("CENSORED", "CENSORED", config);
var httpClient = new HttpClient();

var uploadUrl = s3.GetPreSignedURL(new GetPreSignedUrlRequest
{
    BucketName = "CENSORED",
    Key = "someobject.txt",
    Expires = DateTime.UtcNow.AddMinutes(5),
    Protocol = Protocol.HTTPS,
    Verb = HttpVerb.PUT,
});

var uploadResponse = await httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Put, uploadUrl)
{
    Content = new StringContent("Hello world!")
});

uploadResponse.EnsureSuccessStatusCode();

As can be seen below, the object appears on the console afterward with the expected content, demonstrating that the presigned URL worked.

1. Object appears on the console

2. Object has the expected content

Thanks.