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 la región de AWS

Las regiones de AWS permiten acceder a servicios de AWS que se encuentran físicamente en una región geográfica determinada. 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 de cada servicio de AWS, consulte Puntos de conexión y cuotas de servicios 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. Para ver información detallada sobre las regiones, consulte Especificar qué regiones de AWS puede usar su cuenta.

Puede crear un cliente de servicio de AWS que vaya a una región en particular. También puede configurar la aplicación con una región que se utilizará en todos los clientes de servicio de AWS. Estos dos casos se explican a continuación.

Creación de un cliente de servicio con una región particular

Se puede especificar la región de cualquiera de los clientes de servicio de AWS de la 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 cliente de Amazon EC2 en una región existente. Se utilizan campos de RegionEndpoint definidos.

using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2))
{
  // Make a request to EC2 in the us-west-2 Region using ec2Client
}

Nueva región mediante la clase RegionEndpoint

En este ejemplo se muestra cómo crear un nuevo punto de conexión de región mediante RegionEndpoint.GetBySystemName.

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 propiedad ServiceURL de la clase de configuración de cliente de servicio para especificar la región, en este caso, la clase AmazonEC2Config.

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 maneras de especificar una región para todos los clientes de servicio de AWS que la aplicación cree. Esta región se usa con los clientes de servicio que no se crean con una región particular.

AWS SDK for .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.

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

Clase AWSConfigs

Establézcala como una propiedad AWSConfigs.AWSRegion.

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 for .NET intenta encontrar una región en la que pueda operar el cliente de servicio de AWS.

Si no se encuentra ninguna región, SDK lanza una excepción que indica que el cliente de servicio de AWS 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 regiones de AWS no funcionarán en la región China (Pekín). De igual modo, las cuentas y credenciales de la región China (Pekín) no funcionarán en otras regiones de AWS. 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.

Información especial sobre nuevos servicios de AWS

Los servicios nuevos de AWS se pueden lanzar inicialmente en algunas regiones y pasar a ser compatibles más adelante 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.