**本文件 AWS CLI 僅適用於第 1 版。** 我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 [公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。如需第 2 版的相關文件 AWS CLI，請參閱第 [2 版使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 故障診斷的錯誤 AWS CLI 本節介紹常見錯誤和解決問題時應遵循的故障診斷步驟。我們建議先遵循[一般故障診斷](#tshoot-general)。 **Contents** + [先嘗試的一般故障診斷](#tshoot-general) + [檢查您的 AWS CLI 命令格式](#general-formatting) + [檢查您的 AWS 區域 AWS CLI 命令正在使用](#general-region) + [確認您執行的是最新版本的 AWS CLI](#general-latest) + [設定 `--debug` 選項](#general-debug) + [啟用和檢閱 AWS CLI 命令歷史記錄日誌](#tshoot-general-history) + [確認您的 AWS CLI 已設定](#tshoot-general-config) + [命令未找到錯誤](#tshoot-install-not-found) + [「`aws --version`」命令傳回的版本與您安裝的版本不同](#tshoot-install-wrong-version) + [解除安裝後，「`aws --version`」命令會傳回版本 AWS CLI](#tshoot-uninstall-1) + [已 AWS CLI 處理參數名稱不完整的命令](#tshoot-parameter-abbrev) + [存取遭拒錯誤](#tshoot-access-denied) + [無效的憑證和金鑰錯誤](#tshoot-permissions-wrongcreds) + [簽章不相符錯誤](#tshoot-signature-does-not-match) + [未找到 Windows 控制台錯誤](#tshoot-no-windows-console-found) + [SSL 憑證錯誤](#tshoot-certificate-verify-failed) + [JSON 無效錯誤](#tshoot-invalid-json) + [其他資源](#tshoot-resources) ## 先嘗試的一般故障診斷如果您收到錯誤或遇到問題 AWS CLI，我們建議您使用下列一般提示來協助您進行故障診斷。 [回到頁首](#cli-chap-troubleshooting-top) ### 檢查您的 AWS CLI 命令格式如果您收到錯誤，指出命令不存在，或無法辨識文件表示可用的參數 (`Parameter validation failed`)，則您的命令格式可能不正確。我們建議您檢查以下內容： + 檢查您的命令是否有拼寫和格式錯誤。 + 確認所有的[引號和逸出適合您的終端機](cli-usage-parameters-quoting-strings.md)在您的命令中是正確的。 + 產生 [AWS CLI 骨架](cli-usage-skeleton.md)以確認您的命令結構。 + 對於 JSON，請另參閱 [JSON 值故障診斷](#tshoot-invalid-json)。如果您在終端處理 JSON 格式時遇到問題，我們建議透過使用 [Blob 將 JSON 資料直接傳遞至 AWS CLI](cli-usage-parameters-types.md#parameter-type-blob)，以跳過終端機的引用規則。如需如何建構特定命令的詳細資訊，請參閱[AWS CLI 參考指南](https://docs.aws.amazon.com/cli/v1/reference/)第。 [回到頁首](#cli-chap-troubleshooting-top) ### 檢查您的 AWS 區域 AWS CLI 命令正在使用 **注意** 使用 AWS 區域時 AWS CLI，您必須明確或透過設定預設區域來指定。如需 AWS 區域您可以指定之所有的清單，請參閱《》中的[AWS 區域和端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)*Amazon Web Services 一般參考*。所使用的 AWS 區域指標 AWS CLI 與您在 AWS 管理主控台 URLs和服務端點中看到的名稱相同。如果您指定的 AWS 服務無法使用，或您的資源位於不同的，則可能會發生錯誤 AWS 區域或非預期的結果 AWS 區域。依優先順序， AWS 區域會以下列方式設定： + `--region` 命令列選項。 + `AWS\$1DEFAULT\$1REGION` 環境變數。 + [`region`](cli-configure-files.md#cli-config-region) 設定檔設定。確認您使用 AWS 區域正確的資源。 [回到頁首](#cli-chap-troubleshooting-top) ### 確認您執行的是最新版本的 AWS CLI 如果您收到錯誤，指出命令不存在，或無法辨識[AWS CLI 參考指南](https://docs.aws.amazon.com/cli/v1/reference/)第指出可用的參數，請先確認您的命令格式正確。如果格式正確，我們建議您升級到最新版本的 AWS CLI。更新版本的 AWS CLI 幾乎會在每個工作天發行。新的 AWS 服務、功能和參數會在這些新版本的中推出 AWS CLI。要存取這些新服務、功能或參數的唯一方法，就是升級到該元素首次推出之後所發行的版本。如何更新的版本 AWS CLI ，取決於您最初的安裝方式，如中所述[安裝、更新和解除安裝 AWS CLI](cli-chap-install.md)。如果您使用其中一個隨附的安裝程式，您可能需要移除現有的安裝，然後下載並安裝適用於您作業系統的最新版本安裝程式。 [回到頁首](#cli-chap-troubleshooting-top) ### 設定 `--debug` 選項當 AWS CLI 回報您未立即了解的錯誤，或產生您未預期的結果時，您可以使用 `--debug`選項再次執行命令，以取得有關錯誤的詳細資訊。使用此選項時， AWS CLI 會輸出有關處理命令所需的每個步驟的詳細資訊。輸出中的詳細資訊可協助您判斷錯誤發生在哪個步驟，以及可提供觸發錯誤的線索內容。您可以將輸出傳送到文字檔案，以供日後檢閱，或在收到要求時將其傳送給 AWS 支援。當您包含 `--debug` 選項時，所包括的部分詳細資訊為： + 正在尋找的憑證 + 正在剖析所提供的參數 + 建構傳送至 AWS 伺服器的請求 + 傳送至的請求內容 AWS + 原始回應的內容 + 格式化的輸出以下是使用和不使用 `--debug` 選項執行命令的範例。 ``` $ aws iam list-groups --profile MyTestProfile { "Groups": [ { "Path": "/", "GroupName": "MyTestGroup", "GroupId": "AGPA0123456789EXAMPLE", "Arn": "arn:aws:iam::123456789012:group/MyTestGroup", "CreateDate": "2019-08-12T19:34:04Z" } ] } ``` ``` $ aws iam list-groups --profile MyTestProfile --debug 2019-08-12 12:36:18,305 - MainThread - awscli.clidriver - DEBUG - CLI version: aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205 2019-08-12 12:36:18,305 - MainThread - awscli.clidriver - DEBUG - Arguments entered to CLI: ['iam', 'list-groups', '--debug'] 2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,307 - MainThread - botocore.credentials - DEBUG - Skipping environment variable credential check because profile name was explicitly set. 2019-08-12 12:36:18,307 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,308 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/service-2.json 2019-08-12 12:36:18,317 - MainThread - botocore.hooks - DEBUG - Event building-command-table.iam: calling handler 2019-08-12 12:36:18,320 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/waiters-2.json 2019-08-12 12:36:18,321 - MainThread - awscli.clidriver - DEBUG - OrderedDict([('path-prefix', ), ('marker', ), ('max-items', )]) 2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,326 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/paginators-1.json 2019-08-12 12:36:18,326 - MainThread - awscli.customizations.paginate - DEBUG - Modifying paging parameters for operation: ListGroups 2019-08-12 12:36:18,326 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,326 - MainThread - botocore.hooks - DEBUG - Event before-building-argument-table-parser.iam.list-groups: calling handler > 2019-08-12 12:36:18,327 - MainThread - botocore.hooks - DEBUG - Event before-building-argument-table-parser.iam.list-groups: calling handler > 2019-08-12 12:36:18,327 - MainThread - botocore.hooks - DEBUG - Event operation-args-parsed.iam.list-groups: calling handler functools.partial(, ['marker', 'max-items'], {'max-items': }, OrderedDict([('path-prefix', ), ('marker', ), ('max-items', ), ('cli-input-json', ), ('starting-token', ), ('page-size', ), ('generate-cli-skeleton', )])) 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.path-prefix: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.marker: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.max-items: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.cli-input-json: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.starting-token: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.page-size: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.generate-cli-skeleton: calling handler 2019-08-12 12:36:18,329 - MainThread - botocore.hooks - DEBUG - Event calling-command.iam.list-groups: calling handler > 2019-08-12 12:36:18,329 - MainThread - botocore.hooks - DEBUG - Event calling-command.iam.list-groups: calling handler > 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: assume-role 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: assume-role-with-web-identity 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: shared-credentials-file 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - INFO - Found credentials in shared credentials file: ~/.aws/credentials 2019-08-12 12:36:18,330 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/endpoints.json 2019-08-12 12:36:18,334 - MainThread - botocore.hooks - DEBUG - Event choose-service-name: calling handler 2019-08-12 12:36:18,337 - MainThread - botocore.hooks - DEBUG - Event creating-client-class.iam: calling handler 2019-08-12 12:36:18,337 - MainThread - botocore.regions - DEBUG - Using partition endpoint for iam, us-west-2: aws-global 2019-08-12 12:36:18,337 - MainThread - botocore.args - DEBUG - The s3 config key is not a dictionary type, ignoring its value of: None 2019-08-12 12:36:18,340 - MainThread - botocore.endpoint - DEBUG - Setting iam timeout as (60, 60) 2019-08-12 12:36:18,341 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/_retry.json 2019-08-12 12:36:18,341 - MainThread - botocore.client - DEBUG - Registering retry handlers for service: iam 2019-08-12 12:36:18,342 - MainThread - botocore.hooks - DEBUG - Event before-parameter-build.iam.ListGroups: calling handler 2019-08-12 12:36:18,342 - MainThread - botocore.hooks - DEBUG - Event before-call.iam.ListGroups: calling handler 2019-08-12 12:36:18,343 - MainThread - botocore.endpoint - DEBUG - Making request for OperationModel(name=ListGroups) with params: {'url_path': '/', 'query_string': '', 'method': 'POST', 'headers': {'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8', 'User-Agent': 'aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205'}, 'body': {'Action': 'ListGroups', 'Version': '2010-05-08'}, 'url': 'https://iam.amazonaws.com/', 'context': {'client_region': 'aws-global', 'client_config': , 'has_streaming_input': False, 'auth_type': None}} 2019-08-12 12:36:18,343 - MainThread - botocore.hooks - DEBUG - Event request-created.iam.ListGroups: calling handler > 2019-08-12 12:36:18,343 - MainThread - botocore.hooks - DEBUG - Event choose-signer.iam.ListGroups: calling handler 2019-08-12 12:36:18,343 - MainThread - botocore.auth - DEBUG - Calculating signature using v4 auth. 2019-08-12 12:36:18,343 - MainThread - botocore.auth - DEBUG - CanonicalRequest: POST / content-type:application/x-www-form-urlencoded; charset=utf-8 host:iam.amazonaws.com x-amz-date:20190812T193618Z content-type;host;x-amz-date 5f776d91EXAMPLE9b8cb5eb5d6d4a787a33ae41c8cd6eEXAMPLEca69080e1e1f 2019-08-12 12:36:18,344 - MainThread - botocore.auth - DEBUG - StringToSign: AWS4-HMAC-SHA256 20190812T193618Z 20190812/us-east-1/iam/aws4_request ab7e367eEXAMPLE2769f178ea509978cf8bfa054874b3EXAMPLE8d043fab6cc9 2019-08-12 12:36:18,344 - MainThread - botocore.auth - DEBUG - Signature: d85a0EXAMPLEb40164f2f539cdc76d4f294fe822EXAMPLE18ad1ddf58a1a3ce7 2019-08-12 12:36:18,344 - MainThread - botocore.endpoint - DEBUG - Sending http request: 2019-08-12 12:36:18,344 - MainThread - urllib3.util.retry - DEBUG - Converted retries value: False -> Retry(total=False, connect=None, read=None, redirect=0, status=None) 2019-08-12 12:36:18,344 - MainThread - urllib3.connectionpool - DEBUG - Starting new HTTPS connection (1): iam.amazonaws.com:443 2019-08-12 12:36:18,664 - MainThread - urllib3.connectionpool - DEBUG - https://iam.amazonaws.com:443 "POST / HTTP/1.1" 200 570 2019-08-12 12:36:18,664 - MainThread - botocore.parsers - DEBUG - Response headers: {'x-amzn-RequestId': '74c11606-bd38-11e9-9c82-559da0adb349', 'Content-Type': 'text/xml', 'Content-Length': '570', 'Date': 'Mon, 12 Aug 2019 19:36:18 GMT'} 2019-08-12 12:36:18,664 - MainThread - botocore.parsers - DEBUG - Response body: b'\n \n false\n \n \n /\n MyTestGroup\n arn:aws:iam::123456789012:group/MyTestGroup\n AGPA1234567890EXAMPLE\n 2019-08-12T19:34:04Z\n \n \n \n \n 74c11606-bd38-11e9-9c82-559da0adb349\n \n\n' 2019-08-12 12:36:18,665 - MainThread - botocore.hooks - DEBUG - Event needs-retry.iam.ListGroups: calling handler 2019-08-12 12:36:18,665 - MainThread - botocore.retryhandler - DEBUG - No retry needed. 2019-08-12 12:36:18,665 - MainThread - botocore.hooks - DEBUG - Event after-call.iam.ListGroups: calling handler { "Groups": [ { "Path": "/", "GroupName": "MyTestGroup", "GroupId": "AGPA123456789012EXAMPLE", "Arn": "arn:aws:iam::123456789012:group/MyTestGroup", "CreateDate": "2019-08-12T19:34:04Z" } ] } ``` [回到頁首](#cli-chap-troubleshooting-top) ### 啟用和檢閱 AWS CLI 命令歷史記錄日誌您可以使用 `cli\$1history` 檔案設定來啟用 AWS CLI 命令歷史記錄日誌。啟用此設定後，會 AWS CLI 記錄 `aws` 命令的歷史記錄。您可以使用 `aws history list` 命令來列出歷史記錄，並且在 `aws history show` 命令中使用產生的 command\$1ids 取得詳細資訊。如需詳細資訊，請參閱 *AWS CLI 參考指南*中的 [https://docs.aws.amazon.com/cli/v1/reference/history/index.html](https://docs.aws.amazon.com/cli/v1/reference/history/index.html)。當您包含 `--debug` 選項時，所包括的部分詳細資訊為： + 對 botocore 執行的 API 呼叫 + 狀態碼 + HTTP 回應 + 標頭 + 傳回碼您可以使用此資訊來確認參數資料和 API 呼叫以您預期的方式運作，然後推斷出您的命令在過程中的哪個步驟失敗。 [回到頁首](#cli-chap-troubleshooting-top) ### 確認您的 AWS CLI 已設定如果您的 `config` 和 `credentials` 檔案或您的 IAM 使用者或角色未正確配置，可能會出現各種錯誤。有關解決 `config` 和 `credentials` 檔案或您的 IAM 使用者或角色等錯誤的詳細資訊，請參閱 [存取遭拒錯誤](#tshoot-access-denied) 和 [無效的憑證和金鑰錯誤](#tshoot-permissions-wrongcreds)。 [回到頁首](#cli-chap-troubleshooting-top) ## 命令未找到錯誤此錯誤表示作業系統找不到 AWS CLI 命令。安裝可能不完整或需要更新。 **可能原因：您嘗試使用比已安裝版本更新的 AWS CLI 功能，或格式不正確** *範例錯誤文字：* ``` $ aws s3 copy aws: [ERROR]: argument operation: Found invalid choice 'copy' usage: aws [options] [ ...] [parameters] To see help text, you can run: aws help aws help aws help ``` 如果您的命令格式不正確，或者您使用的是該功能發佈之前的早期版本，則可能會出現各種錯誤。若要解決圍繞這兩個問題的錯誤的詳細資訊，請參閱[檢查您的 AWS CLI 命令格式](#general-formatting)和[確認您執行的是最新版本的 AWS CLI](#general-latest)。 [回到頁首](#cli-chap-troubleshooting-top) **可能的原因：安裝後需要重新啟動終端機** *範例錯誤文字：* ``` $ aws --version command not found: aws ``` 如果在第一次安裝或更新後找不到 `aws`命令 AWS CLI，您可能需要重新啟動終端機，才能辨識任何`PATH`更新。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因： AWS CLI 未完全安裝** *範例錯誤文字：* ``` $ aws --version command not found: aws ``` 如果在第一次安裝或更新後找不到`aws`命令 AWS CLI，則可能尚未完全安裝。請遵循 [安裝、更新和解除安裝 AWS CLI](cli-chap-install.md) 中適用於您平台的步驟，嘗試重新安裝。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因： AWS CLI 沒有許可 (Linux)** 如果在第一次 AWS CLI 在 Linux 上安裝或更新之後找不到 `aws`命令，則可能沒有其安裝所在資料夾的`execute`許可。使用 AWS CLI 安裝`PATH`的執行下列命令，以提供 `[chmod](https://en.wikipedia.org/wiki/Chmod)`許可 AWS CLI： ``` $ sudo chmod -R 755 /usr/local/aws-cli/ ``` [回到頁首](#cli-chap-troubleshooting-top) **可能原因：安裝期間作業系統的 `PATH` 未更新。** *範例錯誤文字：* ``` $ aws --version command not found: aws ``` 您可能需要將 `aws` 可執行檔新增到作業系統的 `PATH` 環境變數中。若要將 AWS CLI 新增至您的 `PATH`，請針對您的作業系統使用下列指示。 1. 在您的使用者目錄中尋找 Shell 的描述檔命令碼。如果您不確定您擁有哪個 Shell，請執行 `echo $SHELL`。 ``` $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads ``` + **Bash** – `.bash_profile`、`.profile` 或 `.bash_login` + **Zsh** – `.zshrc` + **Tcsh** – `.tcshrc`、`.cshrc` 或 `.login` 1. 將匯出命令新增至您的描述檔指令碼。以下命令將您的本地 bin 新增至目前的 `PATH` 變數。 ``` export PATH=/usr/local/bin:$PATH ``` 1. 將更新過的設定檔載入到您目前的工作階段。 ``` $ source ~/.bash_profile ``` 1. 在 Windows 命令提示符下，使用 `where` 命令與 `/R path` 參數來尋找 `aws` 檔案位置。結果將傳回所有包含 `aws` 的資料夾。 ``` C:\> where /R c:\ aws c:\Program Files\Amazon\AWSCLIV2\aws.exe ... ``` 根據預設，第 2 AWS CLI 版位於： ``` c:\Program Files\Amazon\AWSCLIV2\aws.exe ``` 1. 按下 Windows 鍵並輸入 **environment variables**。 1. 從建議清單中，選擇**Edit environment variables for your account (編輯您帳戶的環境變數)**。 1. 選擇 **PATH**，然後選擇 **Edit (編輯)**。 1. 將您在第一個步驟中找到的路徑新增至**Variable value (變數值)**欄位中，例如 ***C:\$1Program Files\$1Amazon\$1AWSCLIV2\$1aws.exe***。 1. 選擇 **OK** (確定) 兩次以套用新的設定。 1. 關閉任何正在執行的命令提示，並重新開啟命令提示字元視窗。 [回到頁首](#cli-chap-troubleshooting-top) ## 「`aws --version`」命令傳回的版本與您安裝的版本不同您的終端機可能`PATH`針對傳回 AWS CLI 不同於您預期的。 **可能的原因：安裝後需要重新啟動終端機** 如果 `aws` 命令顯示錯誤的版本，您可能需要重新啟動終端機才能辨識任何 `PATH` 更新。所有開放終端機都需要被關閉，不僅是您正在使用的終端機而已。 [回到頁首](#cli-chap-troubleshooting-top) **可能的原因：安裝後需要重新啟動系統** 如果 `aws` 命令顯示錯誤的版本，且終端機重新啟動無效，您可能需要為其重新啟動系統以辨識您的 `PATH` 更新。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因：您有多個版本的 AWS CLI** 如果您更新 AWS CLI 並使用與預先存在安裝不同的安裝方法，可能會導致安裝多個版本。例如，如果您在 Linux 或 macOS 上使用 `pip`，但嘗試使用 `.pkg` 安裝檔案，這可能會導致一些衝突，特別是如果您的 `PATH` 指向舊版本。若要解決此問題，請[解除安裝所有版本的 AWS CLI](#tshoot-uninstall-multiple-version)，並執行全新安裝。解除安裝所有版本後，請遵循適用於您作業系統的指示，安裝所需版本的 [AWS CLI 第 1 版](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html)或 [AWS CLI 第 2 版](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。如果您在安裝 AWS CLI 版本 2 並預先安裝 AWS CLI 版本 1 之後發生這種情況，請在[從 AWS CLI 版本 1 遷移時遵循安裝指示中的遷移說明](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration-instructions.html)。 [回到頁首](#cli-chap-troubleshooting-top) ## 解除安裝後，「`aws --version`」命令會傳回版本 AWS CLI 這通常發生在系統上仍有 AWS CLI 安裝的某個位置時。 **可能的原因：解除安裝後需要重新啟動終端機** 如果 `aws --version` 命令仍可運作，您可能需要重新啟動終端機才能辨識任何終端機更新。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因： AWS CLI 您在系統上有多個版本的，或未使用與原先安裝相同的解除安裝方法 AWS CLI** 如果您 AWS CLI 使用與安裝方法不同的方法來解除安裝，或者安裝了多個版本，則 AWS CLI 可能無法正確解除安裝。例如，如果您目前的安裝使用 `pip`，您就必須使用 `pip` 將它解除安裝。若要解決此問題， AWS CLI 請使用您用來安裝的相同方法解除安裝。 1. 遵循適用於您作業系統的指示和原始的安裝方法，解除安裝 [AWS CLI 第 1 版](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html)和 [AWS CLI 第 2 版](https://docs.aws.amazon.com/cli/latest/userguide/uninstall.html)。 1. 關閉所有已打開的終端機。 1. 打開您的首選終端機，輸入以下命令並確認沒有傳回任何版本。 ``` $ aws --version command not found: aws ``` 如果您仍然在輸出中列出版本，則很可能使用不同的方法安裝 AWS CLI ，或者有多個版本。如果您不知道安裝了的方法 AWS CLI，請遵循適用於您作業系統第 [AWS CLI 1 版](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html)和第 [AWS CLI 2 版](https://docs.aws.amazon.com/cli/latest/userguide/uninstall.html)的每個解除安裝方法的說明，直到沒有收到版本輸出為止。 **注意** 如果您使用套件管理工具來安裝 AWS CLI (`pip`、`apt`、`brew` 等)，您就必須使用相同的套件管理工具來予以解除安裝。請務必遵循套件管理工具所提供有關如何解除所有版本安裝套件的指示。 [回到頁首](#cli-chap-troubleshooting-top) ## 已 AWS CLI 處理參數名稱不完整的命令 **可能的原因：您使用了 AWS CLI 參數的可辨識縮寫** 由於 AWS CLI 是使用 Python 建置，因此 AWS CLI 使用 Python `argparse`程式庫，包括 [https://docs.python.org/3/library/argparse.html#allow-abbrev](https://docs.python.org/3/library/argparse.html#allow-abbrev)引數。參數的縮寫由辨識 AWS CLI 並處理。以下 [https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html](https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html) 命令範例會將 CloudFormation 堆疊名稱變更。參數`--change-set-n`會辨識為的縮寫`--change-set-name`，而會 AWS CLI 處理命令。 ``` $ aws cloudformation create-change-set --stack-name my-stack --change-set-n my-change-set ``` 當縮寫可能是多個命令時，參數將不會識別為縮寫。以下 [https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html](https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html) 命令範例會將 CloudFormation 堆疊名稱變更。參數 `--change-set-` **不能**以縮寫被識別，因為有可能是多個參數的縮寫，例如 `--change-set-name` 和 `--change-set-type`。因此， AWS CLI **不會**處理命令。 ``` $ aws cloudformation create-change-set --stack-name my-stack --change-set- my-change-set ``` **請勿**特意使用參數縮寫。它們不可靠，不具向後相容性。如果將任何新參數加入混淆縮寫的命令，它將會中斷您的命令。此外，如果參數是單值引數，可能會造成您的命令出現非預期的行為。如果傳遞單值引數的多個執行個體，只會執行最後一個執行個體。在下列範例中，參數 `--filters` 是單值引數。已指定參數 `--filters` 和 `--filter`。`--filter` 參數是 `--filters` 的縮寫。這會導致應用 `--filters` 的兩個實例，並且只應用最後一個 `--filter` 參數。 ``` $ aws ec2 describe-vpc-peering-connections \ --filters Name=tag:TagName,Values=VpcPeeringConnection \ --filter Name=status-code,Values=active ``` 執行命令之前，請確認您使用的是有效的參數，以防止未預期的行為。 [回到頁首](#cli-chap-troubleshooting-top) ## 存取遭拒錯誤 **可能原因： AWS CLI 程式檔案沒有「執行」許可** 在 Linux 或 macOS 上，確定 `aws` 程式具有呼叫端使用者的執行許可。一般而言，許可會設定為 `755`。若要為您的使用者新增執行許可，請執行下列命令，並以電腦上的程式路徑取代 *\$1/.local/bin/aws* 路徑。 ``` $ chmod +x ~/.local/bin/aws ``` [回到頁首](#cli-chap-troubleshooting-top) **可能原因：您的 IAM 身分沒有執行此操作的許可** *範例錯誤文字：* ``` $ aws s3 ls An error occurred (AcessDenied) when calling the ListBuckets operation: Access denied. ``` 當您執行 AWS CLI 命令時， AWS 操作會代表您執行，並使用與您 IAM 帳戶或角色建立關聯的登入資料。連接的政策必須授予您許可，才能呼叫與您使用 AWS CLI執行之命令相對應的 API 動作。大部分的命令均呼叫單一個名稱與命令名稱相符的動作。但是如 `aws s3 sync` 的自訂命令會呼叫多個 API。您可以利用 `--debug` 選項來查看命令呼叫了哪一些 API。如果您確定使用者或角色具有政策指派的適當許可，請確定您的 AWS CLI 命令使用您預期的登入資料。請參閱[下一節有關登入資料](#tshoot-permissions-wrongcreds)，以確認 AWS CLI 使用的登入資料是您所預期的登入資料。如需指派 IAM 許可的相關資訊，請參閱《[IAM 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_access-management.html)》中的*存取管理概觀：許可和政策*。 [回到頁首](#cli-chap-troubleshooting-top) ## 無效的憑證和金鑰錯誤 *範例錯誤文字：* ``` $ aws s3 ls An error occurred (InvalidAccessKeyId) when calling the ListBuckets operation: The AWS Access Key Id you provided does not exist in our records. ``` ``` $ aws s3 ls An error occurred (InvalidClientTokenId) when calling the ListBuckets operation: The security token included in the request is invalid. ``` **可能原因： AWS CLI 正在讀取不正確的登入資料，或從非預期的位置讀取** AWS CLI 可能會從您預期的不同位置讀取登入資料，或您的金鑰對資訊不正確。您可以執行 `aws configure list` 以確認使用哪些憑證。以下範例說明如何檢查用於預設描述檔的憑證。 ``` $ aws configure list Name Value Type Location ---- ----- ---- -------- profile None None access_key ****************ABCD shared-credentials-file secret_key ****************ABCD shared-credentials-file region us-west-2 env AWS_DEFAULT_REGION ``` 以下範例說明如何檢查具名描述檔的憑證。 ``` $ aws configure list Name Value Type Location ---- ----- ---- -------- profile None None access_key ****************ABCD shared-credentials-file secret_key ****************ABCD shared-credentials-file region us-west-2 env AWS_DEFAULT_REGION ``` 若要確認您的金鑰對詳細資訊，請查看 `config` 和 `credentials` 檔案。如需 `config` 和 `credentials` 檔案的詳細資訊，請參閱 [中的組態和登入資料檔案設定 AWS CLI](cli-configure-files.md)。如需深入了解憑證與身分驗證，包含憑證優先順序，請參閱 [的身分驗證和存取憑證 AWS CLI](cli-chap-authentication.md)。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因：電腦的時鐘不同步。** 如果您使用的是有效憑證，則您的時鐘可能不同步。在 Linux 或 macOS 上，執行 `date` 來檢查時間。 ``` $ date ``` 如果您的系統時鐘誤差在幾分鐘內，則請使用 `ntpd` 來進行同步。 ``` $ sudo service ntpd stop $ sudo ntpdate time.nist.gov $ sudo service ntpd start $ ntpstat ``` 在 Windows 上，使用控制台的日期與時間選項來設定系統時鐘。 [回到頁首](#cli-chap-troubleshooting-top) ## 簽章不相符錯誤 *範例錯誤文字：* ``` $ aws s3 ls An error occurred (SignatureDoesNotMatch) when calling the ListBuckets operation: The request signature we calculated does not match the signature you provided. Check your key and signing method. ``` 當 AWS CLI 執行命令時，它會將加密的請求傳送至 AWS 伺服器，以執行適當的 AWS 服務操作。您的登入資料（存取金鑰和私密金鑰）會參與加密，並啟用 AWS 來驗證提出請求的人員。有幾種情況可能會干擾此程序的正確操作，如下所述。 **可能原因：您的時鐘與 AWS 伺服器不同步** 為了協助防止[重送攻擊](https://wikipedia.org/wiki/Replay_attack)，可以在加密/解密程序期間使用目前時間。如果用戶端和伺服器的時間差異超過允許的數量，程序可能會失敗並拒絕請求。當您在時鐘與主機時鐘不同步的虛擬機器中執行命令，也可能發生這種情況。其中一個可能的原因是虛擬機器休眠，在喚醒後需要一些時間才能與主機的時鐘同步。在 Linux 或 macOS 上，執行 `date` 來檢查時間。 ``` $ date ``` 如果您的系統時鐘誤差在幾分鐘內，則請使用 `ntpd` 來進行同步。 ``` $ sudo service ntpd stop $ sudo ntpdate time.nist.gov $ sudo service ntpd start $ ntpstat ``` 在 Windows 上，使用控制台的日期與時間選項來設定系統時鐘。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因：您的作業系統正在錯誤處理包含特定特殊字元的 AWS 金鑰** 如果您的 AWS 金鑰包含某些特殊字元，例如 `-`、`/`、 `+`或 `%`，則某些作業系統變體會不當處理字串，並導致錯誤解譯金鑰字串。如果您使用其他工具或指令碼來處理金鑰，例如在新執行個體上建置登入資料檔案的工具，這些工具和指令碼可能會自行處理特殊字元，導致它們轉換為 AWS 無法辨識的項目。我們建議重新產生私密金鑰，以取得不包含導致問題的特殊字元的私密金鑰。 [回到頁首](#cli-chap-troubleshooting-top) ## 未找到 Windows 控制台錯誤 *範例錯誤文字：* ``` $ aws s3 ls No Windows console found. Are you running cmd.exe? ``` 當您使用 AWS CLI 命令時，您會收到「找不到 Windows 主控台。您正在執行 cmd.exe 嗎？」錯誤訊息。如果您`prompt_toolkit`安裝的 Python 已過期，這通常是 AWS CLI 在版本 1 中看到的錯誤。若要解決這個問題，請安裝 [Python 網站](https://pypi.org/project/prompt-toolkit/)上的最新 `prompt_toolkit` 版本。 [回到頁首](#cli-chap-troubleshooting-top) ## SSL 憑證錯誤 **可能原因： AWS CLI 不信任代理的憑證** *範例錯誤文字：* ``` $ aws s3 ls [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed ``` 當您使用 AWS CLI 命令時，會收到`[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed`錯誤訊息。這是因為 AWS CLI 不信任代理的憑證，因為代理的憑證是自我簽署等因素，而您的公司設定為憑證授權機構 (CA)。這可防止 AWS CLI 在本機 CA 登錄中找到您公司的 CA 根憑證。若要修正此問題，請指示使用`ca\$1bundle`組態`.pem`檔案設定、**[--ca-bundle](cli-configure-options.md#cli-configure-options-ca-bundle)**命令列選項或`AWS\$1CA\$1BUNDLE`環境變數來尋找公司檔案 AWS CLI 的位置。 [回到頁首](#cli-chap-troubleshooting-top) **可能的原因：您的配置未指向正確的 CA 根憑證位置** *範例錯誤文字：* ``` $ aws s3 ls SSL validation failed for regionname [Errno 2] No such file or directory ``` 這是由於您的憑證授權機構 (CA) 套件檔案位置在 AWS CLI中被錯誤設定。若要解決這個問題，請確認您公司 `.pem` 檔案的位置，然後使用 `ca\$1bundle` 組態檔案設定、**[--ca-bundle](cli-configure-options.md#cli-configure-options-ca-bundle)** 命令列選項或 `AWS\$1CA\$1BUNDLE` 環境變數，更新 AWS CLI 組態。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因：您的組態未使用正確的 AWS 區域** *範例錯誤文字：* ``` $ aws s3 ls [SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed ``` 如果您指定的 AWS 服務無法使用，或您的資源位於不同的中，則可能會發生錯誤 AWS 區域或非預期的結果 AWS 區域。如需疑難排解步驟，請參閱[檢查您的 AWS 區域 AWS CLI 命令正在使用](#general-region)。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因：您的 TLS 版本需要更新 ** *範例錯誤文字：* ``` $ aws s3 ls [SSL: UNSAFE_LEGACY_RENEGOTIATION_DISABLED] unsafe legacy renegotiation disabled ``` AWS 服務使用的 TLS 版本與您裝置的 TLS 版本不相容。若要解決此問題，請更新至支援的 TLS 版本。如需詳細資訊，請參閱 [為強制執行最低版本的 TLS AWS CLI](cli-security-enforcing-tls.md)。 [回到頁首](#cli-chap-troubleshooting-top) ## JSON 無效錯誤 *範例錯誤文字：* ``` $ aws dynamodb update-table \ --provisioned-throughput '{"ReadCapacityUnits":15,WriteCapacityUnits":10}' \ --table-name MyDDBTable Error parsing parameter '--provisioned-throughput': Invalid JSON: Expecting property name enclosed in double quotes: line 1 column 25 (char 24) JSON received: {"ReadCapacityUnits":15,WriteCapacityUnits":10} ``` 當您使用 AWS CLI 命令時，會收到「`Invalid JSON`」錯誤訊息。當您輸入具有預期 JSON 格式的命令，且 AWS CLI 無法正確讀取 JSON 時，通常會看到此錯誤。 **可能原因：您未輸入有效的 JSON AWS CLI 供使用** 請確定您已為命令輸入有效的 JSON。我們建議您為有格式化問題的 JSON 使用 JSON 驗證器。若要在命令列中使用更進階的 JSON，請考慮使用 `jq` 之類的命令列 JSON 處理器來建立 JSON 字串。如需 `jq` 的詳細資訊，請參閱 *GitHub* 上的 [jq 儲存庫](http://stedolan.github.io/jq/)。 [回到頁首](#cli-chap-troubleshooting-top) **可能原因：終端機的引號規則阻止有效的 JSON 傳送至 AWS CLI** 從命令 AWS CLI 接收任何內容之前，您的終端機會使用自己的引號和逸出規則來處理命令。由於終端機的格式化規則，您的部分 JSON 內容可能在命令傳遞至 AWS CLI之前遭除去。格式化命令時，務必使用[終端機的引號規則](cli-usage-parameters-quoting-strings.md)。若要進行疑難排解，請使用 `echo` 命令查看 shell 如何處理您的參數： ``` $ echo {"ReadCapacityUnits":15,"WriteCapacityUnits":10} ReadCapacityUnits:15 WriteCapacityUnits:10 ``` ``` $ echo '{"ReadCapacityUnits":15,"WriteCapacityUnits":10}' {"ReadCapacityUnits":15,"WriteCapacityUnits":10} ``` 修改您的命令，直到傳回有效的 JSON 為止。如需深入疑難排解的詳細資訊，請使用 `--debug` 參數查看偵錯日誌，日誌將準確顯示傳遞至 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'] ``` 請用終端機的引號規則修正 JSON 輸入在傳送至 AWS CLI時可能發生的任何問題。如需引號規則的詳細資訊，請參閱[在中使用引號和常值搭配字串 AWS CLI](cli-usage-parameters-quoting-strings.md)。如果您在取得有效的 JSON 到時遇到問題 AWS CLI，建議您使用 Blob 直接將 JSON 資料傳遞至，以略過終端機的 JSON 資料輸入引號規則 AWS CLI。如需 Blobs 的詳細資訊，請參閱 [Blob](cli-usage-parameters-types.md#parameter-type-blob)。 [回到頁首](#cli-chap-troubleshooting-top) ## 其他資源如需 AWS CLI 問題的其他協助，請造訪 *GitHub* 上的 [AWS CLI 社群](https://github.com/aws/aws-cli/issues)或 [AWS re:Post 社群](https://repost.aws/)。 [回到頁首](#cli-chap-troubleshooting-top)