Solución de errores para la AWS CLI

Ejemplo de texto de error:

$ aws s3 copy
usage: aws [options] <command> <subcommand> [<subcommand> ...] [parameters]
To see help text, you can run:

  aws help
  aws <command> help
  aws <command> <subcommand> help
aws: error: argument subcommand: Invalid choice, valid choices are:

ls                                       | website                                 
cp                                       | mv                                      
....

Pueden producirse varios errores si su comando tiene un formato incorrecto o si está utilizando una versión anterior a la publicación de la característica. Para obtener más información sobre la resolución de errores en torno a estos dos problemas, consulte Compruebe su formato de comandos de la AWS CLI y Confirme que está ejecutando una versión reciente de la AWS CLI.

(Volver arriba)

Ejemplo de texto de error:

$ aws --version
command not found: aws

Si el comando aws no se encuentra después de instalar o actualizar la AWS CLI, es posible que tenga que reiniciar su terminal para que reconozca las actualizaciones de PATH.

(Volver arriba)

Ejemplo de texto de error:

$ aws --version
command not found: aws

Si no se puede encontrar el comando aws después de instalar o actualizar la AWS CLI, es posible que no se haya instalado completamente. Intente reinstalar siguiendo los pasos correspondientes a su plataforma en Instalación o actualización de la versión más reciente de AWS CLI.

(Volver arriba)

Si no se puede encontrar el comando aws después de instalar o actualizar la AWS CLI en Linux, es posible que no tenga permisos execute para la carpeta en la que se instaló. Ejecute el siguiente comando con el PATH a su instalación AWS CLI, para proporcionar permisos chmod para la AWS CLI:

$ sudo chmod -R 755 /usr/local/aws-cli/

(Volver arriba)

Ejemplo de texto de error:

$ aws --version
command not found: aws

Es posible que tenga que añadir el ejecutable aws a la variable de entorno PATH del sistema operativo. Para agregar AWS CLI a PATH, utilice las instrucciones siguientes correspondientes a su sistema operativo.

Si el comando aws muestra la versión incorrecta, es posible que tenga que reiniciar su terminal para que reconozca las actualizaciones de PATH. Todos los terminales abiertos deben estar cerrados, no solo el terminal activo.

(Volver arriba)

Si el comando aws muestra la versión incorrecta y el reinicio del terminal no funcionó, es posible que tenga que reiniciar el terminal para que reconozca las actualizaciones de PATH.

(Volver arriba)

Si ha actualizado la AWS CLI y ha utilizado un método de instalación diferente al de su instalación anterior, podría provocar la instalación de varias versiones. Por ejemplo, si en Linux o macOS ha utilizado pip para su instalación actual, pero ha intentado la actualización mediante el archivo de instalación de .pkg, esto podría causar algunos conflictos, especialmente con su PATH apuntando a la versión antigua.

Para resolver esto, desinstale todas las versiones de la AWS CLI y realice una instalación limpia.

Después de desinstalar todas las versiones, siga las instrucciones correspondientes a su sistema operativo para instalar la versión que desee de la AWS CLI versión 1 o la AWS CLI versión 2.

(Volver arriba)

Si el comando aws --version sigue funcionando, es posible que tenga que reiniciar su terminal para que reconozca las actualizaciones del terminal.

(Volver arriba)

Es posible que la AWS CLI no se desinstale correctamente si desinstaló la AWS CLI con un método diferente al que utilizó para instalarla, o si instaló varias versiones. Por ejemplo, si utilizó pip para su instalación actual, debe utilizar pip para desinstalarla. Para solucionarlo, desinstale AWS CLI con el mismo método que utilizó para instalarla.

(Volver arriba)

Dado que la AWS CLI se crea utilizando Python, la AWS CLI utiliza la biblioteca argparse de Python, incluido el argumento allow_abbrev. Las abreviaturas de los parámetros son reconocidas y procesadas por la AWS CLI.

El siguiente comando de ejemplo create-change-set cambia el nombre de la pila de CloudFormation. El parámetro --change-set-n se reconoce como una abreviatura de --change-set-name y la AWS CLI procesa el comando.

$ aws cloudformation create-change-set --stack-name my-stack --change-set-n my-change-set

Cuando su abreviatura pueda ser varios comandos, el parámetro no se reconocerá como abreviatura.

El siguiente comando de ejemplo create-change-set cambia el nombre de la pila de CloudFormation. El parámetro --change-set- no se reconoce como una abreviatura, ya que existen múltiples parámetros de los que podría ser una abreviatura, como --change-set-name y --change-set-type. Por lo tanto la AWS CLI no procesa el comando.

$ aws cloudformation create-change-set --stack-name my-stack --change-set- my-change-set

$ aws ec2 describe-vpc-peering-connections \
    --filters Name=tag:TagName,Values=VpcPeeringConnection \
    --filter Name=status-code,Values=active 

(Volver arriba)

En Linux o macOS, asegúrese de que el programa aws tiene permisos de ejecución para el usuario que realiza la llamada. Normalmente, los permisos se establecen en 755.

Para añadir permisos de ejecución al usuario, ejecute el siguiente comando sustituyendo ~ /.local/bin/aws por la ruta que tiene el programa en el equipo.

$ chmod +x ~/.local/bin/aws

(Volver arriba)

Ejemplo de texto de error:

$ aws s3 ls
An error occurred (AcessDenied) when calling the ListBuckets operation: Access denied.

Cuando ejecuta un comando de la AWS CLI, las operaciones de AWS se realizan en su nombre, utilizando credenciales que lo asocian a un rol o cuenta de IAM. Las políticas asociadas deben concederle permiso para llamar a las acciones de la API correspondientes a los comandos que ejecuta con la AWS CLI.

La mayoría de los comandos llaman a una única acción que tiene un nombre que coincide con el nombre del comando. Sin embargo, los comandos personalizados como aws s3 sync llamar a múltiples API. Mediante la --debug opción puede ver a qué API llama un comando.

Si sabe con seguridad que el usuario o rol tiene los permisos adecuados asignados por la política, compruebe que el comando de la AWS CLI utiliza las credenciales que espera. Consulte la siguiente sección sobre credenciales para verificar que las credenciales que utiliza la AWS CLI son las adecuadas.

Para obtener más información acerca de la asignación de permisos de IAM, consulte Información general sobre la administración del acceso: permisos y políticas en la Guía del usuario de IAM.

(Volver arriba)

Puede que la AWS CLI esté leyendo las credenciales desde un lugar diferente al que espera, o que la información de su par de claves sea incorrecta. Puede ejecutar aws configure list para confirmar las credenciales que se utilizan.

En el siguiente ejemplo se muestra cómo comprobar las credenciales utilizadas para el perfil predeterminado.

$ aws configure list
      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                <not set>             None    None
access_key     ****************XYVA shared-credentials-file
secret_key     ****************ZAGY shared-credentials-file
    region                us-west-2      config-file    ~/.aws/config

En el siguiente ejemplo se muestra cómo comprobar las credenciales de un perfil con nombre.

$ aws configure list --profile saanvi
      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                    saanvi           manual    --profile
access_key         **************** shared-credentials-file
secret_key         **************** shared-credentials-file
    region                us-west-2      config-file    ~/.aws/config

Para confirmar los detalles de su par de claves, compruebe sus archivos config y credentials. Para obtener más información sobre los archivos config y ‎credentials, consulte ‎Opciones de los archivos de configuración y credenciales en la AWS CLI. Para obtener más información sobre credenciales y autenticación, incluida la precedencia de las credenciales, consulte Credenciales de autenticación y acceso para la AWS CLI.

(Volver arriba)

Si está utilizando credenciales válidas, puede que el reloj no esté sincronizado. En Linux o macOS, ejecute date para verificar la hora.

$ date

Si el reloj del sistema no es correcto en unos minutos, utilice ntpd para sincronizarlo.

$ sudo service ntpd stop
$ sudo ntpdate time.nist.gov
$ sudo service ntpd start
$ ntpstat

En Windows, utilice las opciones de fecha y hora del Panel de control para configurar el reloj del sistema.

(Volver arriba)

Para protegerse de los ataques de reproducción, puede utilizar la hora actual durante el proceso de cifrado y descifrado. Si la hora del cliente y el servidor no coinciden en una cantidad superior a la permitida, puede que el proceso produzca un error y se rechace la solicitud. Esto también puede ocurrir cuando ejecuta un comando en una máquina virtual cuyo reloj no está sincronizado con el reloj de la máquina host. Una causa posible es cuando la máquina virtual está en hibernación y tarda algún tiempo en reactivarse para sincronizar el reloj con la máquina host.

En Linux o macOS, ejecute date para verificar la hora.

$ date

Si el reloj del sistema no es correcto en unos minutos, utilice ntpd para sincronizarlo.

$ sudo service ntpd stop
$ sudo ntpdate time.nist.gov
$ sudo service ntpd start
$ ntpstat

En Windows, utilice las opciones de fecha y hora del Panel de control para configurar el reloj del sistema.

(Volver arriba)

Si las claves de AWS incluyen determinados caracteres especiales, como -, +, / o %, algunas variantes del sistema operativo procesan la cadena de forma incorrecta y hacen que la cadena de clave se interprete incorrectamente.

Si procesa las claves utilizando otras herramientas o scripts, como herramientas que compilan el archivo de credenciales en una nueva instancia cuando se crea, esas herramientas y scripts podrían tratar los caracteres especiales de forma distinta, lo que hace que se transformen en algo que AWS ya no reconoce.

Sugerimos regenerar la clave secreta para obtener una que no incluya el carácter especial que causa problemas.

(Volver arriba)

Ejemplo de texto de error:

$ aws s3 ls
[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed

Cuando utiliza un comando de AWS CLI, se recibe un mensaje de error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed. Esto se produce porque AWS CLI no confía en el certificado del proxy debido a que ciertos factores como el certificado del proxy están autofirmados, con su empresa establecida como la entidad de certificación (CA). Esto evita que la AWS CLI encuentre el certificado raíz de la CA de su empresa en el registro local de CA.

Para solucionarlo, indíquele a la AWS CLI dónde encontrar el archivo .pem de su empresa utilizando el ajuste de archivo de configuración del ca_bundle, la opción de línea de comandos de --ca-bundle o la variable de entorno de AWS_CA_BUNDLE.

(Volver arriba)

Ejemplo de texto de error:

$ aws s3 ls
SSL validation failed for regionname [Errno 2] No such file or directory

Esto se debe a que la ubicación del archivo del paquete de la autoridad de certificación (CA) está configurada incorrectamente en la AWS CLI. Para solucionarlo, confirme dónde se encuentra su archivo .pem de su empresa y actualice la configuración de la AWS CLI mediante la opción del archivo de configuración ca_bundle, la opción de la línea de comandos --ca-bundle o la variable de entorno AWS_CA_BUNDLE.

(Volver arriba)

Ejemplo de texto de error:

$ aws s3 ls
[SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed

Se pueden producir errores o resultados inesperados si un Servicio de AWS no está disponible para la Región de AWS especificada o si los recursos están ubicados en una Región de AWS diferente. Para ver los pasos de solución de problemas, consulte Compruebe la Región de AWS que utiliza su comando de la AWS CLI..

(Volver arriba)

Ejemplo de texto de error:

$ aws s3 ls
[SSL: UNSAFE_LEGACY_RENEGOTIATION_DISABLED] unsafe legacy renegotiation disabled

El Servicio de AWS utiliza una versión de TLS que no es compatible con la versión de TLS de su dispositivo. Para resolver este problema, actualice a una versión de TLS compatible. Para obtener más información, consulte Aplicación de una versión de TLS mínima para la AWS CLI.

(Volver arriba)

Confirme que ha introducido un JSON válido para el comando. Le sugerimos que utilice un validador de JSON para el JSON con problemas de formato.

Para conocer un uso más avanzado de JSON en la línea de comandos, considere usar un procesador JSON de línea de comandos, comojq, para crear cadenas JSON. Para obtener más información sobre jq, consulte el repositorio jq en GitHub.

(Volver arriba)

Antes de que la AWS CLI reciba cualquier cosa de un comando, su terminal procesa el comando utilizando sus propias reglas de entrecomillado y escapes. Debido a las reglas de formato de un terminal, es posible que parte del contenido JSON se elimine antes de que el comando se pase a la AWS CLI. Al formular comandos, asegúrese de usar sus reglas de entrecomillado del terminal.

Para solucionar problemas, utilice el comando echo para ver cómo el shell gestiona los parámetros:

$ echo {"ReadCapacityUnits":15,"WriteCapacityUnits":10}
ReadCapacityUnits:15 WriteCapacityUnits:10

$ echo '{"ReadCapacityUnits":15,"WriteCapacityUnits":10}'
{"ReadCapacityUnits":15,"WriteCapacityUnits":10}

Modifique su comando hasta que se devuelva su JSON válido.

Para obtener una solución más detallada, use el parámetro --debug para ver los registros de depuración, ya que muestran exactamente lo que se pasó a la AWS CLI:

$ aws dynamodb update-table \
    --provisioned-throughput '{"ReadCapacityUnits":15,WriteCapacityUnits":10}' \
    --table-name MyDDBTable \
    --debug
2022-07-19 22:25:07,741 - MainThread - awscli.clidriver - DEBUG - CLI version: aws-cli/1.18.147 
Python/2.7.18 Linux/5.4.196-119.356.amzn2int.x86_64 botocore/1.18.6
2022-07-19 22:25:07,741 - MainThread - awscli.clidriver - DEBUG - Arguments entered to CLI: 
['dynamodb', 'update-table', '--provisioned-throughput', '{"ReadCapacityUnits":15,WriteCapacityUnits":10}',
 '--table-name', 'MyDDBTable', '--debug']

Use las reglas de entrecomillado de tu terminal para solucionar cualquier problema que tenga su entrada JSON cuando se envía a la AWS CLI. Para obtener más información sobre las reglas de entrecomillado, consulte Entrecomillado de cadenas y uso de literales en la AWS CLI.

(Volver arriba)