` 元素。
例如，对于 Amazon S3，您可以在项目 `.csproj` 文件中添加以下几行。
**在 Linux 和 macOS 上：**
```
```
**在 Windows 上：**
```
```
1. 保存项目的 `.csproj` 文件。
------
#### [ Windows with Visual Studio and .NET Core ]
1. 在 Visual Studio 中，加载您的项目并打开**项目**、**添加引用**。
1. 选择对话框底部的**浏览**按钮。导航到项目的文件夹和将所需的 DLL 文件复制到的子文件夹（例如 `AwsAssemblies`）。
1. 选择所有 DLL 文件，选择**添加**，然后选择**确定**。
1. 保存您的项目。
------
# 凭证和配置文件解析
适用于 .NET 的 AWS SDK按特定顺序搜索凭证，并对当前应用程序使用第一个可用集。
**凭证搜索顺序**
1. 在 AWS 服务客户端上显式设置的凭证，如[访问应用程序中的凭证和配置文件](creds-locate.md)中所述。
**注意**
该主题之所以出现在[特殊注意事项](special-considerations.md)部分中，是因为它不是指定凭证的首选方法。
1. 一个凭证配置文件，其名称由 [AWSConfigs.AWSProfileName](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html#properties) 中的值指定。
1. 名称由 `AWS_PROFILE` 环境变量指定的凭证配置文件。
1. `[default]` 凭证配置文件。
1. 根据 `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY` 和 `AWS_SESSION_TOKEN` 环境变量 (如果这些变量都不为空) 创建的 [SessionAWSCredentials](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TSessionAWSCredentials.html)。
1. 根据 `AWS_ACCESS_KEY_ID` 和 `AWS_SECRET_ACCESS_KEY` 环境变量 (如果这两个变量不为空) 创建的 [BasicAWSCredentials](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TBasicAWSCredentials.html)。
1. [容器凭证提供程序](https://docs.aws.amazon.com/sdkref/latest/guide/feature-container-credentials.html)。
1. Amazon EC2 实例元数据。
如果您的应用程序在 Amazon EC2 实例上运行（例如在生产环境中），请使用 IAM 角色，如 [使用 IAM 角色授予访问权限](net-dg-hosm.md) 中所述。否则，例如在预发布测试中，将凭证存储在服务器上使用 AWS 凭证文件格式的文件中（Web 应用程序有权访问此文件）。
## 配置文件解析
凭证有两种不同的存储机制，请务必了解如何配置适用于 .NET 的 AWS SDK以使用它们。[AWSConfigs.AWSProfilesLocation](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) 属性控制适用于 .NET 的 AWS SDK如何查找凭证配置文件。
****
| AWSProfilesLocation | 配置文件解析行为 |
| --- | --- |
| null (未设置) 或空 | 如果平台支持，请搜索 SDK Store，然后在[默认位置](creds-file.md)搜索共享 AWS 凭证文件。如果配置文件不在上述任何一个位置，请搜索 `~/.aws/config`（Linux 或 macOS）或 `%USERPROFILE%\.aws\config`（Windows）。 |
| AWS 凭证文件格式的文件的路径 | *仅* 在指定文件中搜索具有指定名称的配置文件。 |
## 使用联合用户账户凭证
对于采用适用于 .NET 的 AWS SDK（[AWSSDK.Core](https://www.nuget.org/packages/AWSSDK.Core/) 版本 3.1.6.0 和更高版本）的应用程序，可以通过 Active Directory Federation Services（AD FS）使用联合用户账户来利用安全断言标记语言（SAML）访问 AWS 服务。
联合访问支持意味着用户可使用您的 Active Directory 进行身份验证。系统将自动为用户授予临时凭证。当您的应用程序调用 AWS 服务时，将使用这些临时凭证 (有效期为 1 小时)。开发工具包将管理临时凭证。对于已加入域的用户账户，如果您的应用程序发出调用但凭证已过期，则将自动重新验证用户的身份并授予全新凭证。(对于未加入域的账户，在重新进行身份验证之前，系统将提示用户输入凭证。)
要在 .NET 应用程序中使用此支持，您必须先使用 PowerShell cmdlet 设置角色配置文件。要了解具体信息，请参阅[AWS Tools for Windows PowerShell文档](https://docs.aws.amazon.com/powershell/latest/userguide/saml-pst.html)。
设置角色配置文件后，请在应用程序中引用该配置文件。有多种方法可以做到这一点，其中一种是像处理其他凭证配置文件一样使用 [AWSConfigs.AWSProfileName](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) 属性。
*AWS Security Token Service* 程序集（[awssdk.securityToken](https://www.nuget.org/packages/AWSSDK.SecurityToken/)）提供 SAML 支持以获取 AWS 凭证。要使用联合用户账户凭证，请确保您的应用程序可以使用此程序集。
## 指定角色或临时凭证
对于 Amazon EC2 实例上运行的应用程序，管理凭证最安全的方式是使用 IAM 角色，如[使用 IAM 角色授予访问权限](net-dg-hosm.md)中所述。
对于软件可执行文件对组织外部用户可用的应用程序情景，建议您将软件设计为使用*临时安全凭证*。除了提供对 AWS 资源的有限访问之外，让这些凭证在指定时段后过期也会有好处。有关临时安全凭证的更多信息，请参阅：
+ [临时安全凭证](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)
+ [Amazon Cognito 身份池](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html)
## 使用代理凭证
如果您的软件通过代理与 AWS 进行通信，则可使用服务的 `Config` 类的 `ProxyCredentials` 属性来为代理指定凭证。服务的 `Config` 类通常是该服务主命名空间的一部分。示例包括以下内容：[Amazon.CloudDirectory](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudDirectory/NCloudDirectory.html) 命名空间中的 [AmazonCloudDirectoryConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudDirectory/TCloudDirectoryConfig.html) 和 [Amazon.GameLift](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/GameLift/NGameLift.html) 命名空间中的 [AmazonGameLiftConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/GameLift/TGameLiftConfig.html)。
例如，对于 [Amazon S3](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html)，您可以使用如下所示的代码，其中 `SecurelyStoredUserName` 和 `SecurelyStoredPassword` 为 [NetworkCredential](https://learn.microsoft.com/en-us/dotnet/api/system.net.networkcredential) 对象中指定的代理用户名和密码。
```
AmazonS3Config config = new AmazonS3Config();
config.ProxyCredentials = new NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword);
```
**注意**
早期版本的开发工具包使用的是 `ProxyUsername` 和 `ProxyPassword`，但这两个属性已被弃用。
# 有关用户和角色的其它信息
要在 AWS 上进行 .NET 开发或在 AWS 上运行 .NET 应用程序，您需要具备适合这些任务的用户、权限集和服务角色的组合。
您创建的特定用户、权限集和服务角色以及使用它们的方式，将取决于您应用程序的要求。下面的一些附加信息介绍了可能使用它们的原因以及如何创建它们。
## 用户和权限集
尽管可以使用具有长期凭证的 IAM 用户账户来访问 AWS 服务，但这已不再是最佳实践，应予以避免。即使在开发过程中，最佳做法也是在 AWS IAM Identity Center 中创建用户和权限集，并使用身份源提供的临时凭证。
对于开发，您可以使用自己创建的或在[配置 SDK 身份验证](creds-idc.md)中提供的用户。如果您拥有适当的 AWS 管理控制台 权限，还可以为该用户创建具有最低权限的不同权限集，或者创建专用于开发项目的新用户，同时提供具有最低权限的权限集。您选择的行动方案（如果有）取决于您的情况。
有关这些用户和权限集以及如何创建它们的更多信息，请参阅《AWS 开发工具包和工具参考指南》**中的[身份验证和访问](https://docs.aws.amazon.com/sdkref/latest/guide/access.html)以及《AWS IAM Identity Center 用户指南》**中的[入门](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)。
## 服务角色
您可以设置 AWS 服务角色来代表用户访问 AWS 服务。如果有多人远程运行您的应用程序，则这种访问方式是合适的；例如，在您为此目的创建的 Amazon EC2 实例上。
创建服务角色的过程因情况而异，但基本上如下所示。
1. 登录 AWS 管理控制台，然后通过以下网址打开 IAM 控制台：[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。
1. 选择 **角色**，然后选择 **创建角色**。
1. 选择 **AWS 服务**，找到并选择 **EC2**（例如），然后选择 **EC2** 使用案例（例如）。
1. 选择**下一步: 权限**，然后为您的应用程序将使用的 AWS 服务选择[适当的策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
**警告**
***请勿***选择 **AdministratorAccess** 策略，因为该策略允许对您账户中的几乎所有内容具有读写权限。
1. 选择**下一步: 标签**，然后输入所需的任何标签。
您可以在 [IAM 用户指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/)中的[使用 AWS 资源标签控制访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)中找到标签相关的信息。
1. 选择**下一步: 查看**，并提供**角色名称**和**角色描述**。然后选择**创建角色**。
在 [IAM 用户指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/)中的[身份（用户、用户组和角色）](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)中，您可以找到有关 IAM 角色的高级信息。在 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)主题中查找有关角色的详细信息。
**有关角色的其它信息**
+ 对于 Amazon Elastic Container Service (Amazon ECS)，使用[适用于任务的 IAM 角色](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html)。
+ 对于在 Amazon EC2 实例上运行的应用程序，使用 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。
# 适用于 .NET 的 AWS SDK项目的高级配置
本部分中的主题包含有关您可能感兴趣的其它配置任务和方法的信息。
**Topics**
+ [AWSSDK. 扩展。 NETCore.Setup 和 IConfiguration](net-dg-config-netcore.md)
+ [
# 配置其他应用程序参数
](net-dg-config-other.md)
+ [
# 适用于 .NET 的 AWS SDK的配置文件参考
](net-dg-config-ref.md)
# 使用 AWSSDK .Extions。 NETCore.Setup 和界面 IConfiguration
（本主题之前的标题是 “ 适用于 .NET 的 AWS SDK 使用.NET 核心配置”）
.NET Core 中最大的改变之一是删除了以前在 .NET Framework 和 ASP.NET 应用程序中使用的 `ConfigurationManager` 以及标准 `app.config` 和 `web.config` 文件。
.NET Core 中的配置基于配置提供商建立的键/值对。配置提供商将配置数据从各种配置源读取为键/值对，包括命令行参数、目录文件、环境变量和设置文件。
**注意**
有关更多信息，请参阅 [ASP.NET Core 中的配置](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration)。
为了便于在.NET Core 中 适用于 .NET 的 AWS SDK 使用，你可以使用.E [AWSSDKxtensions。 NETCore.安装](https://www.nuget.org/packages/AWSSDK.Extensions.NETCore.Setup/) NuGet 包。与许多.NET Core 库一样，它向`IConfiguration`接口添加了扩展方法，以实现无缝 AWS 配置。
该软件包的源代码 GitHub 位于[https://github.com/aws/aws-sdk-net/tree/aws-sdk-net-v3.7/extensions/src/AWSSDK.Extensions.NETCore.Setup](https://github.com/aws/aws-sdk-net/tree/aws-sdk-net-v3.7/extensions/src/AWSSDK.Extensions.NETCore.Setup)。
## 使用 AWSSDK .Extions。 NETCore.Setup
假设你创建了一个 ASP.NET Core Model-View-Controller (MVC) 应用程序，可以使用 Visual Studio 中的 **ASP.NET Core Web 应用程序**模板或在.NET Core CLI `dotnet new mvc ...` 中运行来完成。创建此类应用程序时，`Startup.cs` 的构造函数通过从配置提供商读取各种输入源来处理配置，例如读取 `appsettings.json`。
```
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
```
要使用`Configuration`对象获取*AWS*选项，请先添加`AWSSDK.Extensions.NETCore.Setup` NuGet 软件包。然后，将选项添加到下面所述的配置文件中。
请注意，添加到您项目中的其中一个文件是 `appsettings.Development.json`。这就代表 `EnvironmentName` 设置为 **Development**。在开发过程中，将配置放入此文件中，该文件只能在本地测试期间读取。当您部署已`EnvironmentName`设置为**生产**的 Amazon EC2 实例时，该文件将被忽略，并回退到为 Amazon EC2 实例配置的 IAM 证书和区域。 适用于 .NET 的 AWS SDK
以下配置设置显示您可以添加到您项目的 `appsettings.Development.json` 文件中用于提供 AWS 设置的值的示例。
```
{
"AWS": {
"Profile": "local-test-profile",
"Region": "us-west-2"
},
"SupportEmail": "TechSupport@example.com"
}
```
要访问 *CSHTML* 文件中的设置，请使用 `Configuration` 指令：
```
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration
Contact
Support: @Configuration["SupportEmail"]
```
要从代码访问文件中设置的 AWS 选项，请调用添加到的`GetAWSOptions`扩展方法`IConfiguration`。
要从这些选项构造服务客户端，请调用 `CreateServiceClient`。以下示例代码说明了如何创建 Amazon S3 服务客户端。（请务必将 [AWSSDK.S3](https://www.nuget.org/packages/AWSSDK.S3) NuGet 包添加到您的项目中。）
```
var options = Configuration.GetAWSOptions();
IAmazonS3 client = options.CreateServiceClient();
```
您还可以使用 `appsettings.Development.json` 文件中的多个条目创建具有不兼容设置的多个服务客户端，如以下示例所示，其中 `service1` 的配置包括 `us-west-2` 区域，`service2` 的配置包括特殊端点 *URL*。
```
{
"service1": {
"Profile": "default",
"Region": "us-west-2"
},
"service2": {
"Profile": "default",
"ServiceURL": "URL"
}
}
```
然后，您可以使用 JSON 文件中的条目获取特定服务的选项。例如，要获取 `service1` 的设置，请使用以下项目。
```
var options = Configuration.GetAWSOptions("service1");
```
### appsettings 文件中允许的值
以下应用程序配置值可以在 `appsettings.Development.json` 文件中设置。字段名必须使用所示的大小写。有关这些设置的详细信息，请参阅 `[AWS.Runtime.ClientConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html)` 类。
+ Region
+ 配置文件
+ ProfilesLocation
+ SignatureVersion
+ RegionEndpoint
+ UseHttp
+ ServiceURL
+ AuthenticationRegion
+ AuthenticationServiceName
+ MaxErrorRetry
+ LogResponse
+ BufferSize
+ ProgressUpdateInterval
+ ResignRetries
+ AllowAutoRedirect
+ LogMetrics
+ DisableLogging
+ UseDualstackEndpoint
## ASP.NET Core 依赖关系注入
*AWSSDK.Extensions NETCore.Setup* NuGet 包还与 ASP.NET Core 中的新依赖注入系统集成。应用程序的 `Startup` 类中的 `ConfigureServices` 方法是添加 MVC 服务的位置。如果应用程序正在使用实体框架，则这也是进行初始化的位置。
```
public void ConfigureServices(IServiceCollection services)
{
// Add framework services.
services.AddMvc();
}
```
**注意**
有关 .NET Core 中依赖关系注入的背景信息在 [.NET Core 文档网站](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection)上提供。
该`AWSSDK.Extensions.NETCore.Setup` NuGet 软件包添加了新的扩展方法`IServiceCollection`，您可以使用这些方法向依赖注入中添加 AWS 服务。以下代码向您展示了如何添加从中读取的 AWS 选项，`IConfiguration`以便将 Amazon S3 和 DynamoDB 添加到服务列表中。（请务必将 [AWSSDK.S3 和AWSSDK.](https://www.nuget.org/packages/AWSSDK.S3) [Dynamo DBv2](https://www.nuget.org/packages/AWSSDK.DynamoDBv2) NuGet 包添加到您的项目中。）
```
public void ConfigureServices(IServiceCollection services)
{
// Add framework services.
services.AddMvc();
services.AddDefaultAWSOptions(Configuration.GetAWSOptions());
services.AddAWSService();
services.AddAWSService();
}
```
现在，如果您的 MVC 控制器使用 `IAmazonS3` 或 `IAmazonDynamoDB` 作为其构造函数中的参数，则依赖关系注入系统会传入这些服务。
```
public class HomeController : Controller
{
IAmazonS3 S3Client { get; set; }
public HomeController(IAmazonS3 s3Client)
{
this.S3Client = s3Client;
}
...
}
```
# 配置其他应用程序参数
**注意**
本主题中的信息特定于基于 .NET Framework 的项目。默认情况下，`App.config` 和 `Web.config` 文件不存在于基于 .NET Core 的项目中。
## 打开查看 .NET Framework 内容
可配置多种应用程序参数：
+ `AWSLogging`
+ `AWSLogMetrics`
+ `AWSRegion`
+ `AWSResponseLogging`
+ `AWS.DynamoDBContext.TableNamePrefix`
+ `AWS.S3.UseSignatureVersion4`
+ `AWSEndpointDefinition`
+ [AWS 服务生成的终端节点](#config-setting-service-generated-awsendpointdefinition)
这些参数可以在应用程序的 `App.config` 或 `Web.config` 文件中配置。尽管您也可以使用 适用于 .NET 的 AWS SDK API 对其进行配置，但我们建议您使用应用程序的`.config`文件。此处介绍了这两种方法。
有关本主题后文中所述的使用 `` 元素的更多信息，请参阅[适用于 .NET 的 AWS SDK配置文件参考](net-dg-config-ref.md)。
### AWSLogging
配置开发工具包应如何记录事件 (如果记录)。例如，建议的方法是使用 `` 元素，该元素是 `` 元素的子元素：
```
```
或者：
```
```
可能的值包括：
** `None` **
禁用 事件日志记录。这是默认值。
** `log4net` **
使用 log4net 记录。
** `SystemDiagnostics` **
使用 `System.Diagnostics` 类记录。
您可以为 `logTo` 属性设置多个值，以逗号分隔。以下示例在 `.config` 文件中设置 `log4net` 和 `System.Diagnostics` 日志记录：
```
```
或者：
```
```
或者，使用 适用于 .NET 的 AWS SDK API 合并[LoggingOptions](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TLoggingOptions.html)枚举值并设置 [AWSConfigs.Logging](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) 属性：
```
AWSConfigs.Logging = LoggingOptions.Log4Net | LoggingOptions.SystemDiagnostics;
```
对此设置的更改仅对新的 AWS 客户端实例生效。
### AWSLog指标
指定开发工具包是否应记录性能指标。要在 `.config` 文件中设置指标日志记录配置，请在 `` 元素中设置 `logMetrics` 属性值，该元素是 `` 元素的子元素：
```
```
此外，在 `` 部分中设置 `AWSLogMetrics` 关键字：
```
```
或者，要使用 适用于 .NET 的 AWS SDK API 设置指标日志记录，请设置[AWSConfigs。 LogMetrics](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)财产:
```
AWSConfigs.LogMetrics = true;
```
对于所有客户端/配置，此设置用于配置默认 `LogMetrics` 属性。对此设置的更改仅对新的 AWS 客户端实例生效。
### AWSRegion
为未明确指定 AWS 区域的客户端配置默认区域。要在 `.config` 文件中设置区域，建议的方法是在 `aws` 元素中设置 `region` 属性值：
```
```
此外，在 `` 部分中设置 *AWSRegion* 关键字：
```
```
或者，要使用 适用于 .NET 的 AWS SDK API 设置区域，请设置[AWSConfigs。 AWSRegion](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)财产:
```
AWSConfigs.AWSRegion = "us-west-2";
```
有关为特定区域创建 AWS 客户端的更多信息，请参阅[AWS 区域选择](net-dg-region-selection.md)。对此设置的更改仅对新的 AWS 客户端实例生效。
### AWSResponse记录日志
配置开发工具包在什么情况下记录服务响应。可能的值包括：
** `Never` **
从不记录服务响应。这是默认值。
** `Always` **
始终记录服务响应。
** `OnError` **
仅在出错时记录服务响应。
要在 `.config` 文件中设置服务日志记录配置，推荐的方法是在 `` 元素中设置 `logResponses` 属性值，该元素是 `` 元素的子元素：
```
```
或者，在以下``部分中*AWSResponse设置 Logging* 密钥：
```
```
或者，要使用 适用于 .NET 的 AWS SDK API 设置服务日志记录，请设置[AWSConfigs。 ResponseLogging](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)将属性设置为[ResponseLoggingOption](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TResponseLoggingOption.html)枚举的其中一个值：
```
AWSConfigs.ResponseLogging = ResponseLoggingOption.OnError;
```
对此设置的更改会立即生效。
### `AWS.DynamoDBContext.TableNamePrefix`
配置 `TableNamePrefix` 将使用的默认 `DynamoDBContext` (在未手动配置的情况下)。
要在 `.config` 文件中设置表名前缀，建议的方法是在 `` 元素中设置 `tableNamePrefix` 属性值，该元素是 `` 元素 (这又是 `` 的子元素) 的子元素：
```
```
此外，在 `` 部分中设置 `AWS.DynamoDBContext.TableNamePrefix` 关键字：
```
```
或者，要使用 适用于 .NET 的 AWS SDK API 设置表名前缀，请设置 [AWSConfigs.Dynamo 属性 DBContext TableNamePrefix](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)：
```
AWSConfigs.DynamoDBContextTableNamePrefix = "Test-";
```
对此设置的更改仅在新构建的 `DynamoDBContextConfig` 和 `DynamoDBContext` 实例中生效。
### `AWS.S3.UseSignatureVersion4`
配置 Amazon S3 客户端是否应使用签名版本 4 对请求签名。
要在 `.config` 文件中为 Amazon S3 设置签名版本 4 的签名，推荐的方法是在 `` 元素中设置 `useSignatureVersion4` 属性，该元素是 `` 元素的子元素：
```
```
此外，在 `` 部分中将 `AWS.S3.UseSignatureVersion4` 密钥设置为 `true`：
```
```
或者，要使用 适用于 .NET 的 AWS SDK API 设置签名版本 4 签名，请将 [AWSConfigs.S3 UseSignatureVersion 4](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) 属性设置为：`true`
```
AWSConfigs.S3UseSignatureVersion4 = true;
```
默认情况下，此设置是 `false`，但在某些情况下或者在某些区域中，默认会使用签名版本 4。当设置为 `true` 时，签名版本 4 将用于所有请求。对此设置的更改仅对新 Amazon S3 客户端实例生效。
### AWSEndpoint定义
配置开发工具包是否应使用自定义配置文件，该文件定义区域和终端节点。
要在 `.config` 文件中设置终端节点定义文件，建议在 `` 元素中设置 `endpointDefinition` 属性值。
```
```
或者，你可以在以下``部分中设置*AWSEndpoint定义*密钥：
```
```
或者，要使用 适用于 .NET 的 AWS SDK API 设置端点定义文件，请设置[AWSConfigs。 EndpointDefinition](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)财产:
```
AWSConfigs.EndpointDefinition = @"c:\config\endpoints.json";
```
如果没有提供文件名，则不使用自定义配置文件。对此设置的更改仅对新的 AWS 客户端实例生效。endpoint.json 文件可从[https://github.com/aws/aws-sdk-net/blob/aws-sdk-net-v3.7/sdk/src/Core/endpoints.json](https://github.com/aws/aws-sdk-net/blob/aws-sdk-net-v3.7/sdk/src/Core/endpoints.json)中获得。
### AWS 服务生成的终端节点
有些 AWS 服务会生成自己的终端节点，而不是使用区域终端节点。这些服务的客户端使用特定于该服务的服务 URL 以及您的资源。这些服务的两个例子是 Amazon CloudSearch 和 AWS IoT。以下示例演示如何获取这些服务的终端节点。
#### Amazon CloudSearch 终端节点示例
亚马逊 CloudSearch 客户端用于访问亚马逊 CloudSearch 配置服务。您可以使用 Amazon CloudSearch 配置服务创建、配置和管理搜索域。要创建搜索域，请创建一个[CreateDomainRequest](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/TCreateDomainRequest.html)对象并提供该`DomainName`属性。使用请求[AmazonCloudSearchClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/TCloudSearchClient.html)对象创建对象。调用 [CreateDomain](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/MCloudSearchCreateDomainCreateDomainRequest.html) 方法。调用返回的[CreateDomainResponse](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/TCreateDomainResponse.html)对象包含一个同时具有`DocService`和`SearchService`端点的`DomainStatus`属性。创建一个[AmazonCloudSearchDomainConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearchDomain/TCloudSearchDomainConfig.html)对象并使用它来初始化该[AmazonCloudSearchDomainClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearchDomain/TCloudSearchDomainClient.html)类的`SearchService`实例`DocService`和实例。
```
// Create domain and retrieve DocService and SearchService endpoints
DomainStatus domainStatus;
using (var searchClient = new AmazonCloudSearchClient())
{
var request = new CreateDomainRequest
{
DomainName = "testdomain"
};
domainStatus = searchClient.CreateDomain(request).DomainStatus;
Console.WriteLine(domainStatus.DomainName + " created");
}
// Test the DocService endpoint
var docServiceConfig = new AmazonCloudSearchDomainConfig
{
ServiceURL = "https://" + domainStatus.DocService.Endpoint
};
using (var domainDocService = new AmazonCloudSearchDomainClient(docServiceConfig))
{
Console.WriteLine("Amazon CloudSearchDomain DocService client instantiated using the DocService endpoint");
Console.WriteLine("DocService endpoint = " + domainStatus.DocService.Endpoint);
using (var docStream = new FileStream(@"C:\doc_source\XMLFile4.xml", FileMode.Open))
{
var upload = new UploadDocumentsRequest
{
ContentType = ContentType.ApplicationXml,
Documents = docStream
};
domainDocService.UploadDocuments(upload);
}
}
// Test the SearchService endpoint
var searchServiceConfig = new AmazonCloudSearchDomainConfig
{
ServiceURL = "https://" + domainStatus.SearchService.Endpoint
};
using (var domainSearchService = new AmazonCloudSearchDomainClient(searchServiceConfig))
{
Console.WriteLine("Amazon CloudSearchDomain SearchService client instantiated using the SearchService endpoint");
Console.WriteLine("SearchService endpoint = " + domainStatus.SearchService.Endpoint);
var searchReq = new SearchRequest
{
Query = "Gambardella",
Sort = "_score desc",
QueryParser = QueryParser.Simple
};
var searchResp = domainSearchService.Search(searchReq);
}
```
#### AWS IoT 端点示例
要获取的终端节点 AWS IoT，请创建一个[AmazonIoTClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/TIoTClient.html)对象并调用[DescribeEndPoint](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/MIoTDescribeEndpointDescribeEndpointRequest.html)方法。返回的[DescribeEndPointResponse](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/TDescribeEndpointResponse.html)对象包含`EndpointAddress`。创建[AmazonIotDataConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IotData/TIotDataConfig.html)对象，设置`ServiceURL`属性，然后使用该对象实例化该类。[AmazonIotDataClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IotData/TIotDataClient.html)
```
string iotEndpointAddress;
using (var iotClient = new AmazonIoTClient())
{
var endPointResponse = iotClient.DescribeEndpoint();
iotEndpointAddress = endPointResponse.EndpointAddress;
}
var ioTdocServiceConfig = new AmazonIotDataConfig
{
ServiceURL = "https://" + iotEndpointAddress
};
using (var dataClient = new AmazonIotDataClient(ioTdocServiceConfig))
{
Console.WriteLine("AWS IoTData client instantiated using the endpoint from the IotClient");
}
```
# 适用于 .NET 的 AWS SDK的配置文件参考
**注意**
本主题中的信息特定于基于 .NET Framework 的项目。默认情况下，`App.config` 和 `Web.config` 文件不存在于基于 .NET Core 的项目中。
## 打开查看 .NET Framework 内容
您可以使用 .NET 项目的 `App.config` 或 `Web.config` 文件指定 AWS 设置（如 AWS 凭证、日志记录选项、AWS 服务端点和 AWS 区域）以及某些 AWS 服务设置（例如 Amazon DynamoDB、Amazon EC2 和 Amazon S3）。以下信息介绍了如何正确设置 `App.config` 或 `Web.config` 文件的格式，以指定这些设置类型。
**注意**
虽然您可以继续在 `App.config` 或 `Web.config` 文件中使用 `` 元素来指定 AWS 设置，但我们建议您使用 `` 和 `` 元素，如本主题后面所述。有关 `` 元素的更多信息，请参阅[配置``应用程序](net-dg-config.md)中的 适用于 .NET 的 AWS SDK 元素示例。
**注意**
虽然您可以继续使用代码文件中的以下 [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) 类属性来指定 AWS 设置，但以下属性已被弃用，并且在将来版本中不受支持：
`DynamoDBContextTableNamePrefix`
`EC2UseSignatureVersion4`
`LoggingOptions`
`LogMetrics`
`ResponseLoggingOption`
`S3UseSignatureVersion4`
通常，我们建议不要使用代码文件中的 `AWSConfigs` 类属性来指定 AWS 设置，而应使用 `` 或 `Web.config` 文件中的 `` 和 `App.config` 元素来指定 AWS 设置，如本主题后面所述。有关上述属性的更多信息，请参阅[配置适用于 .NET 的 AWS SDK应用程序](net-dg-config.md)中的 `AWSConfigs` 代码示例。
**Topics**
+ [
### 声明 AWS 设置部分
](#net-dg-config-ref-declaring)
+ [
### 允许的元素
](#net-dg-config-ref-elements)
+ [
### 元素参考
](#net-dg-config-ref-elements-ref)
### 声明 AWS 设置部分
您可以通过 `` 元素指定 `App.config` 或 `Web.config` 文件中的 AWS 设置。在开始使用 `` 元素之前，您必须先创建一个 `` 元素 (`` 元素的子元素) 并将其 `name` 属性和 `aws` 属性分别设置为 `type` 和 `Amazon.AWSSection, AWSSDK.Core` (如以下示例所示)：
```
...
...
```
Visual Studio 编辑器提供针对 `` 元素或其子元素的自动代码完成 (IntelliSense)。
调用 `` 方法可帮助您创建 `Amazon.AWSConfigs.GenerateConfigTemplate` 元素格式正确的版本。这将以美观打印字符串形式输出 `` 元素的规范版本，可调整该字符串以满足您的需求。以下部分介绍 `` 元素的属性和子元素。
### 允许的元素
以下是 AWS 设置部分中允许的元素之间的逻辑关系列表。要生成此列表的最新版本，您可以调用 `Amazon.AWSConfigs.GenerateConfigTemplate` 方法，这将以字符串形式输出 `` 元素的规范版本，可调整该字符串以满足您的需求。
```
```
### 元素参考
下面是 AWS 设置部分允许的元素列表。对于每个元素，将列出其允许的属性和父-子元素。
**Topics**
+ [
#### 别名
](#net-dg-config-ref-elements-alias)
+ [
#### `aws`
](#net-dg-config-ref-elements-aws)
+ [
#### dynamoDB
](#net-dg-config-ref-elements-dynamodb)
+ [
#### dynamoDBContext
](#net-dg-config-ref-elements-ddbcontext)
+ [
#### ec2
](#net-dg-config-ref-elements-ec2)
+ [
#### logging
](#net-dg-config-ref-elements-logging)
+ [
#### 映射
](#net-dg-config-ref-elements-map)
+ [
#### property
](#net-dg-config-ref-elements-property)
+ [
#### proxy
](#net-dg-config-ref-elements-proxy)
+ [
#### S3
](#net-dg-config-ref-elements-s3)
#### 别名
`` 元素表示集合中的一个项，该集合包含一个或多个源表到目标表的映射，用于指定与为某一类型配置的表不同的表。此元素将从`Amazon.Util.TableAlias`中的 `Amazon.AWSConfigs.DynamoDBConfig.Context.TableAliases` 属性映射到 适用于 .NET 的 AWS SDK 类的实例。在应用表名称前缀之前，将执行重新映射。
此元素可以包含以下属性：
** `fromTable` **
源表到目标表的映射的源表部分。此属性映射到`Amazon.Util.TableAlias.FromTable`中的 适用于 .NET 的 AWS SDK 属性。
** `toTable` **
源表到目标表的映射的目标表部分。此属性映射到`Amazon.Util.TableAlias.ToTable`中的 适用于 .NET 的 AWS SDK 属性。
`` 元素的父级为 `` 元素。
`` 元素不包含子元素。
以下是使用中的 `` 元素的示例：
```
```
#### `aws`
`` 元素表示 AWS 设置部分中的最顶层元素。此元素可以包含以下属性：
** `endpointDefinition` **
自定义配置文件的绝对路径，该文件定义要使用的 AWS 区域和端点。此属性映射到`Amazon.AWSConfigs.EndpointDefinition`中的 适用于 .NET 的 AWS SDK 属性。
** `profileName` **
存储的 AWS 凭证的配置文件名称，该凭证将用于进行服务调用。此属性映射到`Amazon.AWSConfigs.AWSProfileName`中的 适用于 .NET 的 AWS SDK 属性。
** `profilesLocation` **
与其它 AWS 开发工具包共享的凭证文件位置的绝对路径。默认情况下，凭证文件存储在当前用户主目录的 `.aws` 目录中。此属性映射到`Amazon.AWSConfigs.AWSProfilesLocation`中的 适用于 .NET 的 AWS SDK 属性。
** `region` **
没有明确指定区域的客户端的默认 AWS 区域 ID。此属性映射到`Amazon.AWSConfigs.AWSRegion`中的 适用于 .NET 的 AWS SDK 属性。
`` 元素没有父元素。
`` 元素可包含以下子元素：
+ ``
+ ``
+ ``
+ ``
+ ``
以下是使用中的 `` 元素的示例：
```
```
#### dynamoDB
`` 元素表示一组 Amazon DynamoDB 设置。此元素可以包含 *conversionSchema* 属性，该属性表示在 .NET 和 DynamoDB 对象之间进行转换所用的版本。允许的值包括 V1 和 V2。此属性映射到`Amazon.DynamoDBv2.DynamoDBEntryConversion`中的 适用于 .NET 的 AWS SDK 类。有关更多信息，请参阅 [DynamoDB 系列 - 转换架构](http://blogs.aws.amazon.com/net/post/Tx2TCOGWG7ARUH5/DynamoDB-Series-Conversion-Schemas)。
`` 元素的父级为 `` 元素。
`` 元素可以包含 `` 子元素。
以下是使用中的 `` 元素的示例：
```
```
#### dynamoDBContext
`` 元素表示一组 Amazon DynamoDB 上下文特定的设置。此元素可以包含 *tableNamePrefix* 属性，它表示 DynamoDB 上下文将使用的默认表名前缀 (如果未手动配置此前缀)。此属性从`Amazon.Util.DynamoDBContextConfig.TableNamePrefix`中的 `Amazon.AWSConfigs.DynamoDBConfig.Context.TableNamePrefix` 属性映射到 适用于 .NET 的 AWS SDK 属性。有关更多信息，请参阅 [DynamoDB 开发工具包的增强功能](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK)。
`` 元素的父级为 `` 元素。
`` 元素可包含以下子元素：
+ `` (一个或多个实例)
+ `