一般組態設定

使用下列項目設定此功能：

api_versions - 共用 AWS config檔案設定

有些 AWS 服務會維護多個 API 版本，以支援回溯相容性。根據預設， SDK 和 AWS CLI 操作會使用最新的可用 API 版本。若要要求特定 API 版本用於您的請求，請在設定檔中包含 api_versions設定。

預設值：無。（軟體開發套件會使用最新 API 版本。)

有效值：這是巢狀設定，後面接著一或多個縮排行，每個行都會識別一個 AWS 服務和要使用的 API 版本。請參閱 AWS 服務的文件，以了解可用的 API 版本。

此範例會為 config 檔案中的兩個 AWS 服務設定特定的 API 版本。這些 API 版本僅適用於在包含這些設定的描述檔下執行的命令。任何其他服務的命令會使用該服務 API 的最新版本。

api_versions =
    ec2 = 2015-03-01
    cloudfront = 2015-09-017

ca_bundle - 共用 AWS config檔案設定

AWS_CA_BUNDLE - 環境變數

指定建立 SSL/TLS 連線時要使用的自訂憑證套件 （具有.pem副檔名的檔案） 路徑。

預設值：無

有效值：指定完整路徑或基本檔案名稱。如果有基本檔案名稱，系統會嘗試在PATH環境變數指定的資料夾中尋找程式。

在 config 檔案中設定此值的範例：

[default]
ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

由於作業系統處理路徑的方式和路徑字元的逸出方式不同，以下是在 Windows 的 config 檔案中設定此值的範例：

[default]
ca_bundle = C:\\Users\\username\\.aws\\aws-custom-bundle.pem

透過命令列設定環境變數的 Linux/macOS 範例：

export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pem

透過命令列設定環境變數的 Windows 範例：

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem

output - 共用 AWS config檔案設定

指定 AWS CLI 和其他 AWS SDKs和工具中結果的格式。

預設值：json

有效值：

• json – 輸出的格式為 JSON 字串。

• yaml – 輸出的格式為 YAML 字串。

• yaml-stream – 輸出採用串流方式且格式為 YAML 字串。串流可加速處理大型資料類型。

• text – 輸出的格式是多行以 Tab 分隔的字串值。這對於將輸出傳遞給文字處理器 (如 grep、sed 或 awk) 非常有用。

• table – 輸出的格式為使用字元 +|- 形成儲存格框線的表格。它通常以「方便人類使用」的格式來呈現資訊，這種格式比其他格式更容易閱讀，但在編寫程式方面較不有用。

parameter_validation - 共用 AWS config檔案設定

指定 SDK 或工具是否嘗試驗證命令列參數， AWS 然後再將其傳送至服務端點。

預設值：true

有效值：

• true – 預設值。SDK 或工具會執行命令列參數的用戶端驗證。這有助於 SDK 或工具確認參數有效，並擷取一些錯誤。SDK 或工具可以在傳送請求至 AWS 服務端點之前，拒絕無效的請求。

• false – SDK 或工具不會在將命令列參數傳送到 AWS 服務端點之前驗證命令列參數。 AWS 服務端點負責驗證所有請求，並拒絕無效的請求。