を使用するための基本的なセットアップ AWS のサービス - AWS SDK for Java 1.x
概要AWS アクセスポータルへのサインイン機能共有設定ファイルを設定します。Java 開発環境をインストールします。

AWS SDK for Java 1.x は 2024 年 7 月 31 日にメンテナンスモードに移行し、2025 年 12 月 31 end-of-support日に終了します。新機能、可用性の向上、セキュリティ更新プログラムを引き続き受信AWS SDK for Java 2.xするには、 に移行することをお勧めします。

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

を使用するための基本的なセットアップ AWS のサービス

概要

AWS のサービス を使用して にアクセスするアプリケーションを正常に開発するには AWS SDK for Java、次の条件が必要です。

重要

この設定セクションの手順では、ユーザーまたは組織が IAM Identity Center を使用していることを前提としています。組織が IAM Identity Center とは独立して動作する外部 ID プロバイダーを使用している場合は、 SDK for Java が使用する の一時的な認証情報を取得する方法について説明します。以下の手順に従って、~/.aws/credentials ファイルに一時的な認証情報を追加します。

ID プロバイダーが一時的な認証情報を自動的に~/.aws/credentialsファイルに追加する場合は、プロファイル名を SDKまたは に提供する必要がない[default]ように、プロファイル名が であることを確認します AWS CLI。

AWS アクセスポータルへのサインイン機能

AWS アクセスポータルは、IAMIdentity Center に手動でサインインするウェブの場所です。の形式は d-xxxxxxxxxx.awsapps.com/startまたは URLですyour_subdomain.awsapps.com/start。

AWS アクセスポータルに慣れていない場合は、「 AWS SDKsおよび ツールリファレンスガイド」のIAM「アイデンティティセンター認証トピック」のステップ 1 のアカウントアクセスに関するガイダンスに従ってください。 AWS SDK for Java 1.x は、ステップ 2 で説明SDKされている のトークンの自動更新と一時的な認証情報の自動取得をサポートしていないため、ステップ 2 に従わないでください。

共有設定ファイルを設定します。

共有設定ファイルは開発ワークステーションに存在し、すべての AWS SDKs と AWS Command Line Interface () で使用される基本設定が含まれていますCLI。共有設定ファイルには多数の設定 を含めることができますが、これらの手順では、 の操作に必要な基本要素を設定しますSDK。

共有 config ファイルをセットアップする

共有 config ファイルの内容の例を以下に示します。

[default]
region=us-east-1
output=json

開発の目的で、コードを実行する予定の最も AWS リージョン 近い を使用します。config ファイルで使用するリージョンコードのリストについては、「 Amazon Web Services 全般のリファレンス ガイド」を参照してください。出力形式の json 設定は、いくつかの可能な値のうちの 1 つです。

このセクションのガイダンスに従って config ファイルを作成します。

の一時的な認証情報を設定する SDK

AWS アクセスポータルから AWS アカウント および IAMロールにアクセスしたら、 がアクセスSDKするための一時的な認証情報を使用して開発環境を設定します。

一時的な認証情報を使用してローカル credentials ファイルを設定する手順

  1. 共有 credentials ファイルを作成します。

  2. credentials ファイルに、作業用の一時認証情報を貼り付けるまで次のプレースホルダーテキストを貼り付けます。

    [default]
aws_access_key_id=<value from AWS access portal>
aws_secret_access_key=<value from AWS access portal>
aws_session_token=<value from AWS access portal>

  3. ファイルを保存します。これで、ファイル ~/.aws/credentials はローカルの開発システムに存在しているはずです。このファイルには、特定の名前付きプロファイルが指定されていない場合に for Java が使用する [デフォルト〕 プロファイルが含まれています。 SDK

  4. AWS アクセスポータル にサインインします。

  5. アクセス AWS ポータルからIAMロールの認証情報をコピーするには、手動認証情報更新の見出しの以下の手順に従ってください。

    1. リンクされた手順のステップ 4 では、開発ニーズに応じたアクセスを許可するIAMロール名を選択します。このロールには通常、 PowerUserAccessまたは Developer などの名前があります。

    2. ステップ 7 で、[ AWS 認証情報ファイルにプロファイルを手動で追加] オプションを選択し、内容をコピーします。

  6. コピーした認証情報をローカル credentials ファイルに貼り付け、貼り付けたプロファイル名をすべて削除します。ファイルは以下のようになります。

    [default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

  7. credentials ファイルを保存します。

SDK for Java は、サービスクライアントを作成し、各リクエストに使用するときに、これらの一時的な認証情報にアクセスします。ステップ 5a で選択したIAMロールの設定により、一時的な認証情報が有効である期間が決まります。最大期間は 12 時間です。

一時的な認証情報の有効期限が切れたら、ステップ 4～7 を繰り返します。

Java 開発環境をインストールします。

AWS SDK for Java V1 には Java 7 JDK以降が必要です。のバージョン 1.12.767 以前を使用している場合は Java 7 SDKを使用できますが、 のバージョン 1.12.768 以降を使用している場合は SDKJava 8 が必要です。Maven 中央リポジトリには、 SDK for Java の最新バージョンが一覧表示されます。

は、Oracle Java SE 開発キット、および Amazon Corretto 、Red Hat Open 、および Adoptium などの Open Java 開発キット (Open JDK) のディストリビューションで AWS SDK for Java 動作します。 JDK