Consignes de dénomination des objets

Cette page présente les consignes de dénomination à suivre lors de l'importation d'objets dans Cloud Storage. Pour découvrir comment importer un objet, consultez le guide d'importation d'objets.

Exigences relatives aux noms d'objet

Les noms de vos objets doivent satisfaire les critères suivants :

  • Les noms d’objet peuvent contenir n'importe quelle séquence de caractères Unicode valides, d'une longueur comprise entre 1 et 1 024 octets pour l'encodage en UTF-8.
  • Les noms d'objet ne peuvent pas contenir de caractères de retour chariot ni de saut de ligne.
  • Les noms d'objets ne peuvent pas commencer par .well-known/acme-challenge.
  • Les objets ne peuvent pas être nommés . ou ...

Pour en savoir plus sur les caractères de retour chariot et de saut de ligne, consultez la section Retour à la ligne.

Il est vivement recommandé d'éviter d'intégrer les éléments suivants dans les noms d'objet :

  • Les caractères de contrôle illégaux dans XML 1.0 (#x7F–#x84 et #x86–#x9F) : ces caractères entraînent des problèmes de liste XML lorsque vous tentez de répertorier vos objets.
  • Le symbole "#" : gsutil interprète les noms d'objet se terminant par "#<chaîne numérique>" comme des identifiants de version. Par conséquent, l'inclusion du symbole "#" dans les noms d'objet peut rendre difficile, voire impossible, l'exécution d'opérations à l'aide de gsutil sur de tels objets ayant des versions gérées (consultez la section Gestion des versions des objets et contrôle de simultanéité).
  • Les caractères "[", "]", "*" ou "?" : gsutil les interprète comme des caractères génériques. Par conséquent, leur inclusion dans les noms d'objet peut rendre difficile, voire impossible, l'exécution d'opérations génériques à l'aide de gsutil.

Remarques relatives aux noms d'objet

Les noms d'objet se trouvent dans un espace de noms unique au sein d'un bucket. Cela signifie que :

  • Différents buckets peuvent comporter des objets portant le même nom.
  • Les objets ne se trouvent pas dans des sous-répertoires d'un bucket.

Par exemple, vous pouvez nommer un objet /europe/france/paris.jpg pour donner l'impression que paris.jpg se trouve dans le sous-répertoire /europe/france, mais dans Cloud Storage, l'objet se trouve simplement dans le bucket et porte le nom /europe/france/paris.jpg.

Comme pour les buckets, il n'est pas possible de renommer les objets existants. Au lieu de cela, vous pouvez copier un objet, donner à la version copiée le nom souhaité et supprimer la version d'origine de l'objet. Pour en savoir plus, consultez la section Renommer un objet : il s'agit d'un guide par étapes présentant des instructions relatives à des outils tels que gsutil et Google Cloud Console, qui peuvent gérer le processus de renommage de manière automatisée.

Consultez également la section Bonnes pratiques de dénomination, qui inclut des recommandations sur l'exclusion des informations propriétaires des noms d'objet.

Étapes suivantes