Skip to main content
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Operationen für Objekte

Beitragende
PDFs

In diesem Abschnitt wird beschrieben, wie das StorageGRID System S3-REST-API-Vorgänge für Objekte implementiert.

Die folgenden Bedingungen gelten für alle Objektvorgänge:

  • StorageGRID "Konsistenzwerte" Werden von allen Operationen auf Objekten unterstützt, mit Ausnahme der folgenden:

    • GetObjectAcl

    • OPTIONS /

    • PutObjectLegalHold

    • PutObjectRetention

    • SelektierObjectContent

  • Widersprüchliche Clientanforderungen, wie z. B. zwei Clients, die in denselben Schlüssel schreiben, werden auf der Grundlage der „neuesten Wins“ gelöst. Der Zeitpunkt für die Bewertung „neuester Erfolge“ basiert auf dem Zeitpunkt, an dem das StorageGRID System eine bestimmte Anforderung abgeschlossen hat und nicht auf dem Zeitpunkt, an dem S3-Clients einen Vorgang starten.

  • Alle Objekte in einem StorageGRID-Bucket sind im Eigentum des Bucket-Inhabers. Dies umfasst Objekte, die von einem anonymen Benutzer oder einem anderen Konto erstellt wurden.

  • Der Zugriff auf Datenobjekte, die über Swift in das StorageGRID System aufgenommen wurden, ist nicht über S3 möglich.

In der folgenden Tabelle wird beschrieben, wie StorageGRID S3-REST-API-Objektvorgänge implementiert.

Betrieb Implementierung

DeleteObject

Multi-Faktor Authentication (MFA) und Response Header x-amz-mfa Werden nicht unterstützt.

Bei der Verarbeitung einer DeleteObject-Anforderung versucht StorageGRID sofort, alle Kopien des Objekts von allen gespeicherten Speicherorten zu entfernen. Wenn erfolgreich, gibt StorageGRID sofort eine Antwort an den Client zurück. Wenn nicht innerhalb von 30 Sekunden alle Kopien entfernt werden können (z. B. weil ein Speicherort vorübergehend nicht verfügbar ist), stellt StorageGRID die Kopien in eine Warteschlange zur Entfernung und zeigt dann den Erfolg des Clients an.

Versionierung

Um eine bestimmte Version zu entfernen, muss der Anforderer der Bucket-Eigentümer sein und den verwenden versionId unterressource. Durch die Verwendung dieser Unterressource wird die Version dauerhaft gelöscht. Wenn der versionId Entspricht einer Löschen-Markierung, dem Antwortkopf x-amz-delete-marker Wird auf festgelegt true.

  • Wird ein Objekt ohne gelöscht versionId unterressource auf einem Bucket mit Versionsfunktion führt zur Generierung einer Löschmarkierung. Der versionId Für die Löschen-Markierung wird mit dem zurückgegeben x-amz-version-id Kopfzeile der Antwort und das x-amz-delete-marker Der Antwortkopf wird auf festgelegt true.

  • Wird ein Objekt ohne gelöscht versionId unterressource in einem Version suspended Bucket führt es zu einer dauerhaften Löschung einer bereits vorhandenen 'null' Version oder eines 'null' Löschmarker und der Generierung eines neuen 'null' Löschmarker. Der x-amz-delete-marker Der Antwortkopf wird auf festgelegt true.

    Hinweis: In bestimmten Fällen können für ein Objekt mehrere Löschen-Marker vorhanden sein.

Siehe "Konfigurieren Sie die S3-Objektsperre über die S3-REST-API" Anleitung zum Löschen von Objektversionen im GOVERNANCE-Modus.

Objekte deObjekteObjekte

(Zuvor benanntes DELETE mehrere Objekte)

Multi-Faktor Authentication (MFA) und Response Header x-amz-mfa Werden nicht unterstützt.

In derselben Anforderungsmeldung können mehrere Objekte gelöscht werden.

Siehe "Konfigurieren Sie die S3-Objektsperre über die S3-REST-API" Anleitung zum Löschen von Objektversionen im GOVERNANCE-Modus.

DeleteObjectTagging

Verwendet das tagging unterressource, um alle Tags aus einem Objekt zu entfernen.

Versionierung

Wenn der versionId Der Abfrageparameter wird in der Anforderung nicht angegeben. Der Vorgang löscht alle Tags von der neuesten Version des Objekts in einem versionierten Bucket. Wenn es sich bei der aktuellen Version des Objekts um eine Löschmarkierung handelt, wird der Status „MethodenNotAllowed“ mit dem zurückgegeben x-amz-delete-marker Antwortkopfzeile auf gesetzt true.

GetObject

"GetObject"

GetObjectAcl

Wenn für das Konto die erforderlichen Zugangsdaten bereitgestellt werden, gibt der Vorgang eine positive Antwort und die ID, DisplayName und die Berechtigung des Objekteigentümers zurück und gibt an, dass der Eigentümer vollen Zugriff auf das Objekt hat.

GetObjectLegalHold

"Konfigurieren Sie die S3-Objektsperre über die S3-REST-API"

GetObjectRetention

"Konfigurieren Sie die S3-Objektsperre über die S3-REST-API"

GetObjectTagging

Verwendet das tagging unterressource, um alle Tags für ein Objekt zurückzugeben.

Versionierung

Wenn der versionId Der Abfrageparameter wird in der Anforderung nicht angegeben. Der Vorgang gibt alle Tags der neuesten Version des Objekts in einem versionierten Bucket zurück. Wenn es sich bei der aktuellen Version des Objekts um eine Löschmarkierung handelt, wird der Status „MethodenNotAllowed“ mit dem zurückgegeben x-amz-delete-marker Antwortkopfzeile auf gesetzt true.

HeadObject

"HeadObject"

Objekt restoreObject

"Objekt restoreObject"

PutObject

"PutObject"

CopyObject

(Zuvor PUT Object – Copy genannt)

"CopyObject"

PutObjectLegalHold

"Konfigurieren Sie die S3-Objektsperre über die S3-REST-API"

PutObjectRetention

"Konfigurieren Sie die S3-Objektsperre über die S3-REST-API"

PutObjectTagging

Verwendet das tagging unterressource, um einem vorhandenen Objekt einen Satz von Tags hinzuzufügen.

Grenzwerte für Objekt-Tags

Sie können neue Objekte mit Tags hinzufügen, wenn Sie sie hochladen, oder Sie können sie zu vorhandenen Objekten hinzufügen. StorageGRID und Amazon S3 unterstützen bis zu 10 Tags für jedes Objekt. Tags, die einem Objekt zugeordnet sind, müssen über eindeutige Tag-Schlüssel verfügen. Ein Tag-Schlüssel kann bis zu 128 Unicode-Zeichen lang sein, und Tag-Werte können bis zu 256 Unicode-Zeichen lang sein. Bei den Schlüsseln und Werten wird die Groß-/Kleinschreibung beachtet.

Tag-Updates und Ingest-Verhalten

Wenn Sie PutObjectTagging verwenden, um die Tags eines Objekts zu aktualisieren, nimmt StorageGRID das Objekt nicht erneut auf. Das bedeutet, dass die in der übereinstimmenden ILM-Regel angegebene Option für das Aufnahmeverhalten nicht verwendet wird. Sämtliche durch das Update ausgelösten Änderungen an der Objektplatzierung werden vorgenommen, wenn ILM durch normale ILM-Prozesse im Hintergrund neu bewertet wird.

Das heißt, wenn die ILM-Regel die strikte Option für das Aufnahmeverhalten verwendet, werden keine Maßnahmen ergriffen, wenn die erforderlichen Objektplatzierungen nicht vorgenommen werden können (z. B. weil ein neu erforderlicher Speicherort nicht verfügbar ist). Das aktualisierte Objekt behält seine aktuelle Platzierung bei, bis die erforderliche Platzierung möglich ist.

Konflikte lösen

Widersprüchliche Clientanforderungen, wie z. B. zwei Clients, die in denselben Schlüssel schreiben, werden auf der Grundlage der „neuesten Wins“ gelöst. Der Zeitpunkt für die Bewertung „neuester Erfolge“ basiert auf dem Zeitpunkt, an dem das StorageGRID System eine bestimmte Anforderung abgeschlossen hat und nicht auf dem Zeitpunkt, an dem S3-Clients einen Vorgang starten.

Versionierung

Wenn der versionId Der Abfrageparameter wird in der Anforderung nicht angegeben, und der Vorgang fügt Tags zur aktuellen Version des Objekts in einem versionierten Bucket hinzu. Wenn es sich bei der aktuellen Version des Objekts um eine Löschmarkierung handelt, wird der Status „MethodenNotAllowed“ mit dem zurückgegeben x-amz-delete-marker Antwortkopfzeile auf gesetzt true.

SelektierObjectContent

"SelektierObjectContent"