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 "Konsistenzkontrollen" Werden von allen Operationen auf Objekten unterstützt, mit Ausnahme der folgenden:

    • GET Objekt-ACL

    • OPTIONS /

    • LEGALE Aufbewahrung des Objekts EINGEBEN

    • AUFBEWAHRUNG von Objekten

    • Wählen Sie Objektinhalt

  • 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 Auswertung „latest-WINS“ basiert darauf, wann das StorageGRID System eine bestimmte Anfrage abschließt, und nicht auf, wenn 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

Objekt LÖSCHEN

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

Bei der Verarbeitung einer LÖSCHOBJEKTANFORDERUNG versucht StorageGRID, alle Kopien des Objekts sofort 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.

LÖSCHEN Sie mehrere Objekte

(DeleteObjects)

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.

Objekt-Tagging LÖSCHEN

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 die aktuelle Version des Objekts ein Löschen-Marker ist, wird mit dem ein Status „MethodNotAllowed“ zurückgegeben x-amz-delete-marker Antwortkopfzeile auf gesetzt true.

GET Objekt

"GET Objekt"

GET Objekt-ACL

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.

HOLD-Aufbewahrung für Objekte

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

Aufbewahrung von Objekten

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

GET Objekt-Tagging

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 die aktuelle Version des Objekts ein Löschen-Marker ist, wird mit dem ein Status „MethodNotAllowed“ zurückgegeben x-amz-delete-marker Antwortkopfzeile auf gesetzt true.

HEAD Objekt

"HEAD Objekt"

WIEDERHERSTELLUNG VON POSTOBJEKTEN

"WIEDERHERSTELLUNG VON POSTOBJEKTEN"

PUT Objekt

"PUT Objekt"

PUT Objekt - Kopieren

"PUT Objekt - Kopieren"

LEGALE Aufbewahrung des Objekts EINGEBEN

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

AUFBEWAHRUNG von Objekten

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

PUT Objekt-Tagging

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 PUT Objekt-Tagging zum Aktualisieren der Tags eines Objekts verwenden, 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 „latest-WINS“-Basis gelöst. Der Zeitpunkt für die Auswertung „latest-WINS“ basiert darauf, wann das StorageGRID System eine bestimmte Anfrage abschließt, und nicht auf, wenn 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 die aktuelle Version des Objekts ein Löschen-Marker ist, wird mit dem ein Status „MethodNotAllowed“ zurückgegeben x-amz-delete-marker Antwortkopfzeile auf gesetzt true.

SelektierObjectContent

"SelektierObjectContent"
Verwandte Informationen

"S3-Vorgänge werden in Prüfprotokollen nachverfolgt"