AWS cli documentation change
Summary
Updated CLI version references from 1.40.40 to 2.27.42, removed deprecation notice for CLI v1, rephrased return code descriptions, and added new specific error codes (252-254) with clearer explanations
Security assessment
The change adds documentation about error code 253 ('missing configuration or credentials'), which relates to security configuration. However, there's no evidence this addresses a specific vulnerability - it improves clarity around existing security-related error scenarios.
Diff
diff --git a/cli/latest/topic/return-codes.md b/cli/latest/topic/return-codes.md index 784a2c5d2..246e6ab25 100644 --- a//cli/latest/topic/return-codes.md +++ b//cli/latest/topic/return-codes.md @@ -15 +15 @@ - * [AWS CLI 1.40.40 Command Reference](../index.html) » + * [AWS CLI 2.27.42 Command Reference](../index.html) » @@ -41,6 +40,0 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c -### Note: - -You are viewing the documentation for an older major version of the AWS CLI (version 1). - -AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click [here](https://awscli.amazonaws.com/v2/documentation/api/latest/topic/return-codes.html). For more information see the AWS CLI version 2 [installation instructions](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) and [migration guide](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration.html). - @@ -53 +47 @@ These are the following return codes returned at the end of execution of a CLI c - * `0` – The service responded with an HTTP response status code of 200 and there were no errors from either the CLI or the service the request was made to. + * `0` – Command was successful. There were no errors thrown by either the CLI or by the service the request was made to. @@ -61 +55 @@ The primary meaning is that the command entered on the command line failed to be -The other meaning is only applicable to `s3` commands. It can mean at least one or more files marked for transfer were skipped during the transfer process. However, all other files marked for transfer were successfully transferred. Files that are skipped during the transfer process include: files that do not exist, files that are character special devices, block special device, FIFO’s, or sockets, and files that the user cannot read from. +The other meaning is only applicable to `s3` commands. It can mean at least one or more files marked for transfer were skipped during the transfer process. However, all other files marked for transfer were successfully transferred. Files that are skipped during the transfer process include: files that do not exist, files that are character special devices, block special device, FIFOs, or sockets, and files that the user cannot read from. @@ -65 +59,7 @@ The other meaning is only applicable to `s3` commands. It can mean at least one - * `255` – Command failed. There were errors from either the CLI or the service the request was made to. + * `252` – Command syntax was invalid, an unknown parameter was provided, or a parameter value was incorrect and prevented the command from running. + + * `253` – The system environment or configuration was invalid. While the command provided may be syntactically valid, missing configuration or credentials prevented the command from running. + + * `254` – The command was successfully parsed and a request was made to the specified service but the service returned an error. This will generally indicate incorrect API usage or other service specific issues. + + * `255` – General catch-all error. The command may have parsed correctly but an unspecified runtime error occurred when running the command. Because this is a general error code, an error may change from 255 to a more specific return code. A return code of 255 should not be relied on to determine a specific error case. @@ -116 +116 @@ Output (if successful): - * [AWS CLI 1.40.40 Command Reference](../index.html) » + * [AWS CLI 2.27.42 Command Reference](../index.html) » @@ -120,0 +121,2 @@ Output (if successful): + +© Copyright 2025, Amazon Web Services. Created using [Sphinx](https://www.sphinx-doc.org/).