Región de AWS - SDK y herramientas de AWS

Región de AWS

nota

Para obtener ayuda para comprender el diseño de las páginas de configuración o para interpretar la tabla Soporte mediante herramientas y SDK de AWS que aparece a continuación, consulte Comprender las páginas de configuración de esta guía.

Las Regiones de AWS son un concepto importante que hay que entender al trabajar con los Servicios de AWS.

Con las Regiones de AWS, puede acceder a los Servicios de AWS que residen físicamente en un área 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 usted y sus usuarios accederán a ellos. Las regiones proporcionar tolerancia a errores, estabilidad y resistencia, y también pueden reducir la latencia. Con las regiones, puede crear recursos redundantes que sigan estando disponibles y no resulten afectados por una interrupción regional.

La mayoría de las solicitudes de Servicio de AWS están asociadas a una región geográfica en particular. Los recursos que crea en una región no existen en ninguna otra región salvo que utilice explícitamente una característica de replicación ofrecida por un Servicio de AWS. Por ejemplo, Amazon S3 y Amazon EC2 admiten la replicación entre regiones. Algunos servicios, como IAM, no tienen recursos regionales.

El informe Referencia general de AWS contiene la siguiente información:

Cómo crear clientes de servicio

Para acceder a los Servicios de AWS mediante programación, los SDK utilizan una clase de cliente u objeto para cada Servicio de AWS. Si su aplicación necesita acceder a Amazon EC2, por ejemplo, crearía un objeto de cliente de Amazon EC2 para interactuar con ese servicio.

Si no se especifica explícitamente ninguna región para el cliente en el código en sí, el cliente utilizará de forma predeterminada la región establecida mediante la siguiente configuración de region. Sin embargo, la región activa de un cliente se puede establecer explícitamente para cualquier objeto de cliente individual. La configuración de la región de esta manera prevalece sobre cualquier configuración global para ese cliente de servicio concreto. La región alternativa se especifica durante la creación de instancias de ese cliente y es específica de su SDK (consulte la guía del SDK específica o la base de código de su SDK).

Configure esta funcionalidad mediante lo siguiente:

region: configuración de archivos config de AWS compartidos
AWS_REGION: variable de entorno
aws.region: propiedad del sistema JVM: solo en Java/Kotlin

Especifica la Región de AWS predeterminada que se utilizará en las solicitudes de AWS. Esta región se usa para las solicitudes de servicio del SDK que no se proporcionan con una región específica para su uso.

Valor predeterminado: ninguno. Debe especificar este valor de forma explícita.

Valores válidos:

  • Cualquiera de los códigos de región disponibles para el servicio elegido, como se muestran en Puntos de conexión de AWS en la referencia general de AWS. Por ejemplo, el valor us-east-1 establece el punto de conexión en la región Región de AWS Este de EE. UU. (Norte de Virginia).

  • aws-global especifica el punto de conexión global para los servicios que admiten un punto de conexión global independiente además de puntos de conexión regionales, como AWS Security Token Service (AWS STS) y Amazon Simple Storage Service (Amazon S3).

Ejemplo de configuración de este valor en el archivo config:

[default] region = us-west-2

Ejemplo de configuración de variables de entorno en Linux/macOS mediante la línea de comandos:

export AWS_REGION=us-west-2

Ejemplo de configuración de variables de entorno en Windows mediante la línea de comandos:

setx AWS_REGION us-west-2

La mayoría de los SDK tienen un objeto de “configuración” que permite configurar la región predeterminada desde el código de la aplicación. Para obtener más información, consulte la guía específica para desarrolladores del AWS SDK.

Soporte mediante SKD y herramientas de AWS

Los siguientes SDK admiten las características y los ajustes descritos en este tema. Se anotan todas las excepciones parciales. Todos los ajustes de propiedades del sistema JVM son compatibles con AWS SDK para Java y AWS SDK para Kotlin únicamente.

SDK Compatible Notas o más información
AWS CLI v2 La AWS CLI v2 usa cualquier valor en la AWS_REGION antes de cualquier valor incluido en la AWS_DEFAULT_REGION (ambas variables están marcadas).
AWS CLI v1 La AWS CLI v1 usa una variable de entorno llamada AWS_DEFAULT_REGION para este propósito.
SDK para C++
SDK para Go V2 (1.x)
SDK para Go 1.x (V1) Para usar la configuración de archivos compartidos config, debe activar la carga desde el archivo de configuración; consulte Sesiones.
SDK para Java 2.x
SDK para Java 1.x
SDK para JavaScript 3.x
SDK para JavaScript 2.x
SDK de para Kotlin
SDK para .NET 4.x
SDK para .NET 3.x
SDK para PHP 3.x
SDK para Python (Boto3) Este SDK usa una variable de entorno llamada AWS_DEFAULT_REGION para este propósito.
SDK para Ruby 3.x
SDK de para Rust
SDK de para Swift
Herramientas para PowerShell V5
Herramientas para PowerShell V4