Lire un objet
Récupérez les métadonnées d'un objet dans AWS S3.
Les objets de lecture qui ont été chargés avec des clés de chiffrement SSE-C doivent également être fournis à la carte Lire un objet, sinon une erreur 400 Bad Request (Mauvaise requête 400) est renvoyée.
Options
| Champ | Définition | Type | Obligatoire |
|---|---|---|---|
|
Région |
Région de votre compartiment AWS S3. Choisissez une région pour votre compartiment AWS S3. |
Liste déroulante | TRUE |
Entrée
| Champ | Définition | Type | Obligatoire |
|---|---|---|---|
|
Options |
|||
|
Compartiment |
Nom du compartiment qui contient l'objet. |
Texte | TRUE |
|
Clé |
Nom de la clé de l'objet à lire. |
Texte | TRUE |
|
ID de version |
ID de version utilisé pour référencer une version spécifique de l'objet à lire. Si l'ID de version est null, saisissez la valeur de la chaîne, null. |
Texte | FALSE |
|
Payeur de la demande |
Confirme que le demandeur sait que la requête lui sera facturée. |
Liste déroulante | FALSE |
|
Propriétaire du compartiment attendu |
ID du compte du propriétaire du compartiment attendu. Si un compte différent est propriétaire du compartiment source, la requête échoue avec une erreur HTTP 403 (Accès refusé). |
Texte | FALSE |
|
Chiffrement côté serveur - Algorithme client |
Spécifie l'algorithme à utiliser pour le déchiffrement de l'objet |
Texte | FALSE |
|
Chiffrement côté serveur - Clé client |
Spécifie la clé de chiffrement fournie par le client que AWS S3 utilise pour chiffrer les données. Cette valeur est utilisée pour déchiffrer l'objet lors de sa récupération et doit correspondre à celle utilisée lors du stockage des données. La clé doit convenir à une utilisation avec l'algorithme spécifié dans l'algorithme du client ESS. |
Texte | FALSE |
|
Chiffrement côté serveur - Clé client MD5 |
Spécifie l'algorithme Digest MD5 de 128 bits de la clé de chiffrement, conformément à RFC 1321. |
Texte | FALSE |
|
En cas de correspondance |
Lisez l'objet si sa balise d'entité (ETag) correspond à la balise spécifiée. |
Texte | FALSE |
|
En cas de modification depuis |
Lisez l'objet s'il a été modifié depuis l'heure spécifiée. Par exemple : Ven 14 jan 2022 23:34:36 GMT. |
Texte | FALSE |
|
En cas d'absence de correspondance |
Lisez l'objet si sa balise d'entité (ETag) est différente de celle spécifiée. |
Texte | FALSE |
|
En cas d'absence de modification depuis |
Lisez l'objet s'il n'a pas été modifié depuis l'heure spécifiée. Par exemple : Ven 14 jan 2022 23:34:36 GMT. |
Texte | FALSE |
Sortie
| Champ | Définition | Type |
|---|---|---|
|
Réponse |
||
|
ID de version |
ID de version de l'objet |
Texte |
|
Dernière modification |
Date de dernière modification de l'objet. |
Texte |
|
ETag |
Identificateur opaque affecté par un serveur Web à une version spécifique d'une ressource trouvée au niveau d'une URL. |
Texte |
|
Type de contenu |
Type MIME standard qui décrit le format des données de l'objet. |
Texte |
|
Taille |
Taille de l'objet en octets. |
Nombre |
|
Statut de l'archive |
État de l'archive de l'objet de tête. |
Texte |
|
Marqueur de suppression |
Si Si la valeur est False, cet en-tête de réponse n'apparaît pas dans la réponse. |
Vrai/Faux |
|
Expiration |
Si l'expiration de l'objet est configurée (cycle de vie de compartiment PUT), la réponse inclut cette valeur. |
Texte |
|
Nombre de pièces |
Nombre de parties que contient cet objet |
Nombre |
|
Mise en attente légale du verrouillage d'objet |
Indique si une mise en attente légale est en vigueur pour cet objet. Cette valeur n'est pas renvoyée si la version spécifiée de cet objet n'a jamais fait l'objet d'une mise en attente légale. |
Vrai/Faux |
|
Mode de verrouillage d'objet |
Indique si ce compartiment a un verrouillage d'objet en vigueur pour cet objet. |
Texte |
|
Conserver le verrouillage d'objet jusqu'à la date |
Date et heure d'expiration de la période de conservation du verrouillage d'objet. |
Texte |
|
Statut de réplication |
AWS S3 renvoie cette valeur si votre requête implique un compartiment qui est une source ou une destination dans une règle de réplication. |
Texte |
|
Requête facturée |
Si cette option est présente, elle indique que le demandeur a bien été facturé pour la requête. |
Texte |
|
Restaurer |
Si l'objet est un objet archivé (un objet dont la classe de stockage est GLACIER), la réponse inclut cette valeur, à condition que la restauration de l'archive soit en cours (consultez RestoreObject) ou qu'une copie d'archive soit déjà restaurée. Si une copie d'archivage est déjà restaurée, la valeur indique quand AWS S3 est planifié pour supprimer la copie de l'objet. Si la restauration de l'objet est en cours, l'en-tête renvoie true. |
Texte |
|
Chiffrement côté serveur |
Si l'objet est stocké à l'aide du chiffrement côté serveur avec une clé AWS KMS ou une clé de chiffrement gérée par AWS S3, la réponse inclut cette valeur avec l'algorithme de chiffrement côté serveur utilisé lors du stockage de cet objet dans AWS S3. |
Texte |
|
Chiffrement côté serveur - ID de clé AWS KMS |
Si présent, spécifie l'ID de la clé symétrique gérée par le client AWS Key Management Service (AWS KMS) utilisée pour l'objet |
Texte |
|
Chiffrement côté serveur - Clé de compartiment activée |
Indique si l'objet utilise une clé de compartiment AWS S3 pour le chiffrement côté serveur avec AWS KMS (SSE-KMS). |
Texte |
|
Chiffrement côté serveur - Algorithme client |
Si un chiffrement côté serveur avec une clé de chiffrement fournie par le client a été demandé, la réponse comprendra cet en-tête qui confirme l'algorithme de chiffrement utilisé. |
Texte |
|
Chiffrement côté serveur - Clé client MD5 |
Si le chiffrement côté serveur avec une clé de chiffrement fournie par le client a été demandé, la réponse comprendra cet en-tête pour fournir une vérification de l'intégrité du message aller-retour de la clé de chiffrement fournie par le client. |
Texte |
|
Classe de stockage |
Fournit des informations sur la classe de stockage de l'objet. AWS S3 renvoie cet en-tête pour tous les objets, sauf pour les objets de la classe de stockage standard AWS S3. |
Texte |
|
Nombre de balises |
Nombre de balises, le cas échéant, sur l'objet. |
Nombre |
|
Emplacement de la redirection du site Web |
Si le compartiment est configuré comme un site Web, il redirige les requêtes pour cet objet vers un autre objet dans le même compartiment ou vers une URL externe. |
Texte |