AWS SDK for Java 1.x は 2025 年 12 月 31 日にend-of-supportしました。新しい機能、可用性の向上、セキュリティ更新のために、[AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) に移行することをお勧めします。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# を使用するための基本的なセットアップ AWS のサービス
## 概要:
AWS のサービス を使用して にアクセスするアプリケーションを正常に開発するには AWS SDK for Java、次の条件が必要です。
+ AWS IAM アイデンティティセンターにある [AWS アクセスポータルにサインイン](#setup-awsaccount)できる必要があります。
+ SDK 用に設定された [IAM ロールのアクセス許可](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)は、アプリケーション AWS のサービス が必要とする へのアクセスを許可する必要があります。**PowerUserAccess** AWS 管理ポリシーに関連付けられたアクセス許可は、ほとんどの開発ニーズに十分です。
+ 次の要素を備えた開発環境:
+ 以下の方法で設定される[共有設定ファイル](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。
+ `config` ファイルには、 を指定するデフォルトのプロファイルが含まれています AWS リージョン。
+ `credentials` ファイルには、デフォルトプロファイルの一部として一時的な認証情報が含まれています。
+ 適切な [Java インストール](#java-dg-java-env)。
+ [Maven](https://maven.apache.org/download.cgi) や [Gradle](https://gradle.org/install/) などの[構築オートメーションツール](setup-build-tools.md)。
+ コードを使用するテキストエディター。
+ (オプションだが推奨) [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows)、[Eclipse](https://www.eclipse.org/ide/)、[NetBeans](https://netbeans.org/downloads/) などの IDE (統合開発環境)。
IDE を使用すると、 AWS Toolkitを統合してより簡単に操作することもできます AWS のサービス。[AWS Toolkit for IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) と、[AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html) は Java 開発に使用できる 2 つのツールキットです。
**重要**
このセットアップセクションの手順は、ユーザーまたは組織が IAM アイデンティティセンターを使用していることを前提としています。組織が IAM アイデンティティセンターとは独立して機能する外部 ID プロバイダーを使用している場合は、SDK for Java で使用するための一時的な認証情報を取得する方法をご確認ください。[以下の手順](#setup-temp-creds)に従って、`~/.aws/credentials` ファイルに一時的な認証情報を追加します。
ID プロバイダーが一時的な認証情報を `~/.aws/credentials` ファイルに自動的に追加する場合は、SDK または AWS CLIにプロファイル名を指定する必要がないように、プロファイル名が `[default]` であることを確認してください。
## AWS アクセスポータルへのサインイン機能
AWS アクセスポータルは、IAM アイデンティティセンターに手動でサインインするウェブの場所です。URL のフォーマットは `d-xxxxxxxxxx.awsapps.com/start`、または `your_subdomain.awsapps.com/start` です。
AWS アクセスポータルに慣れていない場合は、 AWS SDKs[」の「IAM アイデンティティセンター認証トピック」のステップ 1](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) のアカウントアクセスに関するガイダンスに従ってください。 AWS SDK for Java 1.x は、ステップ 2 で説明している SDK のトークンの自動更新と一時的な認証情報の自動取得をサポートしていないため、ステップ 2 を実行しないでください。
## 共有設定ファイルを設定します。
共有設定ファイルは開発ワークステーションに存在し、すべての AWS SDKs と AWS Command Line Interface (CLI) で使用される基本設定が含まれています。共有設定ファイルには[多数の設定](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html)を含めることができますが、これらの手順は SDK を使用するために必要な基本要素を設定します。
### 共有 `config` ファイルをセットアップする
共有 `config` ファイルの内容の例を以下に示します。
```
[default]
region=us-east-1
output=json
```
開発の目的で、コードを実行する予定の場所に AWS リージョン [最も近い](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) を使用します。`config` ファイルで使用する[リージョンコードのリスト](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes)については、「 Amazon Web Services 全般のリファレンス ガイド」を参照してください。出力形式の `json` 設定は、[いくつかの可能な値](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html)のうちの 1 つです。
[このセクション](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html)のガイダンスに従って `config` ファイルを作成します。
### SDK の一時的な認証情報を設定します。
AWS アクセスポータルから AWS アカウント および IAM ロールにアクセスしたら、SDK がアクセスするための一時的な認証情報を使用して開発環境を設定します。
**一時的な認証情報を使用してローカル `credentials` ファイルを設定する手順**
1. [共有 `credentials` ファイルを作成します](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html)。
1. `credentials` ファイルに、作業用の一時認証情報を貼り付けるまで次のプレースホルダーテキストを貼り付けます。
```
[default]
aws_access_key_id=
aws_secret_access_key=
aws_session_token=
```
1. ファイルを保存します。これで、ファイル `~/.aws/credentials` はローカルの開発システムに存在しているはずです。このファイルには、特定の名前付きプロファイルが指定されていない場合に SDK for Java が使用する [[default] プロファイル](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile)が含まれています。
1. [AWS アクセスポータルにサインインします](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html)。
1. アクセス AWS ポータルから IAM ロールの認証情報をコピーするには、[「手動認証情報更新](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials)」の見出しにある手順に従ってください。
1. リンク先の手順のステップ 4 で、開発ニーズに合ったアクセスを許可する IAM ロールの名前を選択します。通常、このロールには **PowerUserAccess** や **Developer** などの名前が付いています。
1. ステップ 7 で、**[ AWS 認証情報ファイルにプロファイルを手動で追加]** オプションを選択し、内容をコピーします。
1. コピーした認証情報をローカル `credentials` ファイルに貼り付け、貼り付けたプロファイル名をすべて削除します。ファイルは以下のようになります。
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
1. `credentials` ファイルを保存します。
SDK for Java は、サービスクライアントを作成するときにこれらの一時的な認証情報にアクセスし、各リクエストに使用します。ステップ 5a で選択した IAM ロールの設定により、[一時的な認証情報の有効期間](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html)が決まります。最大期間は 12 時間です。
一時的な認証情報の有効期限が切れたら、ステップ 4～7 を繰り返します。
## Java 開発環境をインストールします。
AWS SDK for Java V1 には Java 7 JDK 以降が必要で、すべての Java LTS (長期サポート) JDK バージョンがサポートされています。SDK のバージョン 1.12.767 以前を使用している場合は Java 7 を使用できますが、SDK のバージョン 1.12.768 以降を使用している場合は Java 8 が必要です。[Maven 中央リポジトリ](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom)に、SDK for Java の最新バージョンが記載されています。
は、[Oracle Java SE Development Kit ](https://www.oracle.com/java/technologies/downloads/)および [Amazon Corretto](https://aws.amazon.com/corretto)、Red Hat OpenJDK、[Adoptium](https://adoptium.net/) などの Open Java Development Kit (OpenJDK) のディストリビューションで AWS SDK for Java 動作します。 [ OpenJDK](https://developers.redhat.com/products/openjdk/overview)