¡Se AWS SDK para .NET ha publicado la versión 4 (V4) del\$1

Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el [tema sobre migración](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Referencia de archivos de configuración para AWS SDK para .NET
<a name="net-dg-config-ref"></a>

**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
<a name="w2aac11c29c11b5b1"></a>

Puede usar un `Web.config` archivo `App.config` o un proyecto de.NET para especificar la AWS configuración, como AWS las credenciales, las opciones de registro, los puntos finales del AWS servicio y AWS las regiones, así como algunas configuraciones de los AWS servicios, como Amazon DynamoDB EC2, Amazon 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**  
Si bien puede seguir utilizando el `<appSettings>` elemento de un `Web.config` archivo `App.config` o para especificar la AWS configuración, le recomendamos que utilice los `<aws>` elementos `<configSections>` y tal como se describe más adelante en este tema. Para obtener más información sobre el `<appSettings>` elemento, consulte los ejemplos de `<appSettings>` elementos en [Configuración de AWS SDK para .NET la aplicación](net-dg-config.md).

**nota**  
Si bien puede seguir utilizando las siguientes propiedades de [https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)clase en un archivo de código para especificar la AWS configuración, las siguientes propiedades están en desuso y es posible que no se admitan en futuras versiones:  
 `DynamoDBContextTableNamePrefix` 
 `EC2UseSignatureVersion4` 
 `LoggingOptions` 
 `LogMetrics` 
 `ResponseLoggingOption` 
 `S3UseSignatureVersion4` 
En general, se recomienda que, en lugar de utilizar las propiedades de `AWSConfigs` clase en un archivo de código para especificar la AWS configuración, utilice los `<aws>` elementos `<configSections>` y de un `Web.config` archivo `App.config` o para especificar la AWS configuración, tal y como se describe más adelante en este tema. Para obtener más información sobre las propiedades anteriores, consulte los ejemplos `AWSConfigs` de código en [Configuración de AWS SDK para .NET la aplicación](net-dg-config.md).

**Topics**
+ [Declaración de una sección AWS de configuración](#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 AWS de configuración
<a name="net-dg-config-ref-declaring"></a>

Los AWS ajustes de un `Web.config` archivo `App.config` o se especifican desde dentro del `<aws>` elemento. Antes de que pueda empezar a usar el elemento `<aws>`, debe crear un elemento `<section>` (que es un elemento secundario del elemento `<configSections>`) y establecer su atributo `name` en `aws` y su atributo `type` en `Amazon.AWSSection, AWSSDK.Core`, como se muestra en el siguiente ejemplo:

```
<?xml version="1.0"?>
<configuration>
  ...
  <configSections>
    <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
  </configSections>
  <aws>
    <!-- Add your desired AWS settings declarations here. -->
  </aws>
  ...
</configuration>
```

El editor de Visual Studio no proporciona la finalización automática del código (IntelliSense) para el `<aws>` elemento o sus elementos secundarios.

Para ayudarle a crear una versión con formato correcto del elemento `<aws>`, llame al método `Amazon.AWSConfigs.GenerateConfigTemplate`. De este modo se devuelve una versión canónica del elemento `<aws>` como una cadena bien escrita, que puede adaptar a sus necesidades. En las siguientes secciones se describen los atributos y elementos secundarios del elemento `<aws>`.

### Elementos permitidos
<a name="net-dg-config-ref-elements"></a>

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 `<aws>` como una cadena que puede adaptar a sus necesidades.

```
<aws
  endpointDefinition="string value"
  region="string value"
  profileName="string value"
  profilesLocation="string value">
  <logging
    logTo="None, Log4Net, SystemDiagnostics"
    logResponses="Never | OnError | Always"
    logMetrics="true | false"
    logMetricsFormat="Standard | JSON"
    logMetricsCustomFormatter="NameSpace.Class, Assembly" />
  <dynamoDB
    conversionSchema="V1 | V2">
    <dynamoDBContext
      tableNamePrefix="string value">
      <tableAliases>
        <alias
          fromTable="string value"
          toTable="string value" />
      </tableAliases>
      <map
        type="NameSpace.Class, Assembly"
        targetTable="string value">
        <property
          name="string value"
          attribute="string value"
          ignore="true | false"
          version="true | false"
          converter="NameSpace.Class, Assembly" />
      </map>
    </dynamoDBContext>
  </dynamoDB>
  <s3
    useSignatureVersion4="true | false" />
  <ec2
    useSignatureVersion4="true | false" />
  <proxy
    host="string value"
    port="1234"
    username="string value"
    password="string value" />
</aws>
```

### Referencia de elementos
<a name="net-dg-config-ref-elements-ref"></a>

La siguiente es una lista de los elementos que están permitidos en una sección AWS de configuración. 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)
+ [dinamo DBContext](#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
<a name="net-dg-config-ref-elements-alias"></a>

El elemento `<alias>` 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 el 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 el AWS SDK para .NET.

El elemento principal del elemento `<alias>` es el elemento `<tableAliases>`.

El elemento `<alias>` no contiene ningún elemento secundario.

A continuación, mostramos un ejemplo del elemento `<alias>` en uso:

```
<alias
  fromTable="Studio"
  toTable="Studios" />
```

#### `aws`
<a name="net-dg-config-ref-elements-aws"></a>

El `<aws>` elemento representa el elemento situado en la parte superior de una sección AWS de ajustes. Este elemento puede incluir los siguientes atributos:

** `endpointDefinition` **  
La ruta absoluta a un archivo de configuración personalizado que define AWS las regiones y los puntos finales que se van a utilizar. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.EndpointDefinition` en el AWS SDK para .NET.

** `profileName` **  
El nombre del perfil de AWS las credenciales almacenadas que se utilizarán para realizar llamadas de servicio. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.AWSProfileName` en el AWS SDK para .NET.

** `profilesLocation` **  
La ruta absoluta a la ubicación del archivo de credenciales compartido con otros AWS SDKs. 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 el AWS SDK para .NET.

** `region` **  
El identificador de AWS región predeterminado para los clientes que no han especificado una región de forma explícita. Este atributo se asigna a la propiedad `Amazon.AWSConfigs.AWSRegion` en el AWS SDK para .NET.

El elemento `<aws>` no tiene elemento principal.

El elemento `<aws>` puede incluir los siguientes elementos secundarios:
+  `<dynamoDB>` 
+  `<ec2>` 
+  `<logging>` 
+  `<proxy>` 
+  `<s3>` 

A continuación, mostramos un ejemplo del elemento `<aws>` en uso:

```
<aws
  endpointDefinition="C:\Configs\endpoints.xml"
  region="us-west-2"
  profileName="development"
  profilesLocation="C:\Configs">
  <!-- ... -->
</aws>
```

#### dynamoDB
<a name="net-dg-config-ref-elements-dynamodb"></a>

El elemento `<dynamoDB>` 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 el 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 `<dynamoDB>` es el elemento `<aws>`.

El elemento `<dynamoDB>` puede incluir el elemento secundario `<dynamoDBContext>`.

A continuación, mostramos un ejemplo del elemento `<dynamoDB>` en uso:

```
<dynamoDB
  conversionSchema="V2">
  <!-- ... -->
</dynamoDB>
```

#### dinamo DBContext
<a name="net-dg-config-ref-elements-ddbcontext"></a>

El elemento `<dynamoDBContext>` representa una colección de ajustes específicos del contexto de Amazon DynamoDB. Este elemento puede incluir el *tableNamePrefix*atributo, que representa el prefijo de nombre de tabla predeterminado que utilizará 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` del 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 `<dynamoDBContext>` es el elemento `<dynamoDB>`.

El elemento `<dynamoDBContext>` puede incluir los siguientes elementos secundarios:
+  `<alias>` (una o varias instancias)
+  `<map>` (una o varias instancias)

A continuación, mostramos un ejemplo del elemento `<dynamoDBContext>` en uso:

```
<dynamoDBContext
  tableNamePrefix="Test-">
  <!-- ... -->
</dynamoDBContext>
```

#### ec2
<a name="net-dg-config-ref-elements-ec2"></a>

El `<ec2>` elemento representa una colección de EC2 ajustes de Amazon. Este elemento puede incluir el atributo *useSignatureVersion4*, que especifica si la firma de la versión 4 de la firma se utilizará para todas las solicitudes (verdadero) o si la firma de la versión 4 de la firma no se utilizará para todas las solicitudes (falsa, la opción predeterminada). Este atributo se asigna a la propiedad `Amazon.Util.EC2Config.UseSignatureVersion4` a partir de la propiedad `Amazon.AWSConfigs.EC2Config.UseSignatureVersion4` del AWS SDK para .NET.

El elemento principal del elemento `<ec2>` es el elemento.

El elemento `<ec2>` no contiene ningún elemento secundario.

A continuación, mostramos un ejemplo del elemento `<ec2>` en uso:

```
<ec2
  useSignatureVersion4="true" />
```

#### registrar
<a name="net-dg-config-ref-elements-logging"></a>

El elemento `<logging>` representa una colección de ajustes para el registro de respuestas y el registro de métricas de desempeño. Este elemento puede incluir los siguientes atributos:

** `logMetrics` **  
Si las métricas de desempeño se van a registrar para todos los clientes y configuraciones (true); de lo contrario, false. Este atributo se asigna a la propiedad `Amazon.Util.LoggingConfig.LogMetrics` a partir de la propiedad `Amazon.AWSConfigs.LoggingConfig.LogMetrics` del AWS SDK para .NET.

** `logMetricsCustomFormatter` **  
Tipo de datos y nombre del ensamblado de un formateador personalizado para registrar métricas. Este atributo se asigna a la propiedad `Amazon.Util.LoggingConfig.LogMetricsCustomFormatter` a partir de la propiedad `Amazon.AWSConfigs.LoggingConfig.LogMetricsCustomFormatter` del AWS SDK para .NET.

** `logMetricsFormat` **  
Formato en que se presentan las métricas de registro (se asigna a la propiedad `Amazon.Util.LoggingConfig.LogMetricsFormat` a partir de la propiedad `Amazon.AWSConfigs.LoggingConfig.LogMetricsFormat` del AWS SDK para .NET).  
Entre los valores permitidos se incluyen:    
** `JSON` **  
Utilizar el formato JSON.  
** `Standard` **  
Utilizar el formato predeterminado.

** `logResponses` **  
Cuándo se deben registrar respuestas del servicio (se asigna a la propiedad `Amazon.Util.LoggingConfig.LogResponses` a partir de la propiedad `Amazon.AWSConfigs.LoggingConfig.LogResponses` en el AWS SDK para .NET).  
Entre los valores permitidos se incluyen:    
** `Always` **  
Registrar siempre respuestas del servicio.  
** `Never` **  
No registrar nunca respuestas del servicio.  
** `OnError` **  
Registrar solo respuestas del servicio cuando haya errores.

** `logTo` **  
Dónde iniciar sesión (se asigna a la `LogTo` propiedad desde la `Amazon.AWSConfigs.LoggingConfig.LogTo` propiedad que se encuentra en AWS SDK para .NET).  
Los valores permitidos incluyen una o varias de estas opciones:    
** `Log4Net` **  
Registrarse en log4net.  
** `None` **  
Deshabilitar el registro.  
** `SystemDiagnostics` **  
Registrarse en System.Diagnostics.

El elemento principal del elemento `<logging>` es el elemento `<aws>`.

El elemento `<logging>` no contiene ningún elemento secundario.

A continuación, mostramos un ejemplo del elemento `<logging>` en uso:

```
<logging
  logTo="SystemDiagnostics"
  logResponses="OnError"
  logMetrics="true"
  logMetricsFormat="JSON"
  logMetricsCustomFormatter="MyLib.Util.MyMetricsFormatter, MyLib" />
```

#### map
<a name="net-dg-config-ref-elements-map"></a>

El `<map>` elemento representa un único elemento de una colección de type-to-table asignaciones de tipos .NET a tablas de DynamoDB (se asigna a una instancia de la `TypeMapping` clase desde la propiedad de). `Amazon.AWSConfigs.DynamoDBConfig.Context.TypeMappings` 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).

Este elemento puede incluir los siguientes atributos:

** `targetTable` **  
Tabla de DynamoDB a la que se aplica el mapeo. Este atributo se asigna a la propiedad `Amazon.Util.TypeMapping.TargetTable` en el AWS SDK para .NET.

** `type` **  
Tipo y nombre del ensamblado al que se aplica el mapeo. Este atributo se asigna a la propiedad `Amazon.Util.TypeMapping.Type` en el AWS SDK para .NET.

El elemento principal del elemento `<map>` es el elemento `<dynamoDBContext>`.

El elemento `<map>` puede incluir una o varias instancias del elemento secundario `<property>`.

A continuación, mostramos un ejemplo del elemento `<map>` en uso:

```
<map
  type="SampleApp.Models.Movie, SampleDLL"
  targetTable="Movies">
  <!-- ... -->
</map>
```

#### propiedad
<a name="net-dg-config-ref-elements-property"></a>

El elemento `<property>` representa una propiedad DynamoDB. (Este elemento se asigna a una instancia de Amazon.Util. PropertyConfig [clase del `AddProperty` método de AWS SDK para .NET) Para obtener más información, consulte [Mejoras en el SDK de DynamoDB y los atributos de DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK).](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DeclarativeTagsList.html)

Este elemento puede incluir los siguientes atributos:

** `attribute` **  
Nombre de un atributo para la propiedad, como el nombre de una clave de rango. Este atributo se asigna a la propiedad `Amazon.Util.PropertyConfig.Attribute` en el AWS SDK para .NET.

** `converter` **  
Tipo de convertidor que se debe usar para esta propiedad. Este atributo se asigna a la propiedad `Amazon.Util.PropertyConfig.Converter` en el AWS SDK para .NET.

** `ignore` **  
Si debe hacerse caso omiso de la propiedad asociada (true); de lo contrario, false. Este atributo se asigna a la propiedad `Amazon.Util.PropertyConfig.Ignore` en el AWS SDK para .NET.

** `name` **  
El nombre de la propiedad. Este atributo se asigna a la propiedad `Amazon.Util.PropertyConfig.Name` en el AWS SDK para .NET.

** `version` **  
Si esta propiedad debe almacenar el número de versión del elemento (true); de lo contrario, false. Este atributo se asigna a la propiedad `Amazon.Util.PropertyConfig.Version` en el AWS SDK para .NET.

El elemento principal del elemento `<property>` es el elemento `<map>`.

El elemento `<property>` no contiene ningún elemento secundario.

A continuación, mostramos un ejemplo del elemento `<property>` en uso:

```
<property
  name="Rating"
  converter="SampleApp.Models.RatingConverter, SampleDLL" />
```

#### proxy
<a name="net-dg-config-ref-elements-proxy"></a>

El elemento `<proxy>` representa los ajustes para configurar un proxy que AWS SDK para .NET usará. Este elemento puede incluir los siguientes atributos:

**host**  
Nombre de host o dirección IP del servidor proxy. Estos atributos se asignan a la propiedad `Amazon.Util.ProxyConfig.Host` a partir de la propiedad `Amazon.AWSConfigs.ProxyConfig.Host` del AWS SDK para .NET.

**contraseña**  
Contraseña para autenticarse con el servidor proxy. Estos atributos se asignan a la propiedad `Amazon.Util.ProxyConfig.Password` a partir de la propiedad `Amazon.AWSConfigs.ProxyConfig.Password` del AWS SDK para .NET.

**puerto**  
Número de puerto del proxy. Estos atributos se asignan a la propiedad `Amazon.Util.ProxyConfig.Port` a partir de la propiedad `Amazon.AWSConfigs.ProxyConfig.Port` del AWS SDK para .NET.

**nombre de usuario**  
Nombre de usuario para autenticarse con el servidor proxy. Estos atributos se asignan a la propiedad `Amazon.Util.ProxyConfig.Username` a partir de la propiedad `Amazon.AWSConfigs.ProxyConfig.Username` del AWS SDK para .NET.

El elemento principal del elemento `<proxy>` es el elemento `<aws>`.

El elemento `<proxy>` no contiene ningún elemento secundario.

A continuación, mostramos un ejemplo del elemento `<proxy>` en uso:

```
<proxy
  host="192.0.2.0"
  port="1234"
  username="My-Username-Here"
  password="My-Password-Here" />
```

#### s3
<a name="net-dg-config-ref-elements-s3"></a>

El elemento `<s3>` representa una colección de ajustes de Amazon S3. Este elemento puede incluir el atributo *useSignatureVersion4*, que especifica si la firma de la versión 4 de la firma se utilizará para todas las solicitudes (true) o si la firma de la versión 4 de la firma no se utilizará para todas las solicitudes (false, la opción predeterminada). Este atributo se asigna a la propiedad `Amazon.AWSConfigs.S3Config.UseSignatureVersion4` en el AWS SDK para .NET.

El elemento principal del elemento `<s3>` es el elemento `<aws>`.

El elemento `<s3>` no contiene ningún elemento secundario.

A continuación, mostramos un ejemplo del elemento `<s3>` en uso:

```
<s3 useSignatureVersion4="true" />
```