Allgemeine Header und Fehlercodes

Datenübertragungen verwenden zahlreiche Standardprotokolle. Des Weiteren gelten für diese Datenübertragungen individuelle Anforderungen. Bleiben Sie in Bezug auf die Verweise auf allgemeine Header und bestimmte Fehlercodes immer auf dem neuesten Stand.

Allgemeine Anforderungsheader

In der folgenden Tabelle werden die unterstützten gängigen Request-Header beschrieben. IBM Cloud® Object Storage ignoriert alle gängigen Header, die nicht unten aufgeführt sind, wenn sie als Teil einer Anfrage gesendet werden, obwohl einige Anfragen möglicherweise zusätzliche Header unterstützen, wie in diesem Dokument definiert.

Überschrift Anmerkung
Berechtigung Erforderlich für alle Anforderungen (OAuth2-Token bearer).
ibm-service-instance-id Erforderlich für Anforderungen zum Erstellen oder Auflisten von Buckets.
Content-MD5 Der Base64-codierte binäre 128-Bit-MD5-Hashwert der Nutzdaten, der für die Integritätsprüfung verwendet wird, um sicherzustellen, dass die Nutzdaten während der Übertragung nicht geändert wurden. Die Base64-Codierung muss für die binäre Ausgabe des MD5-Hashwerts und nicht für seine hexadezimale Darstellung durchgeführt werden.
x-amz-checksum-crc32 Dieser Header ist die Base64 kodierte, 32-Bit CRC32 Prüfsumme des Objekts.
x-amz-checksum-crc32c Dieser Header ist die Base64 kodierte, 32-Bit CRC32C Prüfsumme des Objekts.
x-amz-checksum-crc64nvme Dieser Header ist die Base64 kodierte, 64-Bit CRC64NVME Prüfsumme des Objekts. Die Prüfsumme CRC64NVME ist immer eine vollständige Objektprüfsumme.
x-amz-checksum-sha1 Dieser Header ist der Base64 verschlüsselte 160-Bit-Digest des Objekts SHA1.
x-amz-checksum-sha256 Dieser Header ist der Base64 kodierte, 256-Bit SHA256 Digest des Objekts.
x-amz-sdk-checksum-algorithm Gibt den Algorithmus an, der bei Verwendung des SDK zur Erstellung der Prüfsumme für das Objekt verwendet wird.
Expect Beim Wert 100-continue wird auf die Bestätigung des Systems gewartet, dass die Header korrekt sind, bevor die Nutzdaten gesendet werden.
host Entweder die Endpunkt- oder die „Virtual Host“-Syntax von {bucket-name}.{endpoint}. In der Regel wird dieser Header automatisch hinzugefügt. Weitere Informationen zu Endpunkten finden Sie in Endpunkte und Speicherpositionen.
Cache-Control Kann verwendet werden, um das Caching-Verhalten für den Verlauf der Anforderungs-/Antwortkette anzugeben. Weitere Informationen finden Sie unter http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9.

Angepasste Metadaten

Ein Vorteil bei der Verwendung von Object Storage ist die Möglichkeit, benutzerdefinierte Metadaten hinzuzufügen, indem Schlüssel/Wert-Paare als Header gesendet werden. Diese Header werden im Format x-amz-meta-{KEY} angegeben. Beachten Sie, dass im Gegensatz zu AWS S3 die Funktion IBM Cloud Object Storage mehrere Header mit demselben Metadatenschlüssel zu einer durch Kommas getrennten Liste von Werten zusammenfasst.

Allgemeine Antwortheader

In der folgenden Tabelle werden die allgemeinen Antwortheader beschrieben.

Überschrift Anmerkung
Content-Length Die Länge des Anforderungshauptteils in Byte.
Connection Gibt an, ob die Verbindung geöffnet oder geschlossen ist.
Date Die Zeitmarke der Anforderung.
ETag Der MD5-Hashwert der Anforderung.
Server Der Name des antwortenden Servers.
X-Clv-Request-Id Eindeutige Kennung, die für jede Anforderung generiert wird.

Lebenszyklusantwortheader

In der folgenden Tabelle werden Antwortheader für archivierte Objekte beschrieben.

Überschrift Anmerkung
x-amz-restore Wird angegeben, wenn das Objekt wiederhergestellt wurde oder wenn momentan eine Wiederherstellung ausgeführt wird.
x-amz-storage-class Gibt „ GLACIER “ oder „ ACCELERATED “ zurück, wenn die Datei archiviert oder vorübergehend wiederhergestellt wurde.
x-ibm-archive-transition-time Gibt den Zeitpunkt (Datum und Uhrzeit) zurück, zu dem das Objekt für den Übergang in das Archivierungstier eingeplant ist.
x-ibm-transition Wird angegeben, wenn das Objekt über Übergangsmetadaten verfügt und das Tier und die ursprüngliche Uhrzeit des Übergangs zurückgibt.
x-ibm-restored-copy-storage-class Wird angegeben, wenn ein Objekt sich im Status RestoreInProgress oder Restored befindet und die Speicherklasse des Buckets zurückgibt.

Eine Auflistung der Fehlercodes finden Sie in der API-Dokumentation