OBTENIR l'objet
Vous pouvez utiliser la requête D'objet GET S3 pour récupérer un objet à partir d'un compartiment S3.
OBTENIR un objet et des objets partitionnés
Vous pouvez utiliser le partNumber
paramètre de demande pour récupérer une partie spécifique d'un objet partitionné ou segmenté. Le x-amz-mp-parts-count
l'élément de réponse indique le nombre de pièces dont dispose l'objet.
Vous pouvez définir partNumber
à 1 pour les objets segmentés/multisegments et les objets non segmentés/non-partitionnés ; cependant, le x-amz-mp-parts-count
l'élément de réponse n'est renvoyé que pour les objets segmentés ou partitionnés.
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 cryptage 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 les clés fournies par le client pour sécuriser les données d'objet, consultez les considérations de la section « utilisation du cryptage côté serveur ». |
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 D'OBTENTION d'un objet ayant échappé à l'UTF-8 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é comporte des caractères non imprimables.
En-tête de demande non pris en charge
L'en-tête de demande 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 extrait la version la plus récente de l'objet dans un compartiment multiversion. Si la version actuelle de l'objet est un marqueur de suppression, un état « non trouvé » est renvoyé avec le x-amz-delete-marker
réponse en-tête réglée sur true
.
Comportement de L'objet GET pour les objets de pool de stockage cloud
Si un objet a été stocké dans un pool de stockage cloud (voir les instructions de gestion des objets avec gestion du cycle de vie des informations), le comportement d'une requête D'objet GET dépend de l'état de l'objet. Voir « objet TÊTE » pour plus de détails.
Si un objet est stocké dans un pool de stockage cloud et qu'une ou plusieurs copies de cet objet existent également dans la grille, L'OBTENTION des demandes d'objet tente d'extraire les données de la grille avant de les récupérer depuis le pool de stockage cloud. |
État de l'objet | Comportement de L'objet GET |
---|---|
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 |
Une copie de l'objet est récupérée. |
Objet dans Cloud Storage Pool, mais pas encore migré vers un état non récupérable |
Une copie de l'objet est récupérée. |
L'objet a été transféré à un état non récupérable |
Utilisez une demande DE restauration POST-objet pour restaurer l'objet à un état récupérable. |
Objet en cours de restauration à partir d'un état non récupérable |
Attendez que la demande DE restauration POST Object soit terminée. |
Objet entièrement restauré dans le pool de stockage cloud |
Une copie de l'objet est récupérée. |
Objets partitionnés ou segmentés dans un pool de stockage cloud
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 demande GET Object peut retourner de manière incorrecte 200 OK
lorsque certaines parties de l'objet ont déjà été migrées à un état non récupérable ou lorsque certaines parties de l'objet n'ont pas encore été restaurées.
Dans ces cas :
-
La demande GET Object peut renvoyer certaines données mais s'arrête à mi-chemin du transfert.
-
Une requête GET Object suivante peut revenir
403 Forbidden
.