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.
La clé d’objet (ou nom de clé) identifie de façon unique l’objet dans un compartiment Amazon S3. Vous pouvez spécifier le nom d’une clé d’objet lors de la création de l’objet. Par exemple, dans la console Amazon S3
Le nom de la clé de l'objet est une séquence de caractères Unicode encodés en UTF-8 d'une longueur maximale de 1 024 octets, soit 1 204 caractères latins. Dans certaines langues, un seul caractère peut être égal à 2 octets. Lorsque vous nommez vos objets, tenez compte des points suivants :
-
Les noms de clés d’objet ne sont pas sensibles à la casse.
-
Les noms de clé d'objet incluent tous les préfixes (appelés dossiers dans la console). Par exemple,
Development/Projects.xlsest le nom complet de la clé d'objet de l'Projects.xlsobjet situé dans leDevelopmentpréfixe (ou le dossier). Le préfixe, le délimiteur (/) et le nom de l'objet sont inclus dans la limite de 1 024 octets pour le nom de clé de l'objet. Pour plus d'informations sur les préfixes et les dossiers, consultezChoix des noms de clés d’objet. -
Certains caractères peuvent nécessiter un traitement spécial lorsqu'ils sont utilisés dans les noms de clés d'objets. Pour de plus amples informations, veuillez consulter Directives de dénomination de la clé d’objet.
Note
Les noms de clé d'objet contenant la valeur "soap" ne sont pas pris en charge pour les virtual-hosted-style demandes. Pour les valeurs de nom de clé d'objet où "soap" il est utilisé, une URL de type chemin doit être utilisée à la place.
Choix des noms de clés d’objet
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, consultez 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/, etPrivate/) et le délimiteur (/) pour présenter une structure de dossiers. La s3-dg.pdf clé ne contient pas de préfixe séparé par des barres obliques. Son objet apparaît donc directement à la racine du bucket. 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 le AWS SDKs 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 SDKs.
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 sécurisés pour le Web, les analyseurs XML, etc. APIs
Caractères adaptés
Les caractères configurés suivants sont généralement adaptés à une utilisation dans les noms de clés :
| Caractères alphanumériques |
|
| Caractères spéciaux |
|
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
Si vous utilisez la console Amazon S3 pour télécharger des objets dont les noms de clé se terminent par des . points (), les points sont supprimés de la fin des noms de clé des objets téléchargés. Pour conserver les points à la fin des noms de clé dans les objets téléchargés, vous devez utiliser l'API REST AWS Command Line Interface (AWS CLI) ou Amazon S3. AWS SDKs
En outre, vous devez connaître les limitations suivantes en ce qui concerne les préfixes :
-
Les objets avec un préfixe de
./doivent être chargés ou téléchargés avec l'API AWS CLI, AWS SDKs, ou REST. Vous ne pouvez pas utiliser la console Amazon S3 pour télécharger ces objets. -
Les clés d'objet contenant des éléments de chemin relatifs (par exemple,
../) sont valides si, lors de l'analyse left-to-right, le nombre cumulé de segments de chemin relatifs ne dépasse jamais le nombre d'éléments de chemin non relatifs rencontrés. Cette règle s'applique à toutes les demandes effectuées à l'aide de la console Amazon S3, de l'API REST Amazon S3 et AWS SDKs. AWS CLIPar exemple :
videos/2014/../../video1.wmvest valide.videos/../../video1.wmvn'est pas valide.videos/../../2014/video1.wmvn'est pas valide.
Caractères pouvant exiger une manipulation spéciale
Les caractères suivants d'un nom de clé peuvent nécessiter une gestion de code supplémentaire et doivent très probablement être codés en URL ou référencés au format HEX. Certains de ces caractères sont des caractères non imprimables que votre navigateur risque de ne pas gérer et qui nécessitent également un traitement spécial :
-
Esperluette ()
& -
Signe du dollar (
$) -
Les caractères ASCII 00–1F hex (0–31 décimale) et 7F (127 décimale)
-
Symbole d'art (
@) -
Signe égal (
=) -
Point-virgule ()
; -
Barre oblique (
/) -
Colon (
:) -
Signe Plus (
+) -
Espace — Des séquences d'espaces importantes peuvent être perdues dans certains cas (en particulier plusieurs espaces)
-
Virgule ()
, -
Point d'interrogation (
?)
Caractères à éviter
Nous vous recommandons de ne pas utiliser les caractères suivants dans le nom d'une clé en raison de la gestion importante des caractères spéciaux, qui n'est pas uniforme dans toutes les applications :
-
Barre oblique inverse ()
\ -
Orthèse gauche ()
{ -
Caractères ASCII non imprimables (128–255 caractères décimaux)
-
Caret ou circonflexe ()
^ -
Orthèse droite ()
} -
Pourcentage de caractères (
%) -
Accent grave ou backtick ()
` -
Support droit (
]) -
Guillemet (
") -
Plus grand que le signe (
>) -
Support gauche (
[) -
Tilde ()
~ -
Moins que le signe (
<) -
Signe de la livre (
#) -
Barre ou tuyau vertical (
|)
Contraintes relatives aux clés d'objets liées au XML
Comme spécifié par la norme XML relative à la end-of-line manipulation
Voici une liste de ces caractères spéciaux et de leurs codes d'entité XML équivalents :
L'apostrophe (
') doit être remplacée par'Le guillemet (
") doit être remplacé par"L'esperluette (
&) doit être remplacée par&Le signe inférieur à (
<) doit être remplacé par<Le signe supérieur à (>
>) doit être remplacé par>Le retour du chariot (
\r) doit être remplacé par ou
Newline (
\n) doit être remplacé par ou 

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