Objet principal
Suggérer des modifications
PDF
Vous pouvez utiliser la requête S3 HeadObject pour extraire des métadonnées d'un objet sans renvoyer l'objet. 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.
Objets en-tête et objets multipièces
Vous pouvez utiliser partNumber le paramètre request pour extraire des métadonnées pour une partie spécifique d'un objet multipièce ou segmenté. L' `x-amz-mp-parts-count`élément de réponse indique le nombre de parties de l'objet.
Vous pouvez définir partNumber la valeur 1 pour les objets segmentés/multipièces et les objets non segmentés/non multipièces ; cependant, l' `x-amz-mp-parts-count`élément de réponse est renvoyé uniquement pour les objets segmentés ou multipièces.
Caractères UTF-8 dans les métadonnées utilisateur
StorageGRID n'analyse ni n'interprète pas les caractères UTF-8 qui se sont échappés dans les métadonnées définies par l'utilisateur. Les demandes 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 l' `x-amz-missing-meta`en-tête si le nom ou la valeur de la clé contient des caractères non imprimables.
En-tête de demande pris en charge
L'en-tête de demande suivant est pris en charge :
-
x-amz-checksum-modeLe
partNumberparamètre et l'Range`en-tête ne sont pas pris en charge avec `x-amz-checksum-modepour HeadObject. Lorsque vous les incluez dans la demande avecx-amz-checksum-modeactivé, StorageGRID ne renvoie pas de valeur de somme de contrôle dans la réponse.
En-tête de demande 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 aucune versionId sous-ressource n'est spécifiée, l'opération extrait la version la plus récente de l'objet dans un compartiment versionné. Si la version actuelle de l'objet est un marqueur de suppression, l'état « introuvable » est renvoyé avec l' x-amz-delete-marker`en-tête de réponse défini sur `true.
En-têtes de demande pour chiffrement côté serveur avec clés de chiffrement fournies par le client (SSE-C)
Utilisez les trois en-têtes si l'objet est chiffré avec une clé unique que vous avez fournie.
-
x-amz-server-side-encryption-customer-algorithm: SpécifiezAES256. -
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 résumé 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 des clés fournies par le client pour sécuriser les données d'objet, consultez les considérations de la section "Utilisez le cryptage côté serveur". |
HeadObject Responses for Cloud Storage Pool objects
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 lors de son déplacement vers Cloud Storage Pool, qui peut être migré vers un état non récupérable et restauré.
| État de l'objet | Réponse à l'objet principal |
|---|---|
Les objets sont ingéré dans StorageGRID mais pas encore évalués par ILM, ou objet stocké dans un pool de stockage traditionnel ou au moyen d'un code d'effacement |
|
Objet dans Cloud Storage Pool, mais pas encore migré vers un état non récupérable |
Jusqu'à ce que l'objet soit transféré à un état non récupérable, la valeur de |
L'objet est passé à l'état non récupérable, mais il existe au moins une copie sur la grille |
La valeur de Remarque : si la copie de la grille n'est pas disponible (par exemple, un nœud de stockage est en panne), vous devez émettre une "Objet de restauration" demande de restauration de la copie à partir du pool de stockage cloud avant de pouvoir récupérer l'objet. |
L'objet a été transféré à 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 partitionnés ou segmentés dans Cloud Storage Pool
Si vous avez téléchargé un objet partitionné ou si StorageGRID le divise en segments, StorageGRID détermine si l'objet est disponible dans le pool de stockage cloud en échantillonant un sous-ensemble de parties ou de segments de l'objet. Dans certains cas, une requête HeadObject peut être renvoyée de manière incorrecte x-amz-restore: ongoing-request="false" lorsque certaines parties de l'objet ont déjà été transférées à un état non récupérable ou lorsque certaines parties de l'objet n'ont pas encore été restaurées.
HeadObject et réplication inter-grid
Si vous utilisez "fédération des grilles" et "réplication entre plusieurs grilles" est activé pour un compartiment, le client S3 peut vérifier l'état de réplication d'un objet en émettant une requête HeadObject. La réponse inclut l'en-tête de réponse spécifique à StorageGRID x-ntap-sg-cgr-replication-status, qui aura l'une des valeurs suivantes :
| Grille | État de la réplication |
|---|---|
Source |
|
Destination |
RÉPLIQUE : l'objet a été répliqué à partir de la grille source. |
|
StorageGRID ne prend pas en charge la x-amz-replication-status barre de coupe.
|