Defina la AWS región - AWS SDK for JavaScript
En un constructor de clase de clienteUsa una variable de entornoUsa 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.

Defina la AWS región

Una AWS región es un conjunto de AWS recursos con nombre asignado 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, se especifica una región JavaScript para que el SDK acceda al servicio de esa región. Algunos servicios de 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 AWS región mediante una variable de entorno o un config archivo de configuración compartido.

En un constructor de clase de cliente

Al crear una instancia de un objeto de servicio, puede especificar la AWS región de ese recurso como parte del constructor de la clase de cliente, como se muestra aquí.

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

Usa una variable de entorno

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

Usa un archivo de configuración compartido

Del mismo modo que el archivo de credenciales compartidas te permite almacenar las credenciales para que las utilice el SDK, puedes guardar tu AWS región y otros ajustes de configuración en un archivo compartido con el nombre config del SDK que vas a usar. Si la variable de AWS_SDK_LOAD_CONFIG entorno se establece en un valor verdadero, el SDK busca JavaScript automáticamente un config archivo 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 credentials archivos config AND compartidos, consulta los archivos de configuración y credenciales compartidos en la Guía de referencia de herramientas AWS SDKs y herramientas.

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.