Configuración de laAWS región - AWS SDK for JavaScript

LaAWS SDK for JavaScript versión 3 (v3) es una reescritura de la versión 2 con algunas funciones nuevas y excelentes, incluida la arquitectura modular. Para obtener más información, consulte la Guía para desarrolladores de la versiónAWS SDK for JavaScript 3.

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 laAWS región

Una región es un conjunto deAWS recursos con nombre en la misma zona geográfica. Un ejemplo de región esus-east-1, que es la región EE. UU. Este (Norte de Virginia). Usted especifica una región al configurar el SDK para JavaScript que el SDK acceda a los recursos 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 región mediante una variable de entorno, un archivo config compartido o el objeto de configuración global.

En un constructor de clase de cliente

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

var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});

Uso del objeto de configuración global

Para configurar la región en el JavaScript código, actualice el objeto de configuraciónAWS.Config global como se muestra aquí.

AWS.config.update({region: 'us-east-1'});

Para obtener más información sobre las regiones actuales y los servicios disponibles en cada región, consulte AWSRegiones y puntos de conexión en la ReferenciaAWS general.

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 la JavaScript lee y la usa.

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 y otras opciones de configuración en un archivo compartido denominado config que el SDK utiliza. Si la variable deAWS_SDK_LOAD_CONFIG entorno se ha establecido en un valor verdadero, el SDK busca JavaScript automáticamente unconfig 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-east-1 output=json

Para obtener más información sobre el uso de archivos de configuración y credenciales compartidos, consulteCarga de credenciales en Node.js desde el archivo de credenciales compartidas Archivos de configuración y credenciales en la Guía delAWS Command Line Interface usuario.

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. De lo contrario, entonces...

  • Si se establece una región en el objeto de configuración global, se usa dicha región. De lo contrario, entonces...

  • Si la variable de entorno AWS_REGION es un valor truthy, se usa esa región. De lo contrario, entonces...

  • Si la variable de entorno AMAZON_REGION es un valor truthy, se usa esa región. De lo contrario, entonces...

  • Si la variable de entorno AWS_SDK_LOAD_CONFIG se establece en un valor truthy y el archivo de credenciales compartidas (~/.aws/credentials o la ruta indicada por AWS_SHARED_CREDENTIALS_FILE) contiene una región para el perfil configurado, se usa esa región. De lo contrario, entonces...

  • Si la variable de entorno AWS_SDK_LOAD_CONFIG se establece en un valor truthy y el archivo de configuración (~/.aws/config o la ruta indicada por AWS_CONFIG_FILE) contiene una región para el perfil configurado, se usa esa región.