本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

第 2 AWS CLI 版的遷移指南

本節包含將第 1 AWS CLI 版更新為第 2 AWS CLI 版的說明。 AWS CLI 第 2 版以第 1 AWS CLI 版為基礎，並包含以社群意見回饋為基礎的功能和增強功能。 AWS CLI 第 2 版是 的最新主要版本， AWS CLI 並支援所有最新的功能。在第 2 版中推出的某些功能無法回溯至第 1 版，因此您必須升級才能存取這些功能。

為了避免意外問題，在您遷移至第 2 版之前，請先了解版本之間的差異。第 2 AWS CLI 版包含可能需要您更新指令碼或命令才能回溯相容性的新功能和變更。

AWS CLI 第 1 版和第 2 版使用相同的aws命令名稱。如果您已安裝兩個版本，您的電腦會使用搜尋路徑中找到的第一個版本。這可能會導致您的aws命令名稱呼叫舊 AWS CLI 版本，即使您已安裝新的版本。

若要更新到第 2 AWS CLI 版，請遵循下列其中一個指示：

使用 AWS CLI 遷移工具來緩解中斷

CLI AWS 第 1 版與 AWS CLI 第 2 版之間的行為有所變更，可能需要您更新指令碼或命令。升級至 AWS CLI 第 2 版，而不驗證您現有的指令碼在使用 CLI 第 2 AWS 版執行指令碼時，遇到意外效果的安全遷移風險，例如對 AWS 帳戶上的資源進行意外變更。

您可以使用兩個 AWS擁有的工具來引導遷移。無論您使用哪種工具，建議您在第 2 AWS CLI 版中的新功能和變更指南中斷第 1 AWS CLI 版和第 2 AWS CLI 版之間的變更中參考 。

升級偵錯模式

升級偵錯模式是 AWS CLI 版本 1 中的功能，可在版本 1.44.0 和更高版本中使用。啟用此功能時，會檢查您執行的每個 AWS CLI AWS 命令，以判斷它在 CLI 第 2 版中是否可能有不同的行為，假設執行環境保持不變。如果執行的命令在 CLI AWS 第 2 版中會有不同的行為，則命令輸出旁邊會顯示警告，其中包含可採取的建議動作，以在 AWS CLI 第 2 版中保留 AWS CLI 第 1 版行為。

使用升級偵錯模式引導遷移的主要原因是，它在偵測命令是否會面臨行為變更方面具有很高的涵蓋範圍。在 中所述的 15 個重大變更中，有 14 個中斷第 1 AWS CLI 版和第 2 AWS CLI 版之間的變更可以使用升級偵錯模式進行偵測，如需此功能的限制使用升級偵錯模式將 AWS CLI 第 1 版升級至 AWS CLI 第 2 版，請參閱 限制 中的 。另一方面，使用升級偵錯模式的主要缺點是其輸出僅與其執行環境相關；如果遷移至 AWS CLI 第 2 版之後，環境中有任何 AWS CLI 組態設定變更，則仍可能發生重大變更，您應該在更新的環境中使用升級偵錯模式重新驗證。

AWS CLI v1 到 v2 遷移工具

AWS CLI v1 至 v2 遷移工具是一種獨立工具，可與 Python 3.9 及更高版本搭配使用。此工具是獨立於 CLI AWS 執行的靜態 linter。它會內嵌包含 CLI AWS 第 1 版命令的 bash 指令碼，這些命令在 CLI AWS 第 2 版中可能有不同的行為。對於它偵測到在 CLI AWS 第 2 版中可能具有不同行為的大多數命令，它可以自動更新指令碼中的命令，以在 AWS CLI 第 2 版中保留 AWS CLI 第 1 版行為。

使用 AWS CLI v1 到 v2 遷移工具引導遷移的主要原因是它可以自動更新您的指令碼，以保留 AWS CLI 第 2 版中的 AWS CLI 第 1 版行為，節省您自行進行更新的時間和精力。另一方面，使用遷移工具的主要缺點是，它在偵測命令是否會面臨行為變更方面具有較低的涵蓋範圍。作為靜態工具，它不會檢查執行時間決定的行為變更。

在升級偵錯模式和 AWS CLI v1 到 v2 遷移工具之間進行選擇

下表重點介紹升級偵錯模式與 AWS CLI v1 到 v2 遷移工具之間的主要差異，並可用來協助引導您為使用案例選擇正確的工具。

下表顯示這兩種遷移工具各中斷第 1 AWS CLI 版和第 2 AWS CLI 版之間的變更支援哪些 。

本區段的其他主題