Snow Family デバイス上の Amazon S3 互換ストレージでの S3 バケットの使用 Amazon S3 - AWS Snowball Edge デベロッパーガイド
の使用 AWS CLIJava の使用 SDKバケットARN形式バケットの場所形式

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

Snow Family デバイス上の Amazon S3 互換ストレージでの S3 バケットの使用 Amazon S3

Snow Family デバイスの Amazon S3 互換ストレージでは、Snowball Edge デバイスで Amazon S3 バケットを作成して、ローカルデータアクセス、ローカルデータ処理、データレジデンシーを必要とするアプリケーション用に、オンプレミスでオブジェクトを保存および取得できます。Snow Family デバイス上の Amazon S3 互換ストレージは、Amazon S3 SNOWを使用する新しいストレージクラス を提供しAPIs、複数の Snowball Edge デバイス間でデータを永続的かつ冗長に保存するように設計されています。バケットライフサイクルポリシー、暗号化、タグ付けなど、Amazon S3 で実行するのと同じ および APIs機能を Snowball Edge バケットで使用できます。

Snow Family デバイスでは、 AWS Command Line Interface （AWS CLI) を使用するか、 AWS Java を介してプログラムで Amazon S3 互換ストレージを使用できますSDK。を使用すると AWS CLI、s3api または s3control エンドポイントをセットアップし、コマンドを使用して操作できます。バケット操作とオブジェクト操作に同じエンドポイントを使用できるため、s3api エンドポイントを使用することをお勧めします。

注記

s3api エンドポイントは、Snowball Edge ソフトウェアのバージョン 8004 以降で使用できます。デバイスにインストールされている Snowball Edge ソフトウェアのバージョンを確認するには、 snowballEdge check-for-updates コマンドを使用します。Snowball Edge デバイスを更新するには、「Snowball Edge デバイスのソフトウェアの更新」を参照してください。

の使用 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

  2. デバイスから証明書を取得します。詳細については、「Snowball Edge デベロッパーガイド」を参照してください。

  3. SDK を仮想環境にインストールした場合は、次のコマンドを使用してアクティブ化します。

    source your-virtual-environment-name/bin/activate

オペレーションを設定したら、s3api SDKまたは s3control を使用してSDK、 を使用して Snow Family デバイスの S3 バケットにアクセスできます AWS CLI。

例 sS3api を使用して S3 バケットにアクセスする SDK

aws s3api --profile your-profile list-buckets --endpoint-url https://s3api-endpoint-ip
例 sS3control を使用した S3 バケットのアクセス SDK

aws s3control --profile your-profile list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip
例 sS3api を使用して S3 オブジェクトにアクセスする SDK

aws s3api --profile your-profile list-objects-v2 --endpoint-url https://s3api-endpoint-ip

Java の使用 SDK

次の例を使用して、Java を使用して Amazon S3 バケットとオブジェクトを操作しますSDK。


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_id です。または、cluster_id Snowball Edge クラスターがある場合。

バケットの場所形式

バケットの場所形式は、バケットを作成する Snowball Edge デバイスを指定します。バケットの場所の形式は次のとおりです。

/device-id/bucket/bucket-name

詳細については、 AWS CLI コマンドリファレンスの「create-bucket」を参照してください。