Ajustes de configuración general - SDK y herramientas de AWS

Ajustes de configuración general

nota

Para obtener ayuda para comprender el diseño de las páginas de configuración o para interpretar la tabla Soporte mediante herramientas y SDK de AWS que aparece a continuación, consulte Comprender las páginas de configuración de esta guía.

Los SDK admiten algunos ajustes generales que configuran los comportamientos generales del SDK.

Configure esta funcionalidad mediante lo siguiente:

api_versions: configuración de archivos config de AWS compartidos

Algunos servicios de AWS mantienen varias versiones de la API que son compatibles con versiones anteriores. De forma predeterminada, el SDK y las operaciones de la AWS CLI utilizan la última versión de API disponible. Si deseas solicitar una versión de API específica para utilizarla en tus solicitudes, incluye la configuración de las api_versions en tu perfil.

Valor predeterminado: ninguno. (El SDK utiliza la última versión API de forma predeterminada).

Valores válidos: es una configuración "anidada" que va seguida de una o varias líneas con sangría; cada una de ellas identifica un servicio de AWS y la versión de la API que se va a utilizar. Consulte la documentación del servicio de AWS para saber qué versiones de API están disponibles.

El ejemplo establece una versión de API específica para dos servicios de AWS del archivo config. Estas versiones de API se utilizan únicamente para los comandos que se ejecutan bajo el perfil que contiene estos ajustes. Los comandos de cualquier otro servicio utilizan la versión más reciente de la API de ese servicio.

api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
ca_bundle: configuración de archivos config de AWS compartidos
AWS_CA_BUNDLE: variable de entorno

Especifica la ruta a un paquete de certificados personalizado (un archivo con una extensión .pem) que debe utilizarse al establecer conexiones SSL/TLS.

Valor predeterminado: ninguno

Valores válidos: especifique la ruta completa o el nombre del archivo base. Si hay un nombre de archivo base, el sistema intentará encontrar el programa en las carpetas especificadas por la variable del entorno PATH.

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

[default] ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

Debido a las diferencias en la forma en que los sistemas operativos gestionan las rutas y los caracteres de escape de las rutas, a continuación se muestra un ejemplo de cómo configurar este valor en el archivo config en Windows:

[default] ca_bundle = C:\\Users\\username\\.aws\\aws-custom-bundle.pem

Ejemplo de configuración de variables de entorno en Linux/macOS mediante la línea de comandos:

export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pem

Ejemplo de configuración de variables de entorno en Windows mediante la línea de comandos:

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem
output: configuración de archivos config de AWS compartidos

Especifica el formato de los resultados en esta AWS CLI y en otros SDK y herramientas de AWS.

Valor predeterminado: json

Valores válidos:

  • json: la salida se formatea como una cadena JSON.

  • yaml: la salida se formatea como una cadena YAML.

  • yaml-stream: la salida se transmite y se formatea como una cadena YAML. La transmisión permite gestionar tipos de datos de gran tamaño de forma más rápida.

  • text – la salida tiene el formato de varias líneas de valores de cadena separados por tabuladores. Esto puede ser útil para pasar la salida a un procesador de texto, como grep, sed o awk.

  • table – el resultado tiene el formato de una tabla en la que se usan los caracteres +|- para los bordes de celda. Normalmente, la información se presenta en un formato que es más fácil de leer que los demás formatos, pero que no es útil para programar.

parameter_validation: configuración de archivos config de AWS compartidos

Especifica si el cliente del SDK o herramienta intenta validar parámetros antes de enviarlos al punto de conexión de servicio de AWS.

Valor predeterminado: true

Valores válidos:

  • true – el valor predeterminado. El SDK o la herramienta la realiza la validación de los parámetros de la línea de comandos en el lado del cliente. Esto ayuda al SDK o a la herramienta a confirmar que los parámetros son válidos y a detectar algunos errores. El SDK o la herramienta pueden rechazar las solicitudes que no sean válidas antes de enviarlas al punto de conexión del servicio AWS.

  • false: el SDK o herramienta no valida los parámetros de la línea de comandos antes de enviarlos al punto de conexión de servicio de AWS. El punto de conexión del servicio de AWS es responsable de validar todas las solicitudes y rechazar las que no sean válidas.

Soporte mediante SKD y herramientas de AWS

Los siguientes SDK admiten las características y los ajustes descritos en este tema. Se anotan todas las excepciones parciales. Todos los ajustes de propiedades del sistema JVM son compatibles con AWS SDK para Java y AWS SDK para Kotlin únicamente.

SDK Compatible Notas o más información
AWS CLI v2 Parcial api_versions no admitidas.
SDK para C++
SDK para Go V2 (1.x) Parcial Las api_versions y la parameter_validation no son compatibles.
SDK para Go 1.x (V1) Parcial Las api_versions y la parameter_validation no son compatibles. Para usar la configuración de archivos compartidos config, debe activar la carga desde el archivo de configuración; consulte Sesiones.
SDK para Java 2.x No
SDK para Java 1.x No
SDK para JavaScript 3.x
SDK para JavaScript 2.x
SDK de para Kotlin No
SDK para .NET 4.x No
SDK para .NET 3.x No
SDK para PHP 3.x
SDK para Python (Boto3)
SDK para Ruby 3.x
SDK de para Rust No
SDK de para Swift No
Herramientas para PowerShell V5 No
Herramientas para PowerShell V4 No