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

# Amazon S3 で使用する
<a name="examples-s3"></a>

このセクションでは、 AWS SDK for Java 2.xを使用して Amazon S3 を操作するための背景情報を提供します。このセクションは、このガイドの「*コード例*」セクションで説明されている [Amazon S3 Java v2 の例](java_s3_code_examples.md)の情報を補完します

## の S3 クライアント AWS SDK for Java 2.x
<a name="s3-clients"></a>

 AWS SDK for Java 2.x には、さまざまなタイプの S3 クライアントが用意されています。次の表では違いを比較しており、ユースケースに最適なクライアントを決定するのに役立ちます。


**Amazon S3 クライアントのさまざまなタイプ**  

| S3 クライアント | 簡単な説明 | どのようなときに使うか | 制限/欠点 | 
| --- | --- | --- | --- | 
| **AWS CRT ベースの S3 クライアント**<br />インターフェイス: [S3AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />ビルダー: [S3CrtAsyncClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)「[パフォーマンスの高い S3 クライアントを使用する: AWS CRT ベースの S3 クライアント](crt-based-s3-client.md)」を参照してください。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  | 
| **マルチパートが*有効になっている* Java ベースの S3 非同期クライアント**<br />インターフェイス: [S3AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />ビルダー: [S3AsyncClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClientBuilder.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)「[並列転送を使用するように Java ベースの S3 非同期クライアントを設定する](s3-async-client-multipart.md)」を参照してください。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  | CRT AWS ベースの S3 クライアントよりもパフォーマンスが低くなります。 | 
| **マルチパートが*有効になっていない* Java ベースの S3 非同期クライアント**<br />インターフェイス: [S3AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />ビルダー: [S3AsyncClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClientBuilder.html) |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  | パフォーマンスの最適化なし。 | 
| **Java ベースの S3 同期クライアント**<br />インターフェイス: [S3Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html)<br />ビルダー: [S3ClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3ClientBuilder.html) |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/examples-s3.html)  | パフォーマンスの最適化なし。 | 

**注記**  
バージョン 2.18.x 以降では、 はエンドポイントオーバーライドを含めるときに[仮想ホスト形式のアドレス指定](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access) AWS SDK for Java 2.x を使用します。これは、バケット名が有効な DNS ラベルである限り適用されます。  
クライアントビルダーの `true` で [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3BaseClientBuilder.html#forcePathStyle(java.lang.Boolean](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3BaseClientBuilder.html#forcePathStyle(java.lang.Boolean) メソッドを呼び出して、クライアントにバケットにパス形式のアドレス指定を使用するように強制します。  
以下の例は、エンドポイントオーバーライドを設定し、パス形式のアドレス指定を使用するサービスクライアントを示しています。  

```
S3Client client = S3Client.builder()
                          .region(Region.US_WEST_2)
                          .endpointOverride(URI.create("https://s3.us-west-2.amazonaws.com"))
                          .forcePathStyle(true)
                          .build();
```

**Topics**
+ [SDK の S3 クライアント](#s3-clients)
+ [S3 にストリームをアップロードする](best-practices-s3-uploads.md)
+ [署名付き URL](examples-s3-presign.md)
+ [クロスリージョンアクセス](s3-cross-region.md)
+ [チェックサムによるデータ整合性保護](s3-checksums.md)
+ [パフォーマンスの高い S3 クライアントを使用する](crt-based-s3-client.md)
+ [並列転送のサポートを設定する](s3-async-client-multipart.md)
+ [ファイルとディレクトリを転送する](transfer-manager.md)
+ [S3 イベント通知](examples-s3-event-notifications.md)