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.
  • Evita el uso de “#” en los nombres de los objetos. gsutil interpreta los nombres de objetos que terminan con #<numeric string> como identificadores de versiones, por lo que incluir “#” en los nombres de objetos puede dificultar o imposibilitar la realización de operaciones en los objetos con versión mediante gsutil (consulta Control de versiones de objetos y control de simultaneidad).
  • Evita el uso de “[”, “]”, “*” o “?” en los nombres de los objetos. gsutil interpreta estos caracteres como comodines, por lo que incluirlos en los nombres de los objetos puede dificultar o imposibilitar las operaciones de comodines con gsutil.

Consideraciones de los nombres de objetos

Los nombres de objetos se encuentran en un espacio de nombres plano dentro de un depósito. 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 depósito.

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 depósito 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. En su lugar, puedes copiar un objeto, asignar a la versión copiada el nombre que desees y borrar la versión original del objeto. Consulta Cambia el nombre de un objeto a fin de obtener una guía paso a paso, que incluye instrucciones para herramientas como gsutil y Google Cloud Console, que controla el proceso de cambio de nombre de forma automática.

También consulta la sección Prácticas recomendadas para asignar nombres, en la que se incluyen recomendaciones sobre cómo excluir información de propiedad de los nombres de objetos.

Próximos pasos