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 archivosconfigde 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_versionsen 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-01cloudfront =2015-09-017 ca_bundle: configuración de archivosconfigde AWS compartidosAWS_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.pemDebido 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
configen Windows:[default] ca_bundle =C:\\Users\\username\\.aws\\aws-custom-bundle.pemEjemplo 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.pemEjemplo de configuración de variables de entorno en Windows mediante la línea de comandos:
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output: configuración de archivosconfigde AWS compartidos-
Especifica el formato de los resultados en esta AWS CLI y en otros SDK y herramientas de AWS.
Valor predeterminado:
jsonValores válidos:
-
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, comogrep,sedoawk. -
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 archivosconfigde 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:
trueValores 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++ | Sí | |
| 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 | Sí | |
| SDK para JavaScript 2.x | Sí | |
| SDK de para Kotlin | No | |
| SDK para .NET 4.x | No | |
| SDK para .NET 3.x | No | |
| SDK para PHP 3.x | Sí | |
| SDK para Python (Boto3) |
Sí | |
| SDK para Ruby 3.x | Sí | |
| SDK de para Rust | No | |
| SDK de para Swift | No | |
| Herramientas para PowerShell V5 | No | |
| Herramientas para PowerShell V4 | No |