Lineamientos para asignar nombres de objetos

En esta página, se describen los lineamientos para asignar nombres que debes seguir cuando subes objetos en Cloud Storage. Si quieres obtener información sobre cómo subir un objeto, consulta la Guía para subir objetos.

Requisitos para los nombres de objetos

Los nombres de tu objeto deben cumplir los siguientes requisitos:

  • Los nombres de objetos pueden contener cualquier secuencia de caracteres Unicode válidos con una longitud de 1-1024 bytes cuando se codifican en UTF-8.
  • Los nombres de objetos no pueden contener caracteres de retorno de carro o salto de línea.
  • Los nombres de los objetos no pueden comenzar con .well-known/acme-challenge/.
  • Los objetos no se pueden llamar . ni ...

Para obtener más información sobre los caracteres de retorno de carro o salto de línea, consulta Saltos de línea.

Recomendamos que evites lo siguiente en los nombres de tus objetos:

  • Evita el uso de caracteres de control que sean ilegales en XML 1.0 (#x7F–#x84 y #x86–#x9F). Estos caracteres provocan problemas con las listas de XML cuando intentas hacer una lista de tus objetos.
  • El carácter “#”: gsutil interpreta los nombres de los objetos que terminan en #<string numérica> como identificadores de versión, por lo que incluir “#” en los nombres de objetos puede dificultar o imposibilitar el rendimiento operaciones en esos objetos con versiones mediante gsutil.
  • Los caracteres “[”, “]”, “*” o “?”: gsutil los interpreta como comodines, por lo que incluirlos en los nombres de los objetos puede dificultar o imposibilitar las operaciones de comodines con gsutil.
  • Información sensible o de identificación personal (PII): los nombres de los objetos son más visibles que los datos del objeto. Por ejemplo, los nombres de objetos aparecen en las URL de los objetos y cuando se enumeran objetos en un bucket.

Consideraciones de los nombres de objeto

Los nombres de objetos se encuentran en un espacio de nombres plano dentro de un bucket. Esto significa lo siguiente:

  • Depósitos diferentes pueden tener objetos con el mismo nombre.
  • Los objetos no se encuentran dentro de los subdirectorios de un bucket.

Por ejemplo, puedes nombrar un objeto /europe/france/paris.jpg para que parezca que paris.jpg reside en el subdirectorio /europe/france, pero Cloud Storage considera que el objeto solo existe en el bucket y tiene el nombre /europe/france/paris.jpg. Como resultado, mientras que las estructuras similares a directorios y anidadas con el uso de delimitadores de barra se permiten dentro de Cloud Storage, estas no tienen el mismo rendimiento de un sistema de archivos nativo cuando se enumeran subdirectorios profundamente anidados.

Como en el caso de los depósitos, no se puede cambiar el nombre de los objetos existentes de forma directa, pero puedes cambiar el nombre de un objeto de forma indirecta si copias y borras el objeto original.

Consulta las Prácticas recomendadas sobre tasas de solicitudes para obtener recomendaciones sobre cómo optimizar el rendimiento mediante la prevención de nombres secuenciales durante las cargas a gran escala. Es probable que los objetos subidos con nombres secuenciales alcancen el mismo servidor de backend y limiten el rendimiento.

¿Qué sigue?