Noms clés des compartiments de stockage d'objets Lightsail - Amazon Lightsail

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.

Noms clés des compartiments de stockage d'objets Lightsail

Les fichiers que vous chargez dans votre compartiment sont stockés sous forme d'objets dans le service de stockage d'objets Amazon Lightsail. Une clé d'objet (ou nom de clé) identifie de façon unique un objet dans un compartiment. Ce guide explique le concept des noms de clés et des préfixes de noms de clés qui constituent la structure de dossiers des buckets affichés via la console Lightsail. Pour plus d'informations sur les compartiments, veuillez consulter Stockage d'objets.

Noms de clés

Le modèle de données du service de stockage d'objets Lightsail utilise une structure plate au lieu d'une structure hiérarchique comme dans un système de fichiers. Il n'existe aucune hiérarchie de dossiers et de sous-dossiers. Toutefois, vous pouvez déduire une hiérarchie logique grâce aux préfixes et délimiteurs de nom de clé. La console Lightsail utilise les préfixes des noms clés pour afficher vos objets dans une structure de dossiers.

Imaginons que votre compartiment comporte quatre objets avec les clés d'objet suivantes :

  • Development/Projects.xls

  • Finance/statement1.pdf

  • Private/taxdocument.pdf

  • to-dos.doc

La console Lightsail utilise les préfixes des noms clés Development/ (Finance/,, Private/ et) et le délimiteur / () pour présenter une structure de dossiers. Le nom de clé to-dos.doc ne possède pas de préfixe, son objet apparaît donc directement à la racine de votre compartiment. Si vous accédez au Development/ dossier dans la console Lightsail, l'objet s'affiche. Projects.xls Dans le dossier Finance/, vous voyez l'objet statement1.pdf, et dans le dossier Private/, vous voyez l'objet taxdocument.pdf.

La console Lightsail permet de créer un dossier en créant un objet de zéro octet avec le préfixe du nom de clé et la valeur du délimiteur comme nom de clé. Ces objets de dossier n'apparaissent pas dans la console. Cependant, ils se comportent comme tous les autres objets. Vous pouvez les visualiser et les manipuler à l'aide d'Amazon S3API, AWS Command Line Interface (AWS CLI) ou AWS SDKs.

Directives de dénomination de la clé d'objet

Vous pouvez utiliser n'importe quel caractère UTF -8 dans le nom d'une clé d'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é aux caractères sécurisés sur le WebDNS, aux XML analyseurs syntaxiques, 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

    • 0-9

    • a-z

    • A-Z

  • Caractères spéciaux

    • Barre oblique (/)

    • Point d'exclamation (!)

    • Trait d'union (-)

    • Trait de soulignement (_)

    • Point (.)

    • Astérisque (*)

    • Guillemet simple (')

    • Parenthèse ouvrante (()

    • Parenthèse fermante ())

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

Important

Si le nom d'une clé d'objet se termine par un seul point (.) ou deux points (..), vous ne pouvez pas télécharger l'objet à l'aide de la console Lightsail. Pour télécharger un objet dont le nom de clé se termine par un ou deux points, vous devez utiliser Amazon S3 API AWS CLI, et AWS SDKs. Pour plus d'informations, veuillez consulter Téléchargement d'objets depuis un compartiment.

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 probablement être URL codés ou référencés en tant queHEX. 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 (« $ »)

  • ASCIIplages de caractères 00—1F hexadécimal (0—31 décimal) et 7F (127 décimales)

  • Arobase (« @ »)

  • Égal (« = »)

  • Point-virgule (« ; »)

  • 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 non imprimables (128 à 255 ASCII caractères décimaux)

  • Lambda (« ^ »)

  • Accolade droite (« } »)

  • Pourcentage (« % »)

  • Accent grave/guillemet inversé (« ` »)

  • Crochet droit (« ] »)

  • Guillemets

  • Supérieur à (« > »)

  • Crochet gauche (« [ »)

  • Tilde (« ~ »)

  • Inférieur à (« < »)

  • Dièse (« # »)

  • Barre verticale/pipe (« | »)

XMLcontraintes clés relatives aux objets associés

Comme spécifié par la XMLnorme sur la end-of-line manutention, tout le XML texte est normalisé de telle sorte que les retours d'un seul chariot (ASCIIcode 13) et les retours de chariot immédiatement suivis d'un fil (ASCIIcode 10) sont remplacés par un caractère d'alimentation d'une seule ligne. Pour garantir l'analyse correcte des clés d'objet dans les XML demandes, les retours de transport et les autres caractères spéciaux doivent être remplacés par leur code d'XMLentité équivalent lorsqu'ils sont insérés dans les XML balises. Voici la liste de ces caractères spéciaux et de leurs codes d'entité équivalents :

  • ' comme &apos;

  • comme &quot;

  • & comme &amp;

  • < comme &lt;

  • < comme &gt;

  • \r comme &#13; ou &#x0D;

  • \n comme &#10; ou &#x0A;

L'exemple suivant illustre l'utilisation d'un code d'XMLentité en remplacement d'un retour de transport. Cette requête DeleteObjects supprime un objet avec le paramètre de clé /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&#13;carriagereturn</Key> </Object> </Delete>