¡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.
# Configuración de AWS la región para AWS SDK para .NET
AWS Las regiones le permiten acceder a AWS los servicios que residen físicamente en una región geográfica específica. Esto puede ser útil para evitar redundancias y para que sus datos y aplicaciones se ejecuten cerca del lugar desde donde accederá a ellos usted y sus usuarios.
Para ver la lista actual de todas las regiones y puntos de conexión compatibles con cada AWS servicio, consulte los puntos de conexión [y las cuotas de los servicios](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) en la. *Referencia general de AWS* Para ver una lista de los puntos de conexión regionales existentes, consulte [Puntos de conexión de servicios de AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html). Para ver información detallada sobre las regiones, consulte [Especificar qué regiones de AWS puede usar su cuenta](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html).
Puede crear un cliente de AWS servicio que vaya a una región [en particular](#per-client). También puede configurar la aplicación con una región que se utilizará para [todos los clientes AWS de servicio](#globally). Estos dos casos se explican a continuación.
## Creación de un cliente de servicio con una región particular
Puede especificar la región de cualquiera de los clientes de AWS servicio de su aplicación. La configuración de la región de esta manera prevalece sobre cualquier configuración global de ese cliente de servicio concreto.
### Región existente
En este ejemplo, se muestra cómo crear una instancia de un [ EC2 cliente de Amazon](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Client.html) en una región existente. Utiliza campos definidos [RegionEndpoint](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TRegionEndpoint.html).
```
using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2))
{
// Make a request to EC2 in the us-west-2 Region using ec2Client
}
```
### Nueva región usando la RegionEndpoint clase
En este ejemplo, se muestra cómo construir un nuevo punto final de región mediante [RegionEndpoint. GetBySystemName](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/MRegionEndpointGetBySystemNameString.html).
```
var newRegion = RegionEndpoint.GetBySystemName("us-west-new");
using (var ec2Client = new AmazonEC2Client(newRegion))
{
// Make a request to EC2 in the new Region using ec2Client
}
```
### Nueva región mediante la clase de configuración de cliente de servicio
En este ejemplo, se muestra cómo utilizar la `ServiceURL` propiedad de la clase de configuración del cliente de servicio para especificar la región; en este caso, se utiliza la clase [Amazon EC2 Config](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Config.html).
Esta técnica funciona incluso si el punto de conexión de la región no sigue el patrón de punto de conexión de región habitual.
```
var ec2ClientConfig = new AmazonEC2Config
{
// Specify the endpoint explicitly
ServiceURL = "https://ec2.us-west-new.amazonaws.com"
};
using (var ec2Client = new AmazonEC2Client(ec2ClientConfig))
{
// Make a request to EC2 in the new Region using ec2Client
}
```
## Especificación de una región para todos los clientes de servicio
Hay varias formas de especificar una región para todos los clientes de AWS servicio que cree la aplicación. Esta región se usa con los clientes de servicio que no se crean con una región particular.
AWS SDK para .NET Busca un valor de región en el siguiente orden.
### Perfiles
Establezca un perfil que la aplicación o SDK haya cargado. Para obtener más información, consulte [Resolución de credencial y perfil](creds-assign.md).
### Variables de entorno
Establezca la variable de entorno `AWS_REGION`.
En Linux o macOS:
```
export AWS_REGION='us-west-2'
```
En Windows:
```
set AWS_REGION=us-west-2
```
**nota**
Si configura esta variable de entorno para todo el sistema (utilizando `export` o`setx`), afectará a todos los SDKs kits de herramientas, no solo a los AWS SDK para .NET.
### AWSConfigs clase
Establecido como un [AWSConfigs. AWSRegion](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)propiedad.
```
AWSConfigs.AWSRegion = "us-west-2";
using (var ec2Client = new AmazonEC2Client())
{
// Make request to Amazon EC2 in us-west-2 Region using ec2Client
}
```
## Resolución de la región
Si no se utiliza ninguno de los métodos descritos anteriormente para especificar una Región de AWS, AWS SDK para .NET intentará encontrar una región en la que pueda operar el cliente del AWS servicio.
**Orden de resolución de la región**
1. Archivos de configuración de la aplicación, como `app.config` y `web.config`
1. Variables de entorno (`AWS_REGION` y `AWS_DEFAULT_REGION`)
1. Un perfil con el nombre especificado por un valor en `AWSConfigs.AWSProfileName`
1. Un perfil con el nombre especificado por la variable de entorno `AWS_PROFILE`
1. El perfil `[default]`
1. Metadatos de EC2 instancias de Amazon (si se ejecutan en una EC2 instancia).
Si no se encuentra ninguna región, el SDK lanza una excepción que indica que el cliente del AWS servicio no tiene ninguna región configurada.
## Información especial sobre la región de China (Pekín)
Para utilizar servicios en la región de China (Pekín), debe disponer de una cuenta y de credenciales específicas de la región de China (Pekín). Las cuentas y credenciales de otras AWS regiones no funcionarán en la región China (Pekín). Del mismo modo, las cuentas y credenciales de la región de China (Pekín) no funcionarán en otras AWS regiones. Para obtener más información acerca de los puntos de enlace y los protocolos disponibles en la región de China (Pekín), consulte [Puntos finales de la región de Pekín](https://docs.amazonaws.cn/en_us/aws/latest/userguide/endpoints-Beijing.html).
## Información especial sobre nuevos AWS servicios
AWS Los nuevos servicios pueden lanzarse inicialmente en algunas regiones y luego ofrecerse soporte en otras regiones. En estos casos, no es necesario instalar el último SDK para acceder a las nuevas regiones para ese servicio. Puede especificar las regiones que se han agregado recientemente para cada cliente o de forma global, como se ha indicado anteriormente.