Arbeiten mit S3-Buckets mit Amazon S3 S3-kompatiblem Speicher auf Geräten der Snow Family

Mit Amazon S3 S3-kompatiblem Speicher auf Geräten der Snow Family können Sie Amazon S3 S3-Buckets auf Ihren Snowball Edge-Geräten erstellen, um Objekte vor Ort für Anwendungen zu speichern und abzurufen, die lokalen Datenzugriff, lokale Datenverarbeitung und Datenresidenz erfordern. Amazon S3-kompatibler Speicher auf Geräten der Snow Family bietet eine neue SpeicherklasseSNOW, die Amazon S3 verwendet und darauf ausgelegt istAPIs, Daten dauerhaft und redundant auf mehreren Snowball Edge-Geräten zu speichern. Sie können für Snowball Edge-Buckets dieselben APIs Funktionen wie für Amazon S3 verwenden, einschließlich Bucket-Lebenszyklusrichtlinien, Verschlüsselung und Tagging.

Sie können Amazon S3 S3-kompatiblen Speicher auf Snow Family-Geräten mit AWS Command Line Interface (AWS CLI) oder programmgesteuert über AWS Java SDK verwenden. Mit dem AWS CLI können Sie einen s3api- oder s3control-Endpunkt einrichten und mit ihm über Befehle interagieren. Wir empfehlen die Verwendung des s3api-Endpunkts, da derselbe Endpunkt für Bucket- und Objektoperationen verwendet werden kann.

Anmerkung

Der s3api-Endpunkt ist für Version 8004 und neuer der Snowball Edge-Software verfügbar. Verwenden Sie den snowballEdge check-for-updates Befehl, um die auf einem Gerät installierte Version der Snowball Edge-Software zu ermitteln. Informationen zum Aktualisieren eines Snowball Edge-Geräts finden Sie unter Software auf Snowball Edge-Geräten aktualisieren.

Mit dem AWS CLI

Folgen Sie diesen Anweisungen, um mit Amazon S3 S3-Buckets auf Ihrem Gerät zu arbeiten, indem Sie den AWS CLI verwenden.

Um das einzurichten AWS CLI

1. Erstellen Sie ein Profil für Objektendpunkte in~/.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. Besorgen Sie sich ein Zertifikat von Ihrem Gerät. Weitere Informationen finden Sie im Snowball Edge Developer Guide.

3. Wenn Sie das SDK in einer virtuellen Umgebung installiert haben, aktivieren Sie es mit dem folgenden Befehl:

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

Nachdem Sie Ihre Betriebsabläufe eingerichtet haben, können Sie mit der s3api SDK oder s3control auf SDK S3-Buckets auf Snow Family-Geräten zugreifen. AWS CLI

Beispiel des Zugriffs auf den S3-Bucket mithilfe der s3api SDK

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

Beispiel des Zugriffs auf S3-Buckets mit dem s3control SDK

aws s3control --profile your-profile list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip                    
                

Beispiel des Zugriffs auf S3-Objekte mit der s3api SDK

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

Mit Java SDK

Verwenden Sie das folgende Beispiel, um mit Amazon S3 S3-Buckets und Objekten unter Verwendung von Java SDK zu arbeiten.

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();
                

Bucket-Format ARN

Sie können das hier aufgeführte Format Amazon Resource Name (ARN) verwenden, um einen Amazon S3 S3-Bucket auf einem Snowball Edge-Gerät zu identifizieren:

arn:partition:s3:snow:account-id:device/device-id/bucket/bucket-name

Wo partition ist die Partition der Region, in der Sie Ihr Snowball Edge-Gerät bestellt haben. device-id ist die job_id, wenn es sich bei dem Gerät um ein eigenständiges Snowball Edge-Gerät handelt, oder die cluster_id wenn Sie einen Snowball Edge-Cluster haben.

Format des Bucket-Speicherorts

Das Bucket-Standortformat gibt das Snowball Edge-Gerät an, auf dem der Bucket erstellt wird. Der Bucket-Speicherort hat das folgende Format:

/device-id/bucket/bucket-name

Weitere Informationen finden Sie unter create-bucket in der AWS CLI Befehlsreferenz.