View a markdown version of this page

Arbeiten Sie mit S3-Buckets mit Amazon S3-kompatiblem Speicher auf Snowball Edge - AWS Snowball Edge Entwicklerhandbuch
Verwendung der AWS CLIVerwenden des Java SDKBucket-ARN-FormatFormat für den Standort des Buckets

AWS Snowball Edge ist für Neukunden nicht mehr verfügbar. Neukunden sollten AWS DataSync nach Online-Übertragungen, AWS Data Transfer Terminal für sichere physische Übertragungen oder AWS Partnerlösungen suchen. Erkunden Sie AWS Outposts für Edge-Computing.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten Sie mit S3-Buckets mit Amazon S3-kompatiblem Speicher auf Snowball Edge

Mit Amazon S3-kompatiblem Speicher auf Snowball Edge können Sie Amazon 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 Snowball Edge bietet eine neue SpeicherklasseSNOW, die die Amazon S3-APIs verwendet und darauf ausgelegt ist, Daten dauerhaft und redundant auf mehreren Snowball Edge-Geräten zu speichern. Sie können in Snowball Edge-Buckets dieselben APIs und Funktionen verwenden wie in Amazon S3, einschließlich Bucket-Lebenszyklusrichtlinien, Verschlüsselung und Tagging.

Sie können Amazon S3-kompatiblen Speicher auf Snowball Edge mithilfe von AWS Command Line Interface (AWS CLI) oder programmgesteuert über das Java-SDK verwenden. AWS 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 Befehl, um die auf einem Gerät installierte Version der Snowball Edge-Software zu ermitteln. snowballEdge check-for-updates Informationen zum Aktualisieren eines Snowball Edge-Geräts finden Sie unter Aktualisieren der Software auf Snowball Edge-Geräten.

Verwendung der AWS CLI

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

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 Operationen eingerichtet haben, können Sie das s3api SDK oder das s3control SDK verwenden, um mit dem auf S3-Buckets auf Snowball Edge zuzugreifen. AWS CLI

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

aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile
Beispiel des Zugriffs auf S3-Buckets mithilfe des s3control-SDK

aws s3control list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip --profile your-profile
Beispiel des Zugriffs auf S3-Objekte mithilfe des s3api SDK

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

Verwenden des Java SDK

Verwenden Sie das folgende Beispiel, um mit Amazon S3-Buckets und -Objekten mithilfe des 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-ARN-Format

Sie können das hier aufgeführte Amazon Resource Name (ARN) -Format verwenden, um einen Amazon 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-idist die job_id, wenn das Gerät ein eigenständiges Snowball Edge-Gerät ist, oder die, cluster_id wenn Sie einen Snowball Edge-Cluster haben.

Format für den Standort des Buckets

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

/device-id/bucket/bucket-name

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