外部での AWS SDK for C++ サービスクライアントの設定 - AWS SDK for C++

外部での AWS SDK for C++ サービスクライアントの設定

多くの設定はコードの外部で管理できます。設定が外部で管理されている場合、その設定はすべてのアプリケーションに適用されます。ほとんどの設定は、環境変数または個別の共有 AWS config ファイルを使用して行うことができます。共有 config ファイルでは「プロファイル」と呼ばれる異なる設定セットを保持して、環境やテストごとに異なる設定を提供できます。

環境変数と共有 config ファイルの設定は標準化されており、AWS SDK やツール全体で共有されて、異なる言語やアプリ間でも一貫した機能をサポートします。

SDK 設定の詳細については、「AWS SDK とツールのリファレンスガイド」を参照してください。SDK が環境変数または設定ファイルから解決できるすべての設定を確認するには、「AWS SDK とツールのリファレンスガイド」の「設定リファレンス」を参照してください。

AWS のサービス にリクエストを行うには、まずそのサービスのクライアントをインスタンス化します。タイムアウトや HTTP クライアント、再試行設定など、サービスクライアントの共通設定を行うことができます。

各サービスクライアントには AWS リージョン と認証情報プロバイダーが必要です。SDK はこれらの値を使用して、リソースの正しいリージョンにリクエストを送信し、正しい認証情報でリクエストに署名します。これらの値はコード内でプログラムで指定することも、環境から自動的にロードされるようにすることもできます。

SDK には、設定の値を見つけるために順番に確認する一連の場所 (またはソース) があります。

  1. コードまたはサービスクライアント自体に設定されている明示的な設定は、他の設定よりも優先されます。

  2. 環境変数

    • 環境変数の設定の詳細については、「AWS SDK とツールのリファレンスガイド」の「環境変数」を参照してください。

    • シェルの環境変数は、システム全体、ユーザー全体、特定のターミナルセッションなど、さまざまなスコープレベルで設定できることに注意してください。

  3. 共有 config および credentials ファイル

  4. SDK ソースコード自体によって提供されるデフォルト値は、最後に使用されます。

    • Region などの一部のプロパティにはデフォルトがありません。これらのプロパティは、コード、環境設定、または共有 config ファイルのいずれかで明示的に指定する必要があります。SDK が必要な設定を解決できない場合、API リクエストは実行時に失敗する可能性があります。

注記

SDK が環境変数または設定ファイルから解決できるすべての設定を確認するには、「AWS SDK とツールのリファレンスガイド」の「設定リファレンス」を参照してください。