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.
nota
Para obtener ayuda para comprender el diseño de las páginas de configuración o para interpretar la tabla Support by AWS SDKs and tools que aparece a continuación, consulteDescripción de las páginas de configuración de esta guía.
Regiones de AWS son un concepto importante que hay que entender al trabajar con ellos Servicios de AWS.
Con Regiones de AWS, puede acceder a Servicios de AWS esa residencia física 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 Servicio de AWS las solicitudes 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:
-
Para entender la relación entre las regiones y los puntos de conexión, y para ver una lista de los puntos de conexión regionales existentes, consulte los Puntos de conexión del servicio de AWS.
-
Para ver la lista actual de todas las regiones y puntos de conexión para cada servicio de Servicio de AWS, consulte Puntos de conexión de servicio y cuotas.
Cómo crear clientes de servicio
Para acceder mediante programación Servicios de AWS, SDKs utilice una clase/objeto de cliente para cada uno. Servicio de AWS Si tu aplicación necesita acceder a Amazon EC2, por ejemplo, crearía un objeto EC2 cliente de Amazon para interactuar con ese servicio.
Si no se especifica explícitamente ninguna región para el cliente en el propio código, el cliente utilizará de forma predeterminada la región que se establece mediante la siguiente region
configuración. 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 AWSconfig
archivos compartidosAWS_REGION
: variable de entornoaws.region
- Propiedad del sistema JVM: solo en Java/Kotlin-
Especifica el valor predeterminado que se debe usar en Región de AWS las solicitudes. 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 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
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 SDKs tienen un objeto de «configuración» que permite establecer la región predeterminada desde el código de la aplicación. Para obtener más información, consulta la guía específica AWS para desarrolladores del SDK.
Support by AWS SDKs and tools
Las siguientes SDKs son compatibles con las funciones y configuraciones descritas en este tema. Se anotan todas las excepciones parciales. Todos los ajustes de propiedades del sistema JVM son compatibles con AWS SDK for Java y AWS SDK para Kotlin únicamente.
SDK | Compatible | Notas o más información |
---|---|---|
AWS CLI v2 | Sí | AWS CLI v2 utiliza cualquier valor de entrada AWS_REGION antes de cualquier valor de entrada AWS_DEFAULT_REGION (ambas variables están marcadas). |
AWS CLI v1 | Sí | AWS CLI v1 usa una variable de entorno nombrada 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 JavaScript 3.x | Sí | |
SDK para 2.x JavaScript | Sí | |
SDK para Kotlin | 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 PowerShell | Sí |