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.

Rufen Sie ein Objekt aus einem Bucket in StorageGRID mit der GetObject-Anfrage ab

Änderungen vorschlagen
PDFs

Die S3 GetObject-Anfrage kann verwendet werden, um ein Objekt aus einem S3-Bucket abzurufen.

GetObject und mehrteilige Objekte

Der `partNumber`Anfrageparameter kann verwendet werden, um einen bestimmten Teil eines mehrteiligen oder segmentierten Objekts abzurufen. Das `x-amz-mp-parts-count`Antwortelement gibt an, wie viele Teile das Objekt hat.

Sie können partNumber auf 1 setzen, sowohl für segmentierte/multipart Objekte als auch für nicht segmentierte/nicht multipart Objekte; das x-amz-mp-parts-count Antwortelement wird jedoch nur für segmentierte oder multipart Objekte zurückgegeben.

UTF-8-Zeichen in Benutzermetadaten

StorageGRID analysiert oder interpretiert keine maskierten UTF-8-Zeichen in benutzerdefinierten Metadaten. GET-Anfragen für ein Objekt mit maskierten UTF-8-Zeichen in benutzerdefinierten Metadaten geben den x-amz-missing-meta Header nicht zurück, wenn der Schlüsselname oder Wert nicht druckbare Zeichen enthält.

Unterstützter Anfrageheader

Der folgende Anfrageheader wird unterstützt:

  • x-amz-checksum-mode: Angeben ENABLED

    Der Range Header wird mit x-amz-checksum-mode für GetObject nicht unterstützt. Wenn Range in der Anfrage mit x-amz-checksum-mode aktiviert enthalten ist, gibt StorageGRID keinen Prüfsummenwert in der Antwort zurück.

Nicht unterstützter Anfrageheader

Der folgende Anfrageheader wird nicht unterstützt und gibt XNotImplemented zurück:

  • x-amz-website-redirect-location

Versionierung

Wenn keine versionId Unterressource angegeben ist, wird mit dem Vorgang die neueste Version des Objekts in einem versionierten Bucket abgerufen. Wenn die aktuelle Version des Objekts eine Löschmarkierung ist, wird ein „Nicht gefunden“-Status zurückgegeben, wobei der x-amz-delete-marker Antwortheader auf true gesetzt wird.

Anfrage-Header für serverseitige Verschlüsselung mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln (SSE-C)

Alle drei Header sind zu verwenden, wenn das Objekt mit einem von Ihnen bereitgestellten eindeutigen Schlüssel verschlüsselt ist.

  • x-amz-server-side-encryption-customer-algorithm: Angeben AES256.

  • x-amz-server-side-encryption-customer-key: Geben Sie Ihren Verschlüsselungsschlüssel für das Objekt an.

  • x-amz-server-side-encryption-customer-key-MD5: Geben Sie die MD5-Prüfsumme des Verschlüsselungsschlüssels des Objekts an.

Achtung Die von Ihnen bereitgestellten Verschlüsselungsschlüssel werden niemals gespeichert. Wenn ein Verschlüsselungsschlüssel verloren geht, geht auch das zugehörige Objekt verloren. Vor der Verwendung von kundenseitig bereitgestellten Schlüsseln zur Sicherung von Objektdaten sind die Hinweise in "Serverseitige Verschlüsselung verwenden" zu beachten.

Verhalten von GetObject für Cloud Storage Pool-Objekte

Wenn ein Objekt in einem "Cloud Storage Pool" gespeichert wurde, hängt das Verhalten einer GetObject-Anfrage vom Zustand des Objekts ab. Siehe "HeadObject" für weitere Details.

Hinweis Wenn ein Objekt in einem Cloud-Speicherpool gespeichert ist und eine oder mehrere Kopien des Objekts auch im Grid vorhanden sind, wird bei GetObject-Anfragen versucht, die Daten zuerst aus dem Grid abzurufen, bevor sie aus dem Cloud-Speicherpool abgerufen werden.
Zustand des Objekts Verhalten von GetObject

Objekt, das in StorageGRID aufgenommen, aber noch nicht von ILM ausgewertet wurde, oder Objekt, das in einem herkömmlichen Speicherpool gespeichert oder mit Erasure Coding abgelegt ist

200 OK

Eine Kopie des Objekts wird abgerufen.

Objekt im Cloud Storage Pool, aber noch nicht in einen nicht abrufbaren Zustand überführt

200 OK

Eine Kopie des Objekts wird abgerufen.

Das Objekt ist in einen nicht abrufbaren Zustand übergegangen.

403 Forbidden, InvalidObjectState

Eine "RestoreObject"-Anfrage kann verwendet werden, um das Objekt in einen abrufbaren Zustand zurückzuversetzen.

Objekt befindet sich im Wiederherstellungsprozess aus einem nicht wiederherstellbaren Zustand

403 Forbidden, InvalidObjectState

Warten, bis die RestoreObject-Anfrage abgeschlossen ist.

Objekt vollständig im Cloud Storage Pool wiederhergestellt

200 OK

Eine Kopie des Objekts wird abgerufen.

Mehrteilige oder segmentierte Objekte in einem Cloud Storage Pool

Wenn Sie ein mehrteiliges Objekt hochgeladen haben oder StorageGRID ein großes Objekt in Segmente aufgeteilt hat, ermittelt StorageGRID, ob das Objekt im Cloud Storage Pool verfügbar ist, indem eine Teilmenge der Objektteile oder -segmente geprüft wird. In einigen Fällen kann eine GetObject-Anfrage fälschlicherweise 200 OK zurückgeben, wenn einige Teile des Objekts bereits in einen nicht wiederherstellbaren Zustand überführt wurden oder wenn einige Teile des Objekts noch nicht wiederhergestellt wurden.

In diesen Fällen:

  • Die GetObject Anfrage liefert möglicherweise einige Daten zurück, bricht aber mitten in der Übertragung ab.

  • Eine nachfolgende GetObject-Anfrage könnte 403 Forbidden zurückgeben.

GetObject und gridübergreifende Replikation

Wenn Sie "Grid-Föderation" verwenden und "gridübergreifende Replikation" für einen Bucket aktiviert ist, kann der S3-Client den Replikationsstatus eines Objekts durch eine GetObject-Anfrage überprüfen. Die Antwort enthält den StorageGRID-spezifischen x-ntap-sg-cgr-replication-status Response-Header, der einen der folgenden Werte aufweist:

Grid Replikationsstatus

Quelle

  • ABGESCHLOSSEN: Die Replikation war erfolgreich.

  • AUSSTEHEND: Das Objekt ist noch nicht repliziert worden.

  • FEHLER: Die Replikation ist dauerhaft fehlgeschlagen. Ein Benutzer muss den Fehler beheben.

Ziel

REPLICA: Das Objekt wurde aus dem Quellgrid repliziert.
Hinweis StorageGRID unterstützt den x-amz-replication-status Header nicht.