Configuración de la región de AWS - AWS SDK para JavaScript
En un constructor de clase de clienteUso de una variable de entornoUso de un archivo de configuración compartidoOrden de prioridad para establecer la región

La Guía de referencia de la API de AWS SDK for JavaScript V3 describe en detalle todas las operaciones de la API para la versión 3 (V3) de AWS SDK for JavaScript.

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

Una región de AWS es un conjunto designado de recursos de AWS que están en la misma área geográfica. Un ejemplo de región es us-east-1, que es la región Este de EE. UU. (Norte de Virginia). Al crear un cliente de servicio en el SDK para JavaScript, se especifica una región para que el SDK acceda al servicio de esa región. Algunos servicios solo están disponibles en regiones específicas.

El SDK para JavaScript no selecciona una región de forma predeterminada. Sin embargo, puede configurar la región de AWS mediante una variable de entorno o un archivo config de configuración compartida.

En un constructor de clase de cliente

Cuando cree una instancia de un objeto de servicio, puede especificar la región de AWS de dicho recurso como parte del constructor de clases de cliente, tal y como se muestra aquí.

const s3Client = new S3.S3Client({region: 'us-west-2'});

Uso de una variable de entorno

Puede establecer la región mediante la variable de entorno AWS_REGION. Si define esta variable, el SDK para JavaScript la lee y la utiliza.

Uso de un archivo de configuración compartido

Al igual que el archivo de credenciales compartidas le permite almacenar credenciales para que el SDK las use, puede mantener su región de AWS y otras opciones de configuración en un archivo compartido llamado config que utiliza el SDK. Si la variable de entorno AWS_SDK_LOAD_CONFIG se estable en un valor truthy, el SDK para JavaScript busca automáticamente un archivo config cuando se carga. La ubicación donde guarde el archivo config depende de su sistema operativo:

  • Usuarios de Linux, macOS o Unix: ~/.aws/config

  • Usuarios de Windows: C:\Users\USER_NAME\.aws\config

Si todavía no tiene un archivo config compartido, puede crear uno en el directorio designado. En el siguiente ejemplo, el archivo config establece la región y el formato de salida.

[default]
   region=us-west-2
   output=json

Para obtener más información sobre el uso de archivos de config y credentials compartidos, consulte Archivos de configuración y credenciales compartidos en la Guía de referencia de SDK y herramientas de AWS.

Orden de prioridad para establecer la región

El orden de prioridad para la configuración de una región es el siguiente:

  1. Si se transfiere una región a un constructor de clase de cliente, se usa dicha región.

  2. Si se establece una región en la variable de entorno, se utiliza esa región.

  3. De lo contrario, se utiliza la región definida en el archivo de configuración compartido.