Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création de noms de clés d'objet
La clé d'objet (ou nom de clé) identifie de façon unique l'objet dans un compartiment Amazon S3. Les métadonnées d'objet sont un ensemble de paires de noms-valeurs. Pour plus d’informations sur les métadonnées d’objet, consultez Utilisation des métadonnées d'objet.
Lorsque vous créez un objet, vous spécifiez le nom de clé, qui identifie de façon unique l'objet dans le compartiment. Par exemple, dans la console Amazon S3
Note
Les noms de clé d'objet avec la valeur « soap » ne sont pas pris en charge pour les virtual-hosted-style requêtes. Pour les noms de clé d'objet contenant la valeur « soap », une URL de type chemin d'accès doit être utilisée à la place.
Le modèle de données Amazon S3 est une structure horizontale : vous créez un compartiment et ce compartiment stocke des objets. Il n'existe aucune hiérarchie de sous-compartiments ou de sous-dossiers. Toutefois, vous pouvez déduire une hiérarchie logique grâce aux préfixes et délimiteurs de nom de clé à l'image de la console Amazon S3. La console Amazon S3 prend en charge un concept de dossiers. Pour en savoir plus sur la modification des métadonnées à partir de la console Amazon S3, veuillez consulter Modification des métadonnées d'objet dans la console Amazon S3.
Imaginons que le compartiment (admin-created
) comporte quatre objets avec les clés d'objet suivantes :
Development/Projects.xls
Finance/statement1.pdf
Private/taxdocument.pdf
s3-dg.pdf
La console utilise les préfixes de nom de clé (Development/
, Finance/
et Private/
) ainsi que le délimiteur (« / ») pour présenter une structure de dossiers. La clé s3-dg.pdf
ne possède pas de préfixe, son objet apparaît donc directement à la racine du compartiment. Si vous ouvrez le dossier Development/
, vous voyez qu'il contient l'objet Projects.xlsx
.
Amazon S3 prend en charge les compartiments et les objets. Il n'y a aucune hiérarchie. Cependant, en utilisant des préfixes et des délimiteurs dans le nom d'une clé d'objet, la console Amazon S3 et les AWS SDK peuvent déduire une hiérarchie et introduire le concept de dossiers.
La console Amazon S3 implémente la création d'objets de dossier en créant un objet de type zéro octet avec la valeur préfixe et délimiteur du dossier comme clé. Ces objets de dossier n'apparaissent pas dans la console. Sinon, ils se comportent comme n'importe quel autre objet et peuvent être visualisés et manipulés via l'API REST, la AWS CLI et AWS les SDK.
Directives de dénomination de la clé d'objet
Vous pouvez utiliser n'importe quel caractère UTF-8 dans le nom de clé d'un objet. L'utilisation de certains caractères dans les noms de clé peut toutefois générer des problèmes avec certaines applications et certains protocoles. Les directives suivantes vous aident à optimiser la conformité avec le DNS, les -caractères adaptés pour le web, les analyseurs XML et les autres API.
Caractères adaptés
Les caractères configurés suivants sont généralement adaptés à une utilisation dans les noms de clés.
Alphanumeric characters |
|
Special characters |
|
Voici des exemples de noms de clés d'objet valides :
-
4my-organization
-
my.great_photos-2014/jan/myvacation.jpg
-
videos/2014/birthday/video1.wmv
Note
Pour les objets téléchargés à l'aide de la console Amazon S3, dont le nom de clé se termine par un ou plusieurs points « . », ceux-ci sont supprimés du nom de clé de l'objet téléchargé. Pour télécharger un objet dont le nom de clé se termine par un ou plusieurs points «. » conservé dans l'objet téléchargé, vous devez utiliser le AWS Command Line Interface (AWS CLI), AWS les SDK ou l'API REST.
En outre, vous devez connaître les limitations suivantes en ce qui concerne les préfixes :
-
Les objets avec le préfixe « ./ » doivent être chargés ou téléchargés avec le AWS Command Line Interface (AWS CLI), les AWS SDK ou l'API REST. Vous ne pouvez pas utiliser la console Amazon S3.
-
Les objets dont le préfixe est « ../ » ne peuvent pas être chargés à l'aide de la commande AWS Command Line Interface (AWS CLI) ou la console Amazon S3.
Caractères pouvant exiger une manipulation spéciale
Les caractères suivants dans un nom de clé peuvent exiger une manipulation de code supplémentaire et ont probablement besoin d'être encodés en URL ou référencés comme valeur HEX. Certains de ces caractères ne sont pas imprimables et le navigateur peut ne pas réussir à les traiter, ce qui exige également une manipulation spéciale :
-
Esperluette (« & »)
-
Dollar (« $ »)
-
Les caractères ASCII 00–1F hex (0–31 décimale) et 7F (127 décimale)
-
Arobase (« @ »)
-
Egal (« = »)
-
Point-virgule (« ; »)
-
Barre oblique (« / »)
-
Deux-points (« : »)
-
Plus (« + »)
-
Espace – Des séquences d'espaces significatives peuvent être perdues dans certaines utilisations (notamment les espaces multiples)
-
Virgule (« , »)
-
Point d'interrogation (« ? »)
Caractères à éviter
Pour des questions de cohérence entre toutes les applications, évitez les caractères suivants dans un nom de clé, car ils exigent une manipulation spéciale considérable.
-
Barre oblique inverse (« \ »)
-
Accolade gauche (« { »)
-
Caractères ASCII non imprimables (128–255 caractères décimaux)
-
Lambda (« ^ »)
-
Accolade droite (« } »)
-
Pourcentage (« % »)
-
Accent grave/guillemet inversé (« ` »)
-
Crochet droit (« ] »)
-
Guillemets
-
Supérieur à (« > »)
-
Crochet gauche (« [ »)
-
Tilde (« ~ »)
-
Symbole « inférieur à » (« < »)
-
Dièse (« # »)
-
Barre verticale/pipe (« | »)
Contraintes de clé d'objet XML
Comme spécifié par la norme XML relative à la end-of-line manipulation
' comme
'
” comme
"
& comme
&
< comme
<
> comme
>
\ r comme
ou
\ n comme
ou

L'exemple suivant montre l'utilisation d'un code d'entité XML à la place d'un retour chariot. Cette demande DeleteObjects
supprime un objet avec le paramètre key
: /some/prefix/objectwith\rcarriagereturn
(où \ r est le retour chariot).
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Object> <Key>/some/prefix/objectwith carriagereturn</Key> </Object> </Delete>