Verwenden von AWS SDK for Ruby – Version 3

Das AWS SDK for Ruby stellt eine API für Amazon-S3-Bucket und Objektoperationen bereit. Für Objektoperationen können Sie die API für das Hochladen von Objekten in einer einzigen Operation oder die API zum mehrteiligen Hochladen großer Objekte verwenden (siehe Hochladen eines Objekts mit Multipart-Upload). Die API für den Upload in einer Operation kann jedoch keine großen Objekte verarbeiten, und hinter den Kulissen wird der mehrteilige Upload für Sie verwaltet. Damit wird die Anzahl der Skripts reduziert, die Sie schreiben müssen.

Die Ruby API-Organisation

Wenn Sie Amazon-S3-Anwendungen mit dem AWS SDK for Ruby-SDK für Ruby erstellen, müssen Sie das SDK-für-Ruby-Gem installieren. Weitere Informationen finden Sie unter AWS-SDK für Ruby – Version 3. Nachdem Sie es installiert haben, können Sie auf die API zugreifen, einschließlich der folgenden Schlüsselklassen:

• Aws::S3::Resource –Stellt die Schnittstelle zu Amazon S3 für das Ruby SDK dar und bietet Methoden zum Erstellen und Auflisten von Buckets.

  Die KlasseS3 stellt die Instance-Methode #buckets für den Zugriff auf vorhandene Buckets oder zum Erstellen neuer Buckets bereit.

• Aws::S3::Bucket – Stellt einen Amazon-S3-Bucket dar. 

  Die Klasse Bucket stellt die Methoden #object(key) und #objects für den Zugriff auf die Objekte in einem Bucket bereit, ebenso wie die Methoden zum Löschen eines Buckets und zur Rückgabe von Informationen über einen Bucket, wie beispielsweise die Bucket-Richtlinie.

• Aws::S3::Object – Stellt ein durch seinen Schlüssel identifiziertes Amazon-S3-Objekt dar.

  Die Object-Klasse bietet Methoden für den Abruf und die Einrichtung der Eigenschaften eines Objekts, mit Angabe der Speicherklasse zum Speichern von Objekten, und der Einrichtung von Objektberechtigungen unter Verwendung von Zugriffskontrolllisten. Die Klasse Object enthält auch Methoden zum Löschen, Hochladen und Kopieren von Objekten. Beim mehrteiligen Hochladen von Objekten stellt Ihnen diese Klasse Optionen bereit, um die Reihenfolge der hochgeladenen Teile sowie die Teilegröße anzugeben.

Weitere Informationen zur AWS-SDK für Ruby API finden Sie unter AWS-SDK für Ruby – Version 2.

Testen der Ruby Script-Codebeispiele

Am einfachsten gelingt der Einstieg in die Ruby Script--Codebeispiele, indem das neuste AWS SDK for Ruby Gem installiert wird. Weitere Informationen zur Installation und Aktualisierung der neuesten Gem finden Sie unter AWS-SDK für Ruby – Version 3. Die folgenden Aufgaben führen Sie durch das Erstellen und Testen der Ruby Script-Beispiele, wobei vorausgesetzt wird, dass Sie installiert habe AWS SDK for Ruby.

1	Für den Zugriff auf AWS müssen Sie die Anmeldeinformationen für Ihre SDK für Ruby-Anwendung bereitstellen. Weitere Informationen finden Sie unter Konfigurieren des AWS-SDK für Ruby.
2	Erstellen Sie ein neues Skript für SDK for Ruby und fügen Sie oben die folgenden Codezeilen ein. #!/usr/bin/env ruby require 'rubygems' require 'aws-sdk-s3' Die erste Zeile ist die Interpreter-Anweisung, und die beiden require-Anweisungen importieren zwei erforderliche Gems in Ihr Skript.
3	Kopieren Sie das Code aus dem Abschnitt, den Sie gerade lesen, in Ihr Skript.
4	Aktualisieren Sie den Code mit den erforderlichen Daten. Wenn Sie beispielsweise eine Datei hochladen, geben Sie den Dateipfad und den Bucket-Namen an.
5	Führen Sie das Skript aus. Überprüfen Sie Änderungen an Buckets und Objekten unter Verwendung der AWS Management Console. Weitere Informationen zum AWS Management Console finden Sie unter https://aws.amazon.com/console/.

Ruby-Beispiele

Die folgenden Links enthalten Beispiele, die Ihnen bei den ersten Schritten mit dem SDK for Ruby – Version 3 helfen:

• Erstellen eines Buckets

• Objekte hochladen