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 para el AWS SDK para Ruby

Puede acceder a Servicios de AWS que operan en un área geográfica específica mediante Regiones de AWS. Esto puede ser útil para evitar redundancias y para que sus datos y aplicaciones se ejecuten cerca del lugar desde donde usted y los usuarios obtendrán acceso a ellos.

Debe establecer una Región de AWS predeterminada para que el SDK para Ruby lo use para solicitudes de AWS. Este valor predeterminado se usa para las llamadas al método de servicio del SDK que no tiene especificadas una región.

Para obtener más información sobre la configuración de region, consulte Región de AWS en la Guía de referencia de las herramientas y los SDK de AWS. También incluye ejemplos sobre cómo establecer la región predeterminada mediante el archivo config de AWS compartido o las variables de entorno.

Orden de búsqueda de regiones para la resolución

Debe configurar una región cuando se utiliza la mayoría de los Servicios de AWS. AWS SDK para Ruby busca una región en el orden que se indica a continuación:

Cómo configurar la región

En esta sección se describen diferentes maneras de configurar una región, comenzando por el enfoque más común.

Configuración de la región mediante el archivo compartido config

Defina la región configurando la variable region en el archivo compartido config de AWS. Para obtener más información sobre el archivo compartido config, consulte Archivos de configuración y credenciales compartidos en la Guía de referencia de las herrramientas y los SDK de AWS.

Ejemplo de configuración de este valor en el archivo config:

[default]
region = us-west-2

El archivo compartido config no se comprueba si la variable de entorno AWS_SDK_CONFIG_OPT_OUT está configurada.

Configuración de la región mediante variables de entorno

Configure la región mediante estableciendo la variable de entorno AWS_REGION.

Use el comando export para establecer esta variable en sistemas basados en Unix, como Linux o macOS. En el siguiente ejemplo se establece la región en us-west-2.

export AWS_REGION=us-west-2

Para establecer esta variable en Windows, utilice el comando set. En el siguiente ejemplo se establece la región en us-west-2.

set AWS_REGION=us-west-2

Configuración de la región con Aws.config

Configure la región añadiendo un valor region en el hash Aws.config. En el siguiente ejemplo se actualiza el hash Aws.config para utilizar la región us-west-1.

Aws.config.update({region: 'us-west-1'})

Todos los clientes o recursos que cree posteriormente estarán asociados a esta región.

Configuración de la región en un objeto de recurso

Configure la región al crear un cliente o recurso de AWS. En el siguiente ejemplo se crea un objeto de recurso de Amazon S3; en la región us-west-1. Elija la región correcta para sus recursos de AWS. Un objeto de cliente de servicio es inmutable, por lo que debe crear un cliente nuevo para cada servicio al que realice solicitudes y para realizar solicitudes al mismo servicio con una configuración diferente.

s3 = Aws::S3::Resource.new(region: 'us-west-1')