View a markdown version of this page

Región de AWS - AWS SDK y herramientas

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.

Región de AWS

nota

Si necesita ayuda para entender el diseño de las páginas de configuración o para interpretar la tabla de compatibilidad con AWS los SDK y las herramientas que aparece a continuación, consulteCómo comprender las páginas de configuración de esta guía.

Regiones de AWS son un concepto importante que hay que entender a la hora de trabajar con Servicios de AWS ellos.

Con Regiones de AWS, puedes 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 Servicio de AWS solicitudes están asociadas a una región geográfica concreta. 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 mediante programación Servicios de AWS, los SDK utilizan un cliente class/object para cada uno. 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 compartidos AWS config
AWS_REGION: variable de entorno
aws.region- Propiedad del sistema JVM: solo Java/Kotlin

Especifica el valor predeterminado Región de AWS que se utilizará para AWS las solicitudes. 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-globalespecifica el punto de enlace global para los servicios que admiten un punto de enlace global independiente además de los puntos de enlace 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

Linux/macOS ejemplo de configuración de variables de entorno 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, consulta tu guía específica para desarrolladores de AWS SDK.

Respaldado por AWS SDK y herramientas

Los siguientes SDK admiten las características y los ajustes descritos en este tema. Se anotan todas las excepciones parciales. Cualquier configuración de propiedades del sistema JVM solo es compatible con AWS SDK para Java y AWS SDK para Kotlin solo.

SDK compatible Notas o más información
AWS CLI   v2 Sí AWS CLI v2 usa cualquier valor en AWS_REGION antes de cualquier valor en AWS_DEFAULT_REGION (se comprueban ambas variables).
AWS CLI v1 Sí AWS CLI v1 usa una variable de entorno denominada AWS_DEFAULT_REGION para este propósito.
SDK para C++ Sí
SDK para Go V2 (1.x) Sí
SDK para Go 1.x (V1) Sí 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 Sí
SDK para Java 1.x Sí
SDK para 3.x JavaScript Sí
SDK para 2.x JavaScript Sí
SDK para Kotlin Sí
SDK para.NET 4.x Sí
SDK para .NET 3.x Sí
SDK para PHP 3.x Sí
SDK para Python (Boto3) Sí Este SDK usa una variable de entorno llamada AWS_DEFAULT_REGION para este propósito.
SDK para Ruby 3.x Sí
SDK para Rust Sí
SDK para Swift Sí
Herramientas para V5 PowerShell Sí
Herramientas para la PowerShell V4 Sí