HeadObject
Vous pouvez utiliser la requête S3 HeadObject pour récupérer les métadonnées d'un objet sans renvoyer l'objet lui-même. Si l'objet est stocké dans un pool de stockage cloud, vous pouvez utiliser HeadObject pour déterminer l'état de transition de l'objet.
HeadObject et objets multipartites
Vous pouvez utiliser le partNumber
paramètre de demande pour récupérer les métadonnées d'une partie spécifique d'un objet en plusieurs parties ou segmenté. Le x-amz-mp-parts-count
L'élément de réponse indique le nombre de parties que contient l'objet.
Vous pouvez définir partNumber
à 1 pour les objets segmentés/multipartites et les objets non segmentés/non multipartites ; cependant, le x-amz-mp-parts-count
L'élément de réponse n'est renvoyé que pour les objets segmentés ou en plusieurs parties.
Caractères UTF-8 dans les métadonnées utilisateur
StorageGRID n'analyse ni n'interprète les caractères UTF-8 échappés dans les métadonnées définies par l'utilisateur. Les requêtes HEAD pour un objet avec des caractères UTF-8 échappés dans les métadonnées définies par l'utilisateur ne renvoient pas le x-amz-missing-meta
en-tête si le nom ou la valeur de la clé inclut des caractères non imprimables.
En-tête de requête pris en charge
L'en-tête de requête suivant est pris en charge :
-
x-amz-checksum-mode
Le
partNumber
paramètre etRange
les en-têtes ne sont pas pris en charge avecx-amz-checksum-mode
pour HeadObject. Lorsque vous les incluez dans la demande avecx-amz-checksum-mode
activé, StorageGRID ne renvoie pas de valeur de somme de contrôle dans la réponse.
En-tête de requête non pris en charge
L'en-tête de requête suivant n'est pas pris en charge et renvoie XNotImplemented
:
-
x-amz-website-redirect-location
Gestion des versions
Si un versionId
la sous-ressource n'est pas spécifiée, l'opération récupère la version la plus récente de l'objet dans un bucket versionné. Si la version actuelle de l'objet est un marqueur de suppression, un statut « Non trouvé » est renvoyé avec le x-amz-delete-marker
en-tête de réponse défini sur true
.
En-têtes de requête pour le chiffrement côté serveur avec les clés de chiffrement fournies par le client (SSE-C)
Utilisez ces trois en-têtes si l’objet est chiffré avec une clé unique que vous avez fournie.
-
x-amz-server-side-encryption-customer-algorithm
: PréciserAES256
. -
x-amz-server-side-encryption-customer-key
:Spécifiez votre clé de chiffrement pour l'objet. -
x-amz-server-side-encryption-customer-key-MD5
: Spécifiez le condensé MD5 de la clé de chiffrement de l'objet.
|
Les clés de chiffrement que vous fournissez ne sont jamais stockées. Si vous perdez une clé de chiffrement, vous perdez l'objet correspondant. Avant d'utiliser les clés fournies par le client pour sécuriser les données d'objet, examinez les considérations dans"Utiliser le cryptage côté serveur" . |
Réponses HeadObject pour les objets Cloud Storage Pool
Si l'objet est stocké dans un"Pool de stockage cloud" , les en-têtes de réponse suivants sont renvoyés :
-
x-amz-storage-class: GLACIER
-
x-amz-restore
Les en-têtes de réponse fournissent des informations sur l'état d'un objet lorsqu'il est déplacé vers un pool de stockage cloud, éventuellement transféré vers un état non récupérable et restauré.
État de l'objet | Réponse à HeadObject |
---|---|
Objet ingéré dans StorageGRID mais pas encore évalué par ILM, ou objet stocké dans un pool de stockage traditionnel ou utilisant un codage d'effacement |
|
Objet dans le pool de stockage cloud, mais pas encore passé à un état non récupérable |
Jusqu'à ce que l'objet soit transféré vers un état non récupérable, la valeur de |
L'objet est passé à un état non récupérable, mais au moins une copie existe également sur la grille |
La valeur pour Remarque : Si la copie sur la grille n'est pas disponible (par exemple, un nœud de stockage est en panne), vous devez émettre un"Restaurer l'objet" demandez à restaurer la copie à partir du pool de stockage cloud avant de pouvoir récupérer l'objet avec succès. |
L'objet est passé à un état non récupérable et aucune copie n'existe sur la grille |
|
Objet en cours de restauration à partir d'un état non récupérable |
|
Objet entièrement restauré dans le pool de stockage cloud |
Le |
Objets multipartites ou segmentés dans le pool de stockage cloud
Si vous avez téléchargé un objet en plusieurs parties ou si StorageGRID a divisé un objet volumineux en segments, StorageGRID détermine si l'objet est disponible dans le pool de stockage cloud en échantillonnant un sous-ensemble des parties ou des segments de l'objet. Dans certains cas, une requête HeadObject peut renvoyer de manière incorrecte x-amz-restore: ongoing-request="false"
lorsque certaines parties de l'objet ont déjà été transférées vers un état non récupérable ou lorsque certaines parties de l'objet n'ont pas encore été restaurées.
Réplication HeadObject et inter-grille
Si vous utilisez"fédération de réseau" et"réplication inter-réseaux" est activé pour un bucket, le client S3 peut vérifier l'état de réplication d'un objet en émettant une demande HeadObject. La réponse inclut le StorageGRID spécifique x-ntap-sg-cgr-replication-status
en-tête de réponse, qui aura l'une des valeurs suivantes :
Grille | État de réplication |
---|---|
Source |
|
Destination |
RÉPLIQUE : L'objet a été répliqué à partir de la grille source. |
|
StorageGRID ne prend pas en charge le x-amz-replication-status en-tête.
|