` con un atributo `Include` para cada ensamblado necesario.
En Amazon S3, por ejemplo, agregaríamos las siguientes líneas al archivo `.csproj` del proyecto.
**En Linux y macOS:**
```
```
**En Windows:**
```
```
1. Guarde el archivo `.csproj` del proyecto.
------
#### [ Windows with Visual Studio and .NET Core ]
1. En Visual Studio, cargue el proyecto y abra **Proyecto** > **Agregar referencia**.
1. Pulse el botón **Examinar** en la parte inferior del cuadro de diálogo. Navegue hasta la carpeta del proyecto y la subcarpeta en la que copió los archivos DLL necesarios (`AwsAssemblies`, por ejemplo).
1. Seleccione todos los archivos DLL y, luego, seleccione **Agregar** y **Aceptar**.
1. Guarde el proyecto.
------
# Resolución de credenciales y perfil
AWS SDK para .NET busca credenciales en un determinado orden y usa el primer conjunto disponible para la aplicación actual.
**Orden de búsqueda de credenciales**
1. Credenciales establecidas de forma explícita en el cliente de servicio de AWS, tal y como se describe en [Acceso a las credenciales y perfiles en una aplicación](creds-locate.md).
**nota**
Este tema está en la sección [Consideraciones especiales](special-considerations.md) porque no es el método preferido para especificar credenciales.
1. Un perfil de credenciales con el nombre especificado por un valor en [AWSConfigs.AWSProfileName](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html#properties).
1. Un perfil de credenciales con el nombre especificado por la variable de entorno `AWS_PROFILE`.
1. El perfil de credenciales `[default]`.
1. [SessionAWSCredentials](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TSessionAWSCredentials.html) creadas a partir de las variables de entorno `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` y `AWS_SESSION_TOKEN`, si no están todas vacías.
1. [BasicAWSCredentials](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TBasicAWSCredentials.html) creadas a partir de las variables de entorno `AWS_ACCESS_KEY_ID` y `AWS_SECRET_ACCESS_KEY`, si ambas no están vacías.
1. El [proveedor de credenciales de contenedor](https://docs.aws.amazon.com/sdkref/latest/guide/feature-container-credentials.html).
1. Metadatos de la instancia de Amazon EC2.
Si la aplicación se ejecuta en una instancia de Amazon EC2, como un entorno de producción, utilice un rol de IAM tal como se describe en [Concesión de acceso mediante un rol de IAM](net-dg-hosm.md). Si no es el caso (como, por ejemplo, en las pruebas de versión preliminar) almacene las credenciales en un archivo de credenciales de AWS al que la aplicación web tenga acceso en el servidor.
## Resolución de perfiles
Con dos tipos de mecanismos de almacenamiento de credenciales diferentes, es importante saber cómo configurar AWS SDK para .NET para usarlos. La propiedad [AWSConfigs.AWSProfilesLocation](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) controla la forma en que AWS SDK para .NET busca perfiles de credenciales.
****
| AWSProfilesLocation | Comportamiento de resolución de perfiles |
| --- | --- |
| null (no establecido) o vacío | Busque en SDK Store si la plataforma lo admite y, a continuación, busque el archivo de credenciales de AWS compartido en la [ubicación predeterminada](creds-file.md). Si el perfil no está en ninguna de esas ubicaciones, busque en `~/.aws/config` (Linux o macOS) o en `%USERPROFILE%\.aws\config` (Windows). |
| Ruta a un archivo en el formato del archivo de credenciales de AWS | Busque *solo* en el archivo especificado el perfil con el nombre indicado. |
## Uso de credenciales de cuentas de usuario federado
Las aplicaciones que usan AWS SDK para .NET ([AWSSDK.Core](https://www.nuget.org/packages/AWSSDK.Core/) versión 3.1.6.0 y posterior) pueden usar cuentas de usuario federado a través de Servicios de federación de Active Directory (AD FS) para obtener acceso a servicios de AWS mediante el lenguaje de marcado de aserción de seguridad (SAML).
La compatibilidad del acceso federado significa que los usuarios pueden autenticarse mediante su Active Directory. Las credenciales temporales se conceden al usuario automáticamente. Estas credenciales temporales, que son válidas durante una hora, se usan cuando la aplicación invoca servicios de AWS. El SDK gestiona la administración de las credenciales temporales. Para las cuentas de usuario unidas a un dominio, si su aplicación realiza una llamada, pero las credenciales han caducado, el usuario vuelve a autenticarse automáticamente y se conceden credenciales actualizadas (para las cuentas que no unidas a un dominio, se le pide al usuario que escriba las credenciales antes de la segunda autenticación).
Para usar este soporte en su aplicación de .NET, primero debe configurar el perfil de rol mediante un cmdlet de PowerShell. Para saber cómo, consulte la [documentación de AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/saml-pst.html).
Después de configurar el perfil del rol, haga referencia al perfil en la aplicación. Hay varias formas de hacerlo; una de ellas consiste en utilizar la propiedad [AWSConfigs.AWSProfileName](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) del mismo modo que se utilizaría con otros perfiles de credenciales.
El ensamblado de *AWS Security Token Service* ([AWSSDK.SecurityToken](https://www.nuget.org/packages/AWSSDK.SecurityToken/)) proporciona la compatibilidad con SAML para obtener credenciales de AWS. Para usar credenciales de cuentas de usuario federado, asegúrese de que este ensamblado está disponible para la aplicación.
## Especificación de roles o credenciales temporales
En el caso de las aplicaciones que se ejecutan en instancias de Amazon EC2, el modo más seguro de administrar las credenciales es usar roles de IAM, como se describe en [Concesión de acceso mediante un rol de IAM](net-dg-hosm.md).
Para los escenarios de aplicación en los que el software ejecutable está disponible para los usuarios externos a su organización, recomendamos que diseñe el software para usar *credenciales de seguridad temporales*. Además de proporcionar acceso restringido a los recursos de AWS, estas credenciales tienen la ventaja de caducar después de un período de tiempo especificado. Para obtener más información sobre cómo usar credenciales de seguridad temporales, consulte lo siguiente:
+ [Credenciales de seguridad temporales](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)
+ [Grupos de identidades de Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html)
## Uso de credenciales de proxy
Si el software se comunica con AWS a través de un proxy, puede especificar credenciales para el proxy mediante la propiedad `ProxyCredentials` en la clase `Config` de un servicio. La clase `Config` de un servicio suele formar parte del espacio de nombres principal del servicio. Ejemplos de ello son los siguientes [AmazonCloudDirectoryConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudDirectory/TCloudDirectoryConfig.html) del espacio de nombres [Amazon.CloudDirectory](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudDirectory/NCloudDirectory.html) y [AmazonGameLiftConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/GameLift/TGameLiftConfig.html) del espacio de nombres [Amazon.GameLift](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/GameLift/NGameLift.html).
Por ejemplo, en [Amazon S3](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html) se podría usar un código similar al siguiente, donde `SecurelyStoredUserName` y `SecurelyStoredPassword` son el nombre de usuario y la contraseña del proxy especificados en un objeto [NetworkCredential](https://learn.microsoft.com/en-us/dotnet/api/system.net.networkcredential).
```
AmazonS3Config config = new AmazonS3Config();
config.ProxyCredentials = new NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword);
```
**nota**
Las versiones anteriores del SDK usaban `ProxyUsername` y `ProxyPassword`, pero estas propiedades están obsoletas.
# Información adicional acerca de los usuarios y los roles
Para desarrollar con .NET en AWS o ejecutar aplicaciones .NET en AWS, debe tener una combinación de usuarios, conjuntos de permisos y roles de servicio que sean adecuados para estas tareas.
Los usuarios, conjuntos de permisos y roles de servicio específicos que cree, así como la forma en que los utilice, dependerán de los requisitos de las aplicaciones. A continuación, se muestra información adicional sobre por qué se podrían usar y cómo crearlos.
## Usuarios y conjuntos de permisos
Aunque es posible utilizar una cuenta de usuario de IAM con credenciales de larga duración para acceder a los servicios de AWS, esta práctica ya no es recomendable y se debe evitar. Incluso durante el desarrollo, se recomienda crear usuarios y conjuntos de permisos en AWS IAM Identity Center y utilizar credenciales temporales proporcionadas por un origen de identidad.
Para el desarrollo, puede usar el usuario que ha creado o que le han proporcionado en [Configuración de la autenticación de SDK](creds-idc.md). Si tiene los permisos de Consola de administración de AWS adecuados, también puede crear diferentes conjuntos de permisos con los privilegios mínimos para ese usuario o crear nuevos usuarios específicamente para proyectos de desarrollo, lo que proporciona conjuntos de permisos con los privilegios mínimos. El curso de acción que elija, si corresponde, depende de las circunstancias.
Para obtener más información sobre estos usuarios y conjuntos de permisos y sobre cómo crearlos, consulte [Autenticación y acceso](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) en la *Guía de referencia de las herramientas y los SDK de AWS* e [Introducción](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) en la *Guía del usuario de AWS IAM Identity Center*.
## Roles de servicio
Puede configurar un rol de servicio de AWS para acceder a los servicios de AWS en nombre de los usuarios. Este tipo de acceso es adecuado si varias personas van a ejecutar la aplicación de forma remota; por ejemplo, en una instancia de Amazon EC2 que haya creado para este fin.
El proceso de creación de un rol de servicio varía en función de la situación, pero básicamente es el siguiente.
1. Inicie sesión en Consola de administración de AWS y abra la consola IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Elija **Roles** y después **Crear rol**.
1. Elija el **servicio de AWS**, busque y seleccione **EC2** (por ejemplo) y, a continuación, elija el caso de uso de **EC2** (por ejemplo).
1. Seleccione **Siguiente: Permisos** y seleccione las [políticas adecuadas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) para los servicios de AWS que la aplicación va a utilizar.
**aviso**
***NO*** elija la política **AdministratorAccess** porque esa política permite permisos de lectura y escritura en casi todo el contenido de la cuenta.
1. Seleccione **Siguiente: Etiquetas** e introduzca las etiquetas que desee.
Encontrará información sobre las etiquetas en [Control de acceso a los recursos de AWS mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la [Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
1. Seleccione **Siguiente: Revisar** y proporcione un **nombre de rol** y una **descripción del rol**. A continuación, elija **Crear rol**.
Puede encontrar información general sobre los roles de IAM en [Identidades de IAM (usuarios, grupos de usuarios y roles)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) en la [Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/). Encuentre información detallada sobre los roles en el tema [Roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) de esa guía.
**Información adicional sobre los roles**
+ Use [roles de IAM para tareas](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) para tareas de Amazon Elastic Container Service (Amazon ECS).
+ Use [roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) para aplicaciones que se ejecutan en instancias de Amazon EC2.
# Configuración avanzada para su proyecto de AWS SDK para .NET
Los temas de esta sección contienen información sobre más tareas y métodos de configuración que podrían interesarle.
**Topics**
+ [AWSSDK.Extensiones. NETCore.Configuración y IConfiguration](net-dg-config-netcore.md)
+ [Configuración de otros parámetros de la aplicación](net-dg-config-other.md)
+ [Referencia de los archivos de configuración para el AWS SDK para .NET](net-dg-config-ref.md)
# Uso de AWSSDK .Extensions. NETCore.Setup y la interfaz IConfiguration
(Este tema se titulaba anteriormente «Configuración AWS SDK para .NET con .NET Core»)
Uno de los mayores cambios en .NET Core es la eliminación de `ConfigurationManager` y de los archivos `app.config` y `web.config` estándar que se usaban con aplicaciones de .NET Framework y ASP.NET.
La configuración en .NET Core se basa en pares clave-valor establecidos por proveedores de configuración. Los proveedores de configuración leen los datos de configuración en pares clave-valor desde diversos orígenes de configuración, incluidos argumentos de línea de comandos, archivos de directorio, variables de entorno y archivos de configuración.
**nota**
Para obtener más información, consulte [Configuración en ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration).
Para facilitar su uso AWS SDK para .NET con.NET Core, puede utilizar las [AWSSDK.Extensions. NETCore.Paquete de configuración.](https://www.nuget.org/packages/AWSSDK.Extensions.NETCore.Setup/) NuGet Al igual que muchas bibliotecas de.NET Core, añade métodos de extensión a la `IConfiguration` interfaz para facilitar la AWS configuración.
El código fuente de este paquete está GitHub en[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).
## Uso de AWSSDK .Extensions. NETCore.Configuración
Suponga que crea una aplicación ASP.NET Core Model-View-Controller (MVC), que puede realizarse con la plantilla de **aplicación web ASP.NET Core** en Visual Studio o ejecutándola `dotnet new mvc ...` en la CLI de.NET Core. Al crear una aplicación de este tipo, el constructor de `Startup.cs` administra la configuración leyendo varios orígenes de entrada de proveedores de configuración, como `appsettings.json`.
```
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
```
Para usar el `Configuration` objeto para obtener las *AWS*opciones, primero agregue el paquete. `AWSSDK.Extensions.NETCore.Setup` NuGet Luego, agregue sus opciones al archivo de configuración como se describe a continuación.
Fíjese en que uno de los archivos agregados al proyecto es `appsettings.Development.json`. Corresponde a un `EnvironmentName` establecido en **Development**. Durante el desarrollo, pondremos la configuración en este archivo, que solo se lee durante las pruebas locales. Al implementar una instancia de Amazon EC2 `EnvironmentName` configurada en **Producción**, este archivo se ignora y se recurre a las credenciales AWS SDK para .NET de IAM y a la región configuradas para la instancia de Amazon EC2.
Los siguientes ajustes de configuración muestran ejemplos de los valores que se pueden agregar en el archivo `appsettings.Development.json` del proyecto para proporcionar la configuración de AWS .
```
{
"AWS": {
"Profile": "local-test-profile",
"Region": "us-west-2"
},
"SupportEmail": "TechSupport@example.com"
}
```
Para obtener acceso a un ajuste en un archivo *CSHTML* utilice la directiva `Configuration`.
```
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration
Contact
Support: @Configuration["SupportEmail"]
```
Para acceder a las AWS opciones definidas en el archivo desde el código, llame al método de `GetAWSOptions` extensión agregado a. `IConfiguration`
Para crear un cliente de servicio a partir de estas opciones, llame a `CreateServiceClient`. En el siguiente ejemplo se muestra cómo crear un cliente de servicio de Amazon S3 (Asegúrese de añadir el [AWSSDKpaquete.S3](https://www.nuget.org/packages/AWSSDK.S3) NuGet a su proyecto).
```
var options = Configuration.GetAWSOptions();
IAmazonS3 client = options.CreateServiceClient();
```
También puede crear varios clientes de servicio con ajustes incompatibles utilizando varias entradas en el archivo `appsettings.Development.json`, tal y como se muestra en los siguientes ejemplos, donde la configuración de `service1` incluye la región `us-west-2` y la configuración de `service2` incluye la *URL* del punto de conexión especial.
```
{
"service1": {
"Profile": "default",
"Region": "us-west-2"
},
"service2": {
"Profile": "default",
"ServiceURL": "URL"
}
}
```
A continuación, puede obtener las opciones para un servicio específico mediante la entrada del archivo JSON. Por ejemplo, utilice lo siguiente para obtener la configuración de `service1`.
```
var options = Configuration.GetAWSOptions("service1");
```
### Valores permitidos en el archivo appsettings
Los siguientes valores de configuración de la aplicación se pueden establecer en el archivo `appsettings.Development.json`. Los nombres de los campos deben escribirse con las mayúsculas y minúsculas mostradas aquí. Para obtener más información sobre esta configuración, consulte la clase `[AWS.Runtime.ClientConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html)`.
+ Region
+ Profile
+ ProfilesLocation
+ SignatureVersion
+ RegionEndpoint
+ UseHttp
+ ServiceURL
+ AuthenticationRegion
+ AuthenticationServiceName
+ MaxErrorRetry
+ LogResponse
+ BufferSize
+ ProgressUpdateInterval
+ ResignRetries
+ AllowAutoRedirect
+ LogMetrics
+ DisableLogging
+ UseDualstackEndpoint
## Inserción de dependencias de ASP.NET Core
Las *AWSSDK.Extensions. NETCore NuGet El paquete .Setup* también se integra con un nuevo sistema de inyección de dependencias en ASP.NET Core. El método `ConfigureServices` de la clase `Startup` de la aplicación es donde se agregan los servicios MVC. Si la aplicación usa Entity Framework, también es donde se inicializa.
```
public void ConfigureServices(IServiceCollection services)
{
// Add framework services.
services.AddMvc();
}
```
**nota**
Hay disponible información general sobre la inserción de dependencias en .NET Core en el [sitio de documentación de .NET Core](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection).
El `AWSSDK.Extensions.NETCore.Setup` NuGet paquete agrega nuevos métodos de extensión `IServiceCollection` que puede usar para agregar AWS servicios a la inyección de dependencias. El siguiente código muestra cómo añadir las AWS opciones de lectura `IConfiguration` para añadir Amazon S3 y DynamoDB a la lista de servicios. (Asegúrese de añadir los DBv2 NuGet paquetes [AWSSDK.S3 y [AWSSDK.Dynamo](https://www.nuget.org/packages/AWSSDK.DynamoDBv2)](https://www.nuget.org/packages/AWSSDK.S3) a su proyecto).
```
public void ConfigureServices(IServiceCollection services)
{
// Add framework services.
services.AddMvc();
services.AddDefaultAWSOptions(Configuration.GetAWSOptions());
services.AddAWSService();
services.AddAWSService();
}
```
Ahora, si sus controladores MVC usan `IAmazonS3` o `IAmazonDynamoDB` como parámetros en sus constructores, el sistema de inserción de dependencias pasa esos servicios.
```
public class HomeController : Controller
{
IAmazonS3 S3Client { get; set; }
public HomeController(IAmazonS3 s3Client)
{
this.S3Client = s3Client;
}
...
}
```
# Configuración de otros parámetros de la aplicación
**nota**
La información de este tema es específica de proyectos basados en .NET Framework. Los archivos `App.config` y `Web.config` no están presentes de forma predeterminada en proyectos basados en .NET Core.
## Abrir para ver el contenido de .NET Framework
Hay varios parámetros de la aplicación que se pueden configurar:
+ `AWSLogging`
+ `AWSLogMetrics`
+ `AWSRegion`
+ `AWSResponseLogging`
+ `AWS.DynamoDBContext.TableNamePrefix`
+ `AWS.S3.UseSignatureVersion4`
+ `AWSEndpointDefinition`
+ [AWS Terminales generados por el servicio](#config-setting-service-generated-awsendpointdefinition)
Estos parámetros se pueden configurar en el archivo `App.config` o `Web.config` de la aplicación. Aunque también puedes configurarlos con la AWS SDK para .NET API, te recomendamos que utilices el archivo de la aplicación. `.config` Aquí se describen ambos enfoques.
Para obtener más información sobre cómo usar el elemento `` tal como se describe más adelante en este tema, consulte [Referencia de archivos de configuración de AWS SDK para .NET](net-dg-config-ref.md).
### AWSLogging
Configura la manera en que el SDK debe registrar los eventos, si es que debe hacerlo. Por ejemplo, el enfoque recomendado es utilizar el elemento ``, que es un elemento secundario del elemento ``:
```
```
Otra opción:
```
```
Los valores posibles son:
** `None` **
Desactivación del registro de eventos. Este es el valor predeterminado.
** `log4net` **
Registro mediante log4net.
** `SystemDiagnostics` **
Registro mediante la clase `System.Diagnostics`.
Puede definir diferentes valores para el atributo `logTo`, separado por comas. El siguiente ejemplo define los registros `log4net` y `System.Diagnostics` en el archivo `.config`:
```
```
Otra opción:
```
```
Como alternativa, mediante la AWS SDK para .NET API, combine los valores de la [LoggingOptions](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TLoggingOptions.html)enumeración y establezca la propiedad [AWSConfigs.Logging](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html):
```
AWSConfigs.Logging = LoggingOptions.Log4Net | LoggingOptions.SystemDiagnostics;
```
Los cambios en esta configuración solo se aplican a las instancias de AWS cliente nuevas.
### AWSLogMétricas
Especifica si el SDK debería o no registrar métricas de desempeño. Para definir la configuración de registro de las métricas en el archivo `.config`, defina el valor del atributo `logMetrics` en el elemento ``, que es un elemento secundario del elemento ``:
```
```
De forma alternativa, defina la clave `AWSLogMetrics` en la sección ``:
```
```
Como alternativa, para configurar el registro de métricas con la AWS SDK para .NET API, configure [AWSConfigs. LogMetrics](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)propiedad:
```
AWSConfigs.LogMetrics = true;
```
Esta opción configura la propiedad `LogMetrics` de forma predeterminada para todos los clientes y configuraciones. Los cambios en esta configuración solo se aplican a las instancias de AWS clientes nuevas.
### AWSRegion
Configura la AWS región predeterminada para los clientes que no han especificado una región de forma explícita. Para definir la región en el archivo `.config`, le recomendamos especificar el valor del atributo `region` en el elemento `aws`:
```
```
De forma alternativa, defina la clave *AWSRegion* en la sección ``:
```
```
[Como alternativa, para configurar la región con la AWS SDK para .NET API, defina. AWSConfigs AWSRegion](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)propiedad:
```
AWSConfigs.AWSRegion = "us-west-2";
```
Para obtener más información sobre la creación de un AWS cliente para una región específica, consulte [Selección de AWS regiones](net-dg-region-selection.md). Los cambios en esta configuración solo se aplican a las instancias de AWS clientes nuevas.
### AWSResponseRegistro
Se configura cuando el SDK debería registrar respuestas del servicio. Los valores posibles son:
** `Never` **
No registrar nunca respuestas del servicio. Es el valor predeterminado.
** `Always` **
Registrar siempre respuestas del servicio.
** `OnError` **
Registrar solo respuestas del servicio cuando se produzcan errores.
Para definir la configuración del registro de servicios en el archivo `.config`, le recomendamos que defina el valor del atributo `logResponses` en el elemento ``, que es un elemento secundario del elemento ``:
```
```
También puede configurar la clave de *AWSResponseregistro* en la `` sección:
```
```
Como alternativa, para configurar el registro del servicio con la AWS SDK para .NET API, configure [AWSConfigs. ResponseLogging](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)propiedad en uno de los valores de la [ResponseLoggingOption](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TResponseLoggingOption.html)enumeración:
```
AWSConfigs.ResponseLogging = ResponseLoggingOption.OnError;
```
Los cambios en esta configuración surtirán efecto de inmediato.
### `AWS.DynamoDBContext.TableNamePrefix`
Configura el `TableNamePrefix` predeterminado. Se utilizará `DynamoDBContext` si no se ha configurado manualmente.
Para definir el prefijo del nombre de tabla en el archivo `.config`, le recomendamos definir el valor del atributo `tableNamePrefix` en el elemento ``, que es un elemento secundario del elemento ``, que a su vez es un elemento secundario del elemento ``:
```
```
De forma alternativa, defina la clave `AWS.DynamoDBContext.TableNamePrefix` en la sección ``:
```
```
Como alternativa, para establecer el prefijo del nombre de la tabla con la AWS SDK para .NET API, establezca la propiedad [AWSConfigsDBContextTableNamePrefix.Dynamo](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html):
```
AWSConfigs.DynamoDBContextTableNamePrefix = "Test-";
```
Los cambios en esta configuración solo serán efectivos en las instancias `DynamoDBContextConfig` y `DynamoDBContext` creadas recientemente.
### `AWS.S3.UseSignatureVersion4`
Configura si el cliente de Amazon S3 debería utilizar o no la versión 4 de Signature con solicitudes.
Para establecer la versión 4 de Signature para Amazon S3 en el archivo `.config`, el método recomendado es establecer el valor del atributo `useSignatureVersion4` del elemento ``, que es un elemento secundario del elemento ``:
```
```
De forma alternativa, establezca la clave `AWS.S3.UseSignatureVersion4` en `true` en la sección ``:
```
```
Como alternativa, para configurar la firma en la versión 4 de la firma con la AWS SDK para .NET API, establezca la [AWSConfigspropiedad.S3 UseSignatureVersion](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) 4 en: `true`
```
AWSConfigs.S3UseSignatureVersion4 = true;
```
De forma predeterminada, esta configuración es `false`, pero la versión 4 de Signature puede utilizarse de forma predeterminada en algunos casos o en algunas regiones. Si la configuración es `true`, se utilizará la versión 4 de Signature para todas las solicitudes. Los cambios en esta configuración solo surten efecto en las instancias de cliente de Amazon S3 nuevas.
### AWSEndpointDefinición
Configura si el SDK debería utilizar un archivo de configuración personalizado que define las regiones y los puntos de enlace.
Para definir el archivo de definición del punto de enlace en el archivo `.config`, le recomendamos configurar el valor del atributo `endpointDefinition` en el elemento ``.
```
```
Como alternativa, puede configurar la clave de *AWSEndpointdefinición* en la `` sección:
```
```
Como alternativa, para configurar el archivo de definición del punto final con la AWS SDK para .NET API, configure el [AWSConfigs. EndpointDefinition](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)propiedad:
```
AWSConfigs.EndpointDefinition = @"c:\config\endpoints.json";
```
Si no se proporciona ningún nombre de archivo, no se utilizará el archivo de configuración personalizado. Los cambios en esta configuración solo se aplican a las instancias de AWS clientes nuevas. El archivo endpoint.json está disponible en [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 Puntos finales generados por el servicio
Algunos AWS servicios generan sus propios puntos de enlace en lugar de consumir un punto final regional. Los clientes de estos servicios consumen una URL de servicio específica de dicho servicio y sus recursos. Dos ejemplos de estos servicios son Amazon CloudSearch y AWS IoT. Los siguientes ejemplos muestran cómo puede obtener los puntos de enlace para dichos servicios.
#### Ejemplo de Amazon CloudSearch Endpoints
El CloudSearch cliente de Amazon se utiliza para acceder al servicio de CloudSearch configuración de Amazon. Utiliza el servicio de CloudSearch configuración de Amazon para crear, configurar y gestionar los dominios de búsqueda. Para crear un dominio de búsqueda, cree un [CreateDomainRequest](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/TCreateDomainRequest.html)objeto y proporcione la `DomainName` propiedad. Cree un [AmazonCloudSearchClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/TCloudSearchClient.html)objeto mediante el objeto de solicitud. Llame al método [CreateDomain](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/MCloudSearchCreateDomainCreateDomainRequest.html). El [CreateDomainResponse](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearch/TCreateDomainResponse.html)objeto devuelto por la llamada contiene una `DomainStatus` propiedad que tiene los `SearchService` puntos finales `DocService` y los extremos. Crea un [AmazonCloudSearchDomainConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearchDomain/TCloudSearchDomainConfig.html)objeto y úsalo para inicializar cualquier `SearchService` instancia `DocService` de la [AmazonCloudSearchDomainClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudSearchDomain/TCloudSearchDomainClient.html)clase.
```
// 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 Ejemplo de puntos finales
Para obtener el punto final AWS IoT, cree un [AmazonIoTClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/TIoTClient.html)objeto y llame al [DescribeEndPoint](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/MIoTDescribeEndpointDescribeEndpointRequest.html)método. El [DescribeEndPointResponse](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/TDescribeEndpointResponse.html)objeto devuelto contiene el`EndpointAddress`. Cree un [AmazonIotDataConfig](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IotData/TIotDataConfig.html)objeto, establezca la `ServiceURL` propiedad y utilice el objeto para crear una instancia de la [AmazonIotDataClient](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IotData/TIotDataClient.html)clase.
```
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");
}
```
# Referencia de los archivos de configuración para el AWS SDK para .NET
**nota**
La información de este tema es específica de proyectos basados en .NET Framework. Los archivos `App.config` y `Web.config` no están presentes de forma predeterminada en proyectos basados en .NET Core.
## Abrir para ver el contenido de .NET Framework
Puede usar un archivo `App.config` o `Web.config` del proyecto de .NET para especificar la configuración de AWS, como credenciales de AWS, opciones de registro, puntos de conexión de servicio de AWS y regiones de AWS, así como algunos ajustes de servicios de AWS, como Amazon DynamoDB, Amazon EC2 y Amazon S3. En la siguiente información se describe cómo dar formato correctamente a un archivo `App.config` o `Web.config` para especificar estos tipos de configuración.
**nota**
Aunque puede continuar usando el elemento `` en un archivo `App.config` o `Web.config` para especificar la configuración de AWS, recomendamos usar los elementos `` y ``, como se describe posteriormente en este tema. Para obtener más información sobre el elemento ``, consulte los ejemplos del elemento `` en [Configuración de la aplicación de AWS SDK para .NET](net-dg-config.md).
**nota**
Aunque puede continuar usando las siguientes propiedades de la clase [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html) en un archivo de código para especificar la configuración de AWS, las siguientes propiedades están en desuso y es posible que no se admitan en versiones futuras:
`DynamoDBContextTableNamePrefix`
`EC2UseSignatureVersion4`
`LoggingOptions`
`LogMetrics`
`ResponseLoggingOption`
`S3UseSignatureVersion4`
En general, recomendamos que, en lugar de usar propiedades de la clase `AWSConfigs` en un archivo de código para especificar la configuración de AWS, debe usar los elementos `` y `` en un archivo `App.config` o `Web.config` para especificar la configuración de AWS, como se describe posteriormente en este tema. Para obtener más información sobre las propiedades anteriores, consulte los ejemplos de código de `AWSConfigs` en [Configuración de la aplicación de AWS SDK para .NET](net-dg-config.md).
**Topics**
+ [Declaración de una sección de configuración de AWS](#net-dg-config-ref-declaring)
+ [Elementos permitidos](#net-dg-config-ref-elements)
+ [Referencia de elementos](#net-dg-config-ref-elements-ref)
### Declaración de una sección de configuración de AWS
La configuración de AWS se especifica en un archivo `App.config` o `Web.config` desde el elemento ``. Antes de que pueda empezar a usar el elemento ``, debe crear un elemento `` (que es un elemento secundario del elemento ``) y establecer su atributo `name` en `aws` y su atributo `type` en `Amazon.AWSSection, AWSSDK.Core`, como se muestra en el siguiente ejemplo:
```
...
...
```
El editor de Visual Studio no proporciona relleno de código automático (IntelliSense) para el elemento `` o sus elementos secundarios.
Para ayudarle a crear una versión con formato correcto del elemento ``, llame al método `Amazon.AWSConfigs.GenerateConfigTemplate`. De este modo se devuelve una versión canónica del elemento `` como una cadena bien escrita, que puede adaptar a sus necesidades. En las siguientes secciones se describen los atributos y elementos secundarios del elemento ``.
### Elementos permitidos
A continuación se muestra una lista de las relaciones lógicas entre los elementos permitidos en una sección de configuración de AWS. Puede generar la versión más reciente de esta lista llamando al método `Amazon.AWSConfigs.GenerateConfigTemplate`, que devuelve una versión canónica del elemento `` como una cadena que puede adaptar a sus necesidades.
```
```
### Referencia de elementos
A continuación se muestra una lista de los elementos permitidos en una sección de configuración de AWS. Para cada elemento, se listan sus atributos y elementos principales y secundarios permitidos.
**Topics**
+ [alias](#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)
+ [registrar](#net-dg-config-ref-elements-logging)
+ [map](#net-dg-config-ref-elements-map)
+ [propiedad](#net-dg-config-ref-elements-property)
+ [proxy](#net-dg-config-ref-elements-proxy)
+ [s3](#net-dg-config-ref-elements-s3)
#### alias
El elemento `` representa un solo elemento de una colección de uno o varios mapeos a la tabla y desde la tabla que especifica una tabla distinta de una configurada para un tipo. Este elemento se asigna a una instancia de la clase `Amazon.Util.TableAlias` a partir de la propiedad `Amazon.AWSConfigs.DynamoDBConfig.Context.TableAliases` en el AWS SDK para .NET. La reasignación se lleva a cabo antes de la aplicación de un prefijo de nombre de tabla.
Este elemento puede incluir los siguientes atributos:
** `fromTable` **
La parte desde la tabla del mapeo a la tabla y desde la tabla. Este atributo se asigna a la propiedad `Amazon.Util.TableAlias.FromTable` en AWS SDK para .NET.
** `toTable` **
La parte a la tabla de la asignación a la tabla y desde la tabla. Este atributo se asigna a la propiedad `Amazon.Util.TableAlias.ToTable` en AWS SDK para .NET.
El elemento principal del elemento `` es el elemento ``.
El elemento `` no contiene ningún elemento secundario.
A continuación, mostramos un ejemplo del elemento `` en uso:
```
```
#### `aws`
El elemento `` representa el elemento superior en una sección de configuración de AWS. Este elemento puede incluir los siguientes atributos:
** `endpointDefinition` **
Ruta absoluta a un archivo de configuración personalizado que define las regiones y los puntos de conexión de AWS que se van a usar. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.EndpointDefinition` en AWS SDK para .NET.
** `profileName` **
Nombre de perfil de las credenciales de AWS almacenadas que se usarán para realizar llamadas a servicios. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.AWSProfileName` en AWS SDK para .NET.
** `profilesLocation` **
Ruta absoluta a la ubicación del archivo de credenciales compartido con otros AWS SDK. De forma predeterminada, el archivo de credenciales se almacena en el directorio `.aws` del directorio de inicio del usuario actual. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.AWSProfilesLocation` en AWS SDK para .NET.
** `region` **
ID de región de AWS predeterminado para clientes que no han especificado una región de forma explícita. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.AWSRegion` en AWS SDK para .NET.
El elemento `` no tiene elemento principal.
El elemento `` puede incluir los siguientes elementos secundarios:
+ ``
+ ``
+ ``
+ ``
+ ``
A continuación, mostramos un ejemplo del elemento `` en uso:
```
```
#### dynamoDB
El elemento `` representa una colección de ajustes de Amazon DynamoDB. Este elemento puede incluir el atributo *conversionSchema*, que representa la versión que se va a usar para la conversión entre objetos de .NET y DynamoDB. Los valores permitidos son V1 y V2. Este atributo se asigna a la clase `Amazon.DynamoDBv2.DynamoDBEntryConversion` en AWS SDK para .NET. Para obtener más información, consulte [Serie DynamoDB: esquemas de conversión](http://blogs.aws.amazon.com/net/post/Tx2TCOGWG7ARUH5/DynamoDB-Series-Conversion-Schemas).
El elemento principal del elemento `` es el elemento ``.
El elemento `` puede incluir el elemento secundario ``.
A continuación, mostramos un ejemplo del elemento `` en uso:
```
```
#### dynamoDBContext
El elemento `` representa una colección de ajustes específicos del contexto de Amazon DynamoDB. Este elemento puede incluir el atributo *tableNamePrefix*, que representa el prefijo de nombre de tabla predeterminado que usará el contexto de DynamoDB si no se configura manualmente. Este atributo se asigna a la propiedad `Amazon.Util.DynamoDBContextConfig.TableNamePrefix` a partir de la propiedad `Amazon.AWSConfigs.DynamoDBConfig.Context.TableNamePrefix` de AWS SDK para .NET. Para obtener más información, consulte la sección sobre las [mejoras realizadas en el SDK de DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK).
El elemento principal del elemento `` es el elemento ``.
El elemento `` puede incluir los siguientes elementos secundarios:
+ `` (una o varias instancias)
+ `