Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Récupérer un objet depuis un bucket dans StorageGRID avec la requête GetObject

PDF

Vous pouvez utiliser la requête S3 GetObject pour récupérer un objet depuis un compartiment S3.

GetObject et objets multipart

Vous pouvez utiliser le `partNumber`paramètre de requête pour récupérer une partie spécifique d'un objet multipart ou segmenté. L' `x-amz-mp-parts-count`élément de réponse indique combien de parties l'objet possède.

Vous pouvez définir partNumber à 1 pour les objets segmentés/multipart et les objets non segmentés/non multipart ; cependant, l’élément de réponse x-amz-mp-parts-count n’est renvoyé que pour les objets segmentés ou multipart.

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 GET concernant un objet dont les métadonnées définies par l'utilisateur contiennent des caractères UTF-8 échappés ne renvoient pas l `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: Spécifiez ENABLED

    L' Range`en-tête n'est pas pris en charge avec `x-amz-checksum-mode pour GetObject. Lorsque vous incluez Range dans la requête avec x-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

Versionnage

Si aucune versionId sous-ressource n'est spécifiée, l'opération récupère 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, un statut « Not Found » est renvoyé avec l' 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 des 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: Précisez AES256.

  • 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.

Avertissement 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, examinez les considérations dans "Utilisez le chiffrement côté serveur".

Comportement de GetObject pour les objets Cloud Storage Pool

Si un objet a été stocké dans un "Pool de stockage cloud", le comportement d'une requête GetObject dépend de l'état de l'objet. Voir "HeadObject" pour plus de détails.

Remarque Si un objet est stocké dans un Cloud Storage Pool et qu'une ou plusieurs copies de cet objet existent également sur la grille, les requêtes GetObject tenteront de récupérer les données à partir de la grille avant de les récupérer à partir du Cloud Storage Pool.
État de l'objet Comportement de GetObject

Objet ingéré dans StorageGRID mais pas encore évalué par ILM, ou objet stocké dans un pool de stockage traditionnel ou utilisant le code d'effacement

200 OK

Une copie de l'objet est récupérée.

Objet présent dans le pool de stockage cloud mais n'ayant pas encore été transféré dans un état non récupérable

200 OK

Une copie de l'objet est récupérée.

L'objet est passé dans un état non récupérable

403 Forbidden, InvalidObjectState

Utilisez une "RestoreObject" demande pour restaurer l'objet à un état récupérable.

Objet en cours de restauration à partir d'un état non récupérable

403 Forbidden, InvalidObjectState

Attendez que la requête RestoreObject soit terminée.

Objet entièrement restauré dans le Cloud Storage Pool

200 OK

Une copie de l'objet est récupérée.

Objets multipartites ou segmentés dans un Cloud Storage Pool

Si vous avez importé un objet multipart ou si StorageGRID a divisé un objet volumineux en segments, StorageGRID détermine si l'objet est disponible dans le Cloud Storage Pool en échantillonnant un sous-ensemble des parties ou segments de l'objet. Dans certains cas, une requête GetObject peut renvoyer 200 OK de façon incorrecte lorsque certaines parties de l'objet ont déjà été transférées dans un état non récupérable ou lorsque certaines parties de l'objet n'ont pas encore été restaurées.

Dans ces cas :

  • La requête GetObject peut renvoyer des données mais s'interrompre en cours de transfert.

  • Une requête GetObject ultérieure pourrait renvoyer 403 Forbidden.

GetObject et réplication inter-grilles

Si vous utilisez "fédération de grid" et "réplication inter-grilles" est activé pour un compartiment, le client S3 peut vérifier l'état de réplication d'un objet en envoyant une requête GetObject. 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 :

Grid État de la réplication

Source

  • TERMINÉ : La réplication a réussi.

  • EN ATTENTE : L’objet n’a pas encore été répliqué.

  • ÉCHEC : La réplication a échoué de manière permanente. Un utilisateur doit résoudre l’erreur.

Destination

REPLICA : L’objet a été répliqué à partir de la grille source.
Remarque StorageGRID ne prend pas en charge l' `x-amz-replication-status`en-tête.