一般設定 - AWS SDKsとツール

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

一般設定

注記

設定ページのレイアウトを理解したり、以下の AWS SDK とツールによるサポートの表を解釈したりするには、「このガイドの設定ページについて」を参照してください。

SDK は SDK の全体的な動作を設定する一般設定の一部をサポートします。

この機能を設定するには、以下のように使用します。

api_versions - AWS config 共有ファイル設定

一部の AWS サービスでは、下位互換性をサポートするために複数の API バージョンを維持します。デフォルトでは、SDK と AWS CLI オペレーションは最新の API バージョンを使用します。リクエストに特定の API バージョンを使用することを要求するには、プロファイルに api_versions 設定を含めてください。

デフォルト値: なし。(SDK では最新の API バージョンが使用されます。)

有効な値: これは、それぞれが使用する AWS サービスと使用する API バージョンを識別する 1 つ以上のインデントされた行に適用される「ネストされた」設定です。どの API バージョンが利用可能を判断するには、AWS サービスのドキュメントを参照してください。

この例では、2 つの AWS サービスの特定の API バージョンを config ファイルに設定しています。これらの 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 SDK やツールでの結果のフォーマット方法を指定します。

デフォルト値: json

有効な値:

  • json - 出力は JSON 文字列としてフォーマットされます。

  • yaml - 出力は YAML 文字列としてフォーマットされます。

  • yaml-stream - 出力はストリームされ、 YAML 文字列としてフォーマットされます。ストリーミングにより、大きなデータタイプの処理を高速化できます。

  • text - 出力は、複数行のタブ区切りの文字列値としてフォーマットされます。これは、grepsed、または awk などのテキストプロセッサに出力を渡すのに役立ちます。

  • table - 出力は、テーブルとしてフォーマットされ、文字の「+|-」を使用してセルの境界を形成します。通常、情報は他の形式よりも読みやすい「わかりやすい」形式で表示されますが、プログラムとしては役立ちません。

parameter_validation - AWS config 共有ファイル設定

AWS サービスエンドポイントに送信する前に、SDK またはツールがコマンドラインパラメータの検証を試行するかどうかを指定します。

デフォルト値: true

有効な値:

  • true-デフォルト。SDK またはツールは、コマンドラインパラメータのクライアント側検証を実行します。これにより、SDK またはツールはパラメーターが有効であることを確認し、エラーを検出できます。SDK またはツールは、AWS サービスエンドポイントにリクエストを送信する前に、有効でないリクエストを拒否できます。

  • false – SDK またはツールは、コマンドラインパラメータを AWS サービスエンドポイントに送信する前に、それらの検証を行いません。AWS サービスエンドポイントは、すべてのリクエストを検証し、有効でないリクエストの拒否を担当します。

AWS SDK とツールによるサポート

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。

SDK サポート 注意または詳細情報
AWS CLI v2 部分的 api_versions はサポートされていません。
SDK for C++ あり
SDK for Go V2 (1.x) 部分的 api_versions および parameter_validation はサポートされていません。
SDK for Go 1.x (V1) 部分的 api_versions および parameter_validation はサポートされていません。共有 config ファイル設定を使用するには、設定ファイルからの読み込みを有効にする必要があります。「セッション」を参照してください。
SDK for Java 2.x なし
SDK for Java 1.x なし
SDK for JavaScript 3.x あり
SDK for JavaScript 2.x あり
SDK for Kotlin なし
SDK for .NET 4.x なし
SDK for .NET 3.x なし
SDK for PHP 3.x あり
SDK for Python (Boto3) あり
SDK for Ruby 3.x あり
SDK for Rust なし
SDK for Swift なし
Tools for PowerShell V5 なし
Tools for PowerShell V4 なし