Códigos de retorno de la línea de comandos en la AWS CLI

El código de retorno suele ser un código oculto enviado después de ejecutar un comando de la AWS Command Line Interface (AWS CLI) que describe el estado del comando. Puede utilizar el comando echo para mostrar el código enviado desde el último comando de la AWS CLI y utilice estos códigos para determinar si un comando se ha realizado correctamente y por qué un comando puede tener un error. Además de los códigos de retorno, puede ver más detalles sobre un error ejecutando sus comandos con el conmutador --debug. Este conmutador produce un informe detallado de los pasos que usa la AWS CLI para procesar el comando e indica cuál fue el resultado de cada paso.

Para determinar el código de devolución de un comando de la AWS CLI, ejecute uno de los siguientes comandos inmediatamente después de ejecutar el comando de la CLI.

Linux and macOS

$ echo $?
0

Windows PowerShell

PS> echo $lastexitcode
0

Windows Command Prompt

C:\> echo %errorlevel%
0

A continuación se indican los valores código de devolución que se pueden devolver al finalizar la ejecución de un comando de la AWS Command Line Interface (AWS CLI).

Código	Significado
0	El servicio respondió con un código de estado de respuesta HTTP de 200 que indica que AWS CLI no generó errores y el servicio de AWS al que se e‎nvía la solicitud.
1	Error en una o varias operaciones de transferencia de Amazon S3. Limitado a comandos de S3.
2	El significado de este código de devolución depende del comando: Aplicable a todos los comandos de AWS CLI: no se pudo analizar el comando introducido. Errores de análisis que pueden deberse, entre otras cosas, a falta de subcomandos o argumentos necesarios o al uso de comandos o argumentos desconocidos. Limitado a comandos S3: uno o más archivos marcados para transferencia durante el proceso de transferencia. Sin embargo, el resto de los archivos marcados para transferencia se han transferido correctamente. Los archivos que se omiten durante el proceso de transferencia pueden ser: archivos que no existen; archivos de dispositivos orientados a caracteres, dispositivos orientados a bloques, colas FIFO o sockets, y archivos para los que el usuario no tiene permiso de lectura.
130	El comando se ha visto interrumpido por SIGINT. Esta es la señal que usted envió para cancelar un comando con Ctrl+C.
252	La sintaxis del comando no era válida, se proporcionó un parámetro desconocido o había un valor de parámetro incorrecto que impidió que el comando se ejecutara.
253	El entorno o la configuración del sistema no eran válidos. Si bien el comando proporcionado puede ser válido en sentido sintáctico, la falta de configuración o credenciales impidió que el comando se ejecutara.
254	El comando se analizó correctamente y se realizó una solicitud al servicio especificado, pero el servicio devolvió un error. Esto por lo general indicará el uso incorrecto de la API u otros problemas específicos del servicio.
255	Error del comando. La AWS CLI o el servicio de AWS al que se había enviado la solicitud produjeron errores.