AWS SDK for Java
開発者ガイド

開発用の AWS 認証情報とリージョンのセットアップ

AWS SDK for Java でサポートされている任意のサービスに接続するには、AWS 認証情報を指定する必要があります。AWS SDK と CLI では、プロバイダーチェーンを使用して、システムまたはユーザーの環境変数やローカルの AWS 設定ファイルなど、いくつかの場所にある AWS 認証情報が検索されます。

このトピックでは、AWS SDK for Java を使用して、ローカルアプリケーション開発用に AWS 認証情報をセットアップするための基本情報について説明します。EC2 インスタンス内で使用するための認証情報をセットアップする必要がある場合、または開発に Eclipse IDE を使用している場合は、代わりに以下のトピックを参照してください。

AWS 認証情報の設定

AWS SDK for Java で使用する認証情報の設定はさまざまな方法で行うことができますが、推奨される手法を次に示します。

  • 次の場所にあるローカルシステム上の AWS 認証プロファイルファイルで認証情報を設定する

    • Linux, macOS, or Unix での ~/.aws/credentials

    • Windows の場合は C:\Users\USERNAME\.aws\credentials

    このファイルには次の形式の行が含まれています。

    [default] aws_access_key_id = your_access_key_id aws_secret_access_key = your_secret_access_key

    your_access_key_id および your_secret_access_key の値は、独自の AWS 認証情報の値に置き換えてください。

  • AWS_ACCESS_KEY_ID および AWS_SECRET_ACCESS_KEY 環境変数を設定する

    Linux, macOS, or Unix でこれらの変数を設定するには、export を使用します。

    export AWS_ACCESS_KEY_ID=your_access_key_id export AWS_SECRET_ACCESS_KEY=your_secret_access_key

    Windows でこれらの変数を設定するには、set を使用します。

    set AWS_ACCESS_KEY_ID=your_access_key_id set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  • EC2 インスタンスの場合、IAM ロールを指定し、そのロールへのアクセスを EC2 インスタンスに提供します。この仕組みの詳細については、「Amazon EC2 User Guide for Linux Instances」の「Amazon EC2 の IAM ロール」を参照してください。

これらの方法のいずれかを使用して AWS 認証情報を設定すると、デフォルトの認証情報プロバイダチェーンを使用して AWS SDK for Java によって自動的にロードされます。Java アプリケーションでの AWS 認証情報の使用の詳細については、「AWS 認証情報の使用」を参照してください。

AWS リージョンの設定

AWS SDK for Java で AWS のサービスにアクセスするために使用するデフォルトの AWS リージョンを設定する必要があります。最適なパフォーマンスを得るために、地理的に近いリージョンを選択します。各サービスのリージョンのリストを表示するには、『Amazon Web Services General Reference』の「リージョンとエンドポイント」を参照してください。

注記

リージョンの選択をしないと、デフォルトで us-east-1 が使用されます。

認証情報の設定と同様の方法でデフォルトの AWS リージョンを設定できます。

  • ローカルシステムの次の場所にある AWS Config ファイルで AWS リージョンを設定します。

    • Linux, macOS, or Unix での ~/.aws/config

    • Windows の場合は C:\Users\USERNAME\.aws\config

    このファイルには次の形式の行が含まれています。

    [default] region = your_aws_region

    your_aws_region を目的の AWS リージョン ("us-west-2" など) に置き換えます。

  • AWS_REGION 環境変数を設定します。

    Linux, macOS, or Unix では、export を使用します。

    export AWS_REGION=your_aws_region

    Windows では、set を使用します。

    set AWS_REGION=your_aws_region

    your_aws_region は目的の AWS リージョン名です。