一般設定 - AWS SDKs および ツール

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

一般設定

SDKs は、全体的なSDK動作を設定する一般的な設定をサポートしています。

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

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

ある程度 AWS のサービスは、下位互換性をサポートするために複数のAPIバージョンを維持します。デフォルトでは、 SDKおよび AWS CLI オペレーションは、利用可能な最新バージョンを使用しますAPI。リクエストに使用する特定のAPIバージョンを要求するには、プロファイルに api_versions設定を含めます。

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

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

この例では、2 つの に特定のAPIバージョンを設定します。 AWS 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 SDKs および ツール。

デフォルト値: json

有効な値:

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

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

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

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

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

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

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

デフォルト値: true

有効な値:

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

  • false – SDKまたは ツールは、コマンドラインパラメータを に送信する前に検証しません。 AWS サービスエンドポイント。- AWS サービスエンドポイントは、すべてのリクエストを検証し、無効なリクエストを拒否する責任があります。

との互換性 AWS SDKs

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

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