翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Snowball Edge での Amazon S3 互換ストレージを使用した S3 バケットの操作 Amazon S3
Snowball Edge の Amazon S3 互換ストレージを使用すると、Snowball Edge デバイスに Amazon S3 バケットを作成して、ローカルデータアクセス、ローカルデータ処理、データレジデンシーを必要とするアプリケーション用にオンプレミスのオブジェクトを保存および取得できます。Snowball Edge の Amazon S3 互換ストレージは、Amazon S3 API `SNOW`を使用する新しいストレージクラス を提供し、複数の Snowball Edge デバイス間でデータを永続的かつ冗長的に保存するように設計されています。 APIs Snowball Edge バケットで、Amazon S3 と同じ API と機能 (バケットのライフサイクルポリシー、暗号化、タグ付けなど) を使用できます。
Snowball Edge の Amazon S3 互換ストレージは、 AWS Command Line Interface （AWS CLI) を使用するか、Java SDK AWS を介してプログラムで使用できます。を使用すると AWS CLI、s3api エンドポイントまたは s3control エンドポイントをセットアップし、コマンドで操作できます。バケットとオブジェクトのオペレーションに同じエンドポイントを使用できるため、s3api エンドポイントを使用することをお勧めします。
**注記**
s3api エンドポイントは、Snowball Edge ソフトウェアのバージョン 8004 以降で使用できます。デバイスにインストールされている Snowball Edge ソフトウェアのバージョンを確認するには、`snowballEdge check-for-updates` コマンドを使用します。Snowball Edge デバイスを更新するには、「[Snowball Edge デバイスのソフトウェア更新](https://docs.aws.amazon.com/snowball/latest/developer-guide/updating-device.html)」を参照してください。
## の使用 AWS CLI
AWS CLIを使用して、デバイスの Amazon S3 バケットを操作するには、以下の手順に従います。
**を設定するには AWS CLI**
1. `~/.aws/config` でオブジェクトエンドポイントのプロファイルを作成します。
```
[profile your-profile]
aws_access_key_id = your-access-id
aws_secret_access_key = your-access-key
region = snow
ca_bundle = dev/apps/ca-certs/your-ca_bundle
```
1. デバイスから証明書を取得します。詳細については、「[Snowball Edge デベロッパーガイド](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#snowball-edge-certificates-cli)**」を参照してください。
1. SDK を仮想環境にインストールした場合は、以下のコマンドを使用してアクティブ化します。
```
source your-virtual-environment-name/bin/activate
```
オペレーションを設定したら、s3api SDK または s3control SDK を使用して、 を使用して Snowball Edge の S3 バケットにアクセスできます AWS CLI。
**Example s3api SDK を使用した S3 バケットへのアクセス例**
```
aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile
```
**Example s3control SDK を使用した S3 バケットへのアクセス**
```
aws s3control list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip --profile your-profile
```
**Example s3api SDK を使用した S3 オブジェクトへのアクセス例**
```
aws s3api list-objects-v2 --endpoint-url https://s3api-endpoint-ip --profile your-profile
```
## Java SDK の使用
以下の例に従って、Java SDK を使用して Amazon S3 バケットとオブジェクトを操作します。
```
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.http.SdkHttpClient;bg
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.regions.Region;
import java.net.URI;
AwsBasicCredentials creds = AwsBasicCredentials.create(accessKey, secretKey); // set creds by getting Access Key and Secret Key from snowball edge
SdkHttpClient httpClient = ApacheHttpClient.builder().tlsTrustManagersProvider(trustManagersProvider).build(); // set trust managers provider with client certificate from snowball edge
String s3SnowEndpoint = "10.0.0.0"; // set s3-snow object api endpoint from describe service
S3Client s3Client = S3Client.builder().httpClient(httpClient).region(Region.of("snow")).endpointOverride(new URI(s3SnowEndpoint)).credentialsProvider(StaticCredentialsProvider.create(creds)).build();
```
## バケット ARN 形式
以下に示す Amazon リソースネーム (ARN) 形式を使用して、Snowball Edge デバイスの Amazon S3 バケットを識別できます。
```
arn:partition:s3:snow:account-id:device/device-id/bucket/bucket-name
```
ここで、*partition* は Snowball Edge デバイスを注文したリージョンのパーティションです。*device-id* は、デバイスがスタンドアロンの Snowball Edge デバイスの場合は job\$1id 、Snowball Edge クラスターの場合は *cluster\$1id* です。
## バケットロケーションの形式
バケットの場所形式は、バケットを作成する Snowball Edge デバイスを指定します。このバケットロケーションは次の形式になります。
```
/device-id/bucket/bucket-name
```
詳細については、 AWS CLI 「 コマンドリファレンス」の[「create-bucket](https://awscli.amazonaws.com/v2/documentation/api/2.0.34/reference/s3api/create-bucket.html)」を参照してください。