AWS SDK Version 4 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Configuration for accessing Amazon S3 service

Inheritance Hierarchy

System.Object
  Amazon.S3.AmazonS3DefaultConfiguration

Namespace: Amazon.S3
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

C# 
public static class AmazonS3DefaultConfiguration

The AmazonS3DefaultConfiguration type exposes the following members

Properties

NameTypeDescription
Public Property Static Property Auto Amazon.Runtime.IDefaultConfiguration

The AUTO mode is an experimental mode that builds on the standard mode. The SDK will attempt to discover the execution environment to determine the appropriate settings automatically.

Note that the auto detection is heuristics-based and does not guarantee 100% accuracy. STANDARD mode will be used if the execution environment cannot be determined. The auto detection might query EC2 Instance Metadata service, which might introduce latency. Therefore we recommend choosing an explicit defaults_mode instead if startup latency is critical to your application
Public Property Static Property CrossRegion Amazon.Runtime.IDefaultConfiguration

The CROSS_REGION mode builds on the standard mode and includes optimization tailored for applications which call AWS services in a different region

Note that the default values vended from this mode might change as best practices may evolve. As a result, it is encouraged to perform tests when upgrading the SDK
Public Property Static Property InRegion Amazon.Runtime.IDefaultConfiguration

The IN_REGION mode builds on the standard mode and includes optimization tailored for applications which call AWS services from within the same AWS region

Note that the default values vended from this mode might change as best practices may evolve. As a result, it is encouraged to perform tests when upgrading the SDK
Public Property Static Property Mobile Amazon.Runtime.IDefaultConfiguration

The MOBILE mode builds on the standard mode and includes optimization tailored for mobile applications

Note that the default values vended from this mode might change as best practices may evolve. As a result, it is encouraged to perform tests when upgrading the SDK
Public Property Static Property Standard Amazon.Runtime.IDefaultConfiguration

The STANDARD mode provides the latest recommended default values that should be safe to run in most scenarios

Note that the default values vended from this mode might change as best practices may evolve. As a result, it is encouraged to perform tests when upgrading the SDK

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.7.2 or higher.

NameDescription
Public Method Static Method GetAllConfigurations()

Collection of all Amazon.Runtime.DefaultConfigurations supported by S3

Code Examples

Explore code examples in the AWS SDK Code Examples Code Library.

Api

Scenarios

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer