Table of Contents

Class AWSConfigsS3

Namespace
Amazon
Assembly
AWSSDK.S3.dll

Configuration for the S3 section of AWS configuration. Changes to some settings may not take effect until a new client is constructed.

Example section:

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK"/>
</configSections>
<aws>
  <s3 useSignatureVersion4="true" />
</aws>
public static class AWSConfigsS3
Inheritance
AWSConfigsS3
Inherited Members

Fields

S3UseSignatureVersion4Key

Key for the S3UseSignatureVersion4Key property. UseSignatureVersion4

public const string S3UseSignatureVersion4Key = "AWS.S3.UseSignatureVersion4"

Field Value

string

Properties

DisableMD5Stream

WARNING: Setting DisableMD5Stream to true disables the MD5 data integrity check on upload requests.

When true, MD5Stream will not be used in upload requests. This may increase upload performance under high CPU loads. The default value is false. Set this value to true to disable MD5Stream use in all S3 upload requests or override this value per request by setting the DisableMD5Stream property on PutObjectRequest, UploadPartRequest, or TransferUtilityUploadRequest.

MD5Stream, SigV4 payload signing, and HTTPS each provide some data integrity verification. If DisableMD5Stream is true and DisablePayloadSigning is true, then the possibility of data corruption is completely dependant on HTTPS being the only remaining source of data integrity verification.

public static bool DisableMD5Stream { get; set; }

Property Value

bool

EnableUnicodeEncodingForObjectMetadata

Escape and unescape S3 metadata for S3 Put/Get object requests. Escape only escapes non-ascii values in metadata Any "%" values in metadata could interfere with this option. Default value is false.

public static bool EnableUnicodeEncodingForObjectMetadata { get; set; }

Property Value

bool

UseSignatureVersion4

Configures if the S3 client should use Signature Version 4 signing with requests. By default, this setting is set to true which will use Signature Version 4 for all requests except presigned URL requests when the region is set to us-east-1. When UseSignatureVersion4 is explicitly set to true by directly setting this property or directly setting this property through configuration, Signature Version 4 will be used for all requests when able to do so. When this setting is false, Signature Version 2 will be used. Note that when the setting is false, Signature Version 4 may still be used by default in some cases or with some regions.

public static bool UseSignatureVersion4 { get; set; }

Property Value

bool