翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
一般設定
注記
設定ページのレイアウトを理解したり、以下の AWS SDK とツールによるサポートの表を解釈したりするには、「このガイドの設定ページについて」を参照してください。
SDK は SDK の全体的な動作を設定する一般設定の一部をサポートします。
この機能を設定するには、以下のように使用します。
api_versions- AWSconfig共有ファイル設定-
一部の 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-01cloudfront =2015-09-017 ca_bundle- AWSconfig共有ファイル設定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.pemLinux/macOS のコマンドラインによる環境変数の設定の例を以下に示します。
export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pemWindows のコマンドラインによる環境変数の設定の例を以下に示します。
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output- AWSconfig共有ファイル設定-
AWS CLI およびその他の AWS SDK やツールでの結果のフォーマット方法を指定します。
デフォルト値:
json有効な値:
-
yaml-stream- 出力はストリームされ、 YAML文字列としてフォーマットされます。ストリーミングにより、大きなデータタイプの処理を高速化できます。 -
text- 出力は、複数行のタブ区切りの文字列値としてフォーマットされます。これは、grep、sed、またはawkなどのテキストプロセッサに出力を渡すのに役立ちます。 -
table- 出力は、テーブルとしてフォーマットされ、文字の「+|-」を使用してセルの境界を形成します。通常、情報は他の形式よりも読みやすい「わかりやすい」形式で表示されますが、プログラムとしては役立ちません。
parameter_validation- AWSconfig共有ファイル設定-
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 | なし |