En-têtes et codes d'erreur courants

Les transferts de données ont recours à des protocoles standard et ont des exigences particulières. Tenez-vous à jour sur les références des en-têtes courants et de certains codes d'erreur.

En-têtes de demande courants

Le tableau suivant présente les en-têtes de requête courants pris en charge. IBM Cloud® Object Storage ignore tous les en-têtes courants qui ne figurent pas dans la liste ci-dessous lorsqu’ils sont envoyés dans le cadre d’une requête, bien que certaines requêtes puissent prendre en charge des en-têtes supplémentaires tels que définis dans le présent document.

En-tête Note
Autorisation Obligatoire pour toutes les demandes (jeton bearer OAuth2).
ibm-service-instance-id Obligatoire pour les demandes de création ou d'affichage de liste de compartiments.
Content-MD5 Hachage MD5 binaire 128 bits codé en base64 du contenu, utilisé comme contrôle d'intégrité pour s'assurer que le contenu n'a pas été modifié en transit. Le codage en base64 doit être effectué sur la sortie binaire du hachage MD5, et non pas sur la représentation hexadécimale.
x-amz-checksum-crc32 Cet en-tête est la somme de contrôle Base64 encodée, 32 bits CRC32 de l'objet.
x-amz-checksum-crc32c Cet en-tête est la somme de contrôle Base64 encodée, 32 bits CRC32C de l'objet.
x-amz-checksum-crc64nvme Cet en-tête est la somme de contrôle Base64 encodée, 64 bits CRC64NVME de l'objet. La somme de contrôle de CRC64NVME est toujours une somme de contrôle d'objet complet.
x-amz-checksum-sha1 SHA1 Cet en-tête est le condensé de 160 bits de l'objet, codé sur Base64.
x-amz-checksum-sha256 Cet en-tête est le code Base64, 256-bit SHA256 digest de l'objet.
x-amz-sdk-checksum-algorithm Indique l'algorithme utilisé pour créer la somme de contrôle de l'objet lors de l'utilisation du SDK.
Expect La valeur 100-continue attend que le système confirme que les en-têtes sont appropriés avant d'envoyer le contenu.
host Soit la syntaxe du point de terminaison, soit celle de l'« hôte virtuel » de {bucket-name}.{endpoint}. En général, cet en-tête est automatiquement ajouté. Pour plus d'informations sur les noeuds finaux, voir Noeuds finaux et emplacements de stockage.
Cache-Control Peut être utilisé pour spécifier le comportement de la mise en cache en même temps que la chaîne demande/réponse. Pour plus d'informations, accédez à http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9

Métadonnées personnalisées

L'un des avantages liés à l'utilisation d'Object Storage est la possibilité d'ajouter des métadonnées personnalisées en envoyant des paires clé-valeur en tant qu'en-têtes. Ces en-têtes se présentent comme suit : x-amz-meta-{KEY}. Notez que, contrairement à AWS S3, IBM Cloud Object Storage regroupe plusieurs en-têtes partageant la même clé de métadonnées en une liste de valeurs séparées par des virgules.

En-têtes de réponse courants

Le tableau ci-après décrit les en-têtes de réponse communément pris en charge.

En-tête Note
Content-Length Longueur du corps de demande, exprimée en octets.
Connection Permet d'indiquer si la connexion est ouverte ou fermée.
Date Horodatage de la demande.
ETag Valeur de hachage MD5 de la demande.
Server Nom du serveur ayant répondu.
X-Clv-Request-Id Identificateur unique généré par chacune des demandes.

En-têtes de réponse de cycle de vie

Le tableau ci-après décrit les en-têtes de demande pour les objets archivés.

En-tête Note
x-amz-restore Inclus si l'objet a été restauré ou si une restauration est en cours.
x-amz-storage-class Renvoie « GLACIER » ou « ACCELERATED » si le fichier a été archivé ou restauré temporairement.
x-ibm-archive-transition-time Renvoie la date et l'heure planifiées pour la transition de l'objet vers le niveau d'archivage.
x-ibm-transition Inclus si l'objet comporte des métadonnées de transition et renvoie le niveau et l'heure d'origine de la transition.
x-ibm-restored-copy-storage-class Inclus si un objet se trouve à l'état RestoreInProgress ou Restored et renvoie la classe de stockage du compartiment.

Consultez la documentation de l'API pour obtenir la liste des codes d'erreur