Arbeiten mit S3-Buckets mit Amazon S3 S3-kompatiblem Speicher auf Snowball Edge - AWS Snowball Edge Leitfaden für Entwickler

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 mit S3-Buckets mit Amazon S3 S3-kompatiblem Speicher auf Snowball Edge

Mit Amazon S3 S3-kompatiblem Speicher auf Snowball Edge 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 Snowball Edge bietet eine neue SpeicherklasseSNOW, die Amazon S3 verwendet und darauf ausgelegt ist APIs, 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 Snowball Edge mit AWS Command Line Interface (AWS CLI) oder programmatisch über das 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 Version der Snowball Edge-Software zu ermitteln, die auf einem Gerät installiert ist. 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 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 mit dem 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 mit dem 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 mithilfe des Java-SDK mit Amazon S3 S3-Buckets und -Objekten 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 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-idist 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.