La guía de API referencia de la versión AWS SDK for JavaScript 3 describe en detalle todas las API operaciones de la AWS SDK for JavaScript versión 3 (V3).
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 formulario, se especifica una región SDK para que JavaScript pueda SDK acceder al servicio de esa región. Algunos servicios de solo están disponibles en regiones específicas.
El SDK formulario 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 define esta variable, el SDK for 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 usenSDK, puedes guardar tu AWS región y otros ajustes de configuración en un archivo compartido con el nombre config que quieras SDK usar. Si la variable de AWS_SDK_LOAD_CONFIG entorno tiene un valor verdadero, SDK for 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, consulte 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:
-
Si se transfiere una región a un constructor de clase de cliente, se usa dicha región.
-
Si se establece una región en la variable de entorno, se utiliza esa región.
-
De lo contrario, se utiliza la región definida en el archivo de configuración compartido.
