Buscar y cambiar la ubicación de los archivos config y credentials compartidos de los SDK y las herramientas de AWS - AWS SDKs y herramientas

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.

Buscar y cambiar la ubicación de los archivos config y credentials compartidos de los SDK y las herramientas de AWS

Los archivos config y AWS de credentials compartidos son archivos de texto sin formato que contienen información de configuración de los SDK y las herramientas de AWS. Los archivos residen localmente en su entorno y los utilizan automáticamente el código del SDK o los comandos de la AWS CLI que ejecuta en ese entorno. Por ejemplo, en su propia computadora o al desarrollar en una instancia de Amazon Elastic Compute Cloud.

Cuando se ejecuta el SDK o la herramienta, comprueba estos archivos y carga todos los ajustes de configuración disponibles. Si los archivos aún no existen, el SDK o la herramienta crea automáticamente un archivo básico.

De forma predeterminada, los archivos se encuentran en una carpeta con el nombre .aws que se encuentra en su carpeta home o en la de usuario.

Sistema operativo Ubicación y nombre predeterminados de los archivos
Linux y macOS

~/.aws/config

~/.aws/credentials

Windows

%USERPROFILE%\.aws\config

%USERPROFILE%\.aws\credentials

Resolución del directorio de inicio

~ solo se utiliza para la resolución del directorio principal cuando:

  • Inicia la ruta

  • Va seguido inmediatamente por / o un separador específico de la plataforma. En Windows, tanto ~/ como ~\ se resuelven en el directorio de inicio.

Al determinar el directorio de inicio, se comprueban las siguientes variables:

  • (Todas las plataformas) La variable de entorno HOME

  • (Plataformas Windows) La variable de entorno USERPROFILE

  • (Plataformas Windows) La concatenación de las variables de entorno HOMEDRIVE y HOMEPATH ($HOMEDRIVE$HOMEPATH)

  • (Opcional según el SDK o la herramienta) Una función o variable de resolución de la ruta de inicio específica del SDK o de la herramienta

Cuando sea posible, si el directorio principal de un usuario se especifica al principio de la ruta (por ejemplo, ~username/), se resuelve en el directorio principal del nombre de usuario solicitado (por ejemplo, /home/username/.aws/config).

Cambiar la ubicación predeterminada de estos archivos

Puede usar cualquiera de las siguientes opciones para anular el lugar desde el que el SDK o la herramienta cargan estos archivos.

Utilización de variables de entorno

Se pueden configurar las siguientes variables de entorno para cambiar la ubicación o el nombre de estos archivos del valor predeterminado a un valor personalizado:

  • config Variable de entorno de archivo: AWS_CONFIG_FILE

  • credentials Variable de entorno de archivo: AWS_SHARED_CREDENTIALS_FILE

Linux/macOS

Puede especificar una ubicación alternativa ejecutando los siguientes comandos de export en Linux o macOS.

$ export AWS_CONFIG_FILE=/some/file/path/on/the/system/config-file-name $ export AWS_SHARED_CREDENTIALS_FILE=/some/other/file/path/on/the/system/credentials-file-name
Windows

Puede especificar una ubicación alternativa ejecutando los siguientes comandos de setx en Windows.

C:\> setx AWS_CONFIG_FILE c:\some\file\path\on\the\system\config-file-name C:\> setx AWS_SHARED_CREDENTIALS_FILE c:\some\other\file\path\on\the\system\credentials-file-name

Para obtener más información acerca de la configuración del sistema con variables de entorno, consulte Uso de variables de entorno para configurar los SDK de AWS y las herramientas de forma global.

Uso de las propiedades del sistema JVM

Para el SDK de Kotlin que se ejecuta en JVM y el SDK de Java 2.x, puede configurar las siguientes propiedades del sistema JVM para cambiar la ubicación o el nombre de estos archivos del valor predeterminado a un valor personalizado:

  • Propiedad del sistema JVM del archivo config: aws.configFile

  • credentials Variable de entorno de archivo: aws.sharedCredentialsFile

Para obtener instrucciones sobre cómo configurar las propiedades del sistema JVM, consulte Cómo establecer propiedades del sistema JVM. El SDK para Java 1.x no admite estas propiedades del sistema.