Lineamientos para asignación de nombres de depósitos y de objetos

En esta página, se describen los lineamientos para asignar nombres que debes seguir cuando crees depósitos y subas objetos en Cloud Storage. A fin de obtener más información sobre cómo crear un depósito, consulta la Guía para crear depósitos de almacenamiento.

Requisitos para los nombres de depósitos

Los nombres de tu depósito deben cumplir los siguientes requisitos:

  • Los nombres de depósitos solo deben contener letras en minúscula, números, guiones (-), guiones bajos (_) y puntos (.). Los nombres que contengan puntos requieren verificación.
  • Deben comenzar y terminar con un número o una letra.
  • Pueden contener entre 3 y 63 caracteres. Los nombres que contienen puntos pueden contener hasta 222 caracteres, pero cada componente separado por puntos no puede tener más de 63 caracteres.
  • No se pueden representar como una dirección IP en notación decimal con puntos (por ejemplo, 192.168.5.4).
  • No pueden comenzar con el prefijo "goog".
  • No pueden contener “google” o errores ortográficos, como “g00gle”.

Además, para garantizar el cumplimiento de DNS y la compatibilidad futura, no debes usar guiones bajos (_) ni tener un punto al lado de otro punto o guion. Por ejemplo, “..”, “-.” o “.-” no son válidos en los nombres de DNS.

Consideraciones de los nombres de depósitos

Los nombres de los depósitos se encuentran en un solo espacio de nombres de Cloud Storage. Esto significa lo siguiente:

  • Cada nombre de depósito debe ser único.
  • Los nombres de depósitos son visibles de forma pública.

Si intentas crear un depósito con un nombre que ya pertenece a un depósito existente, Cloud Storage responde con un mensaje de error. Sin embargo, una vez que borres un depósito, tú o cualquier otro usuario pueden volver a usar ese nombre para un depósito nuevo.

Solo se puede asignar un nombre durante la creación de un depósito; no puedes cambiar el nombre de un depósito existente. En su lugar, debes crear un depósito nuevo con el nombre que desees y trasladar el contenido del depósito anterior al nuevo. Consulta Mueve y cambia el nombre de los depósitos para ver una guía paso a paso.

También consulta la sección Recomendaciones para asignar nombres, en la que se incluyen recomendaciones sobre cómo excluir información de propiedad de los nombres de depósitos y objetos.

Requisitos para los nombres de objetos

Los nombres de tus objetos 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 provocarán problemas con las listas de XML cuando intentes hacer una lista de tus objetos.
  • Evita el uso de “#” en los nombres de tus objetos. Con gsutil, los nombres de objetos que terminan con #<numeric string> se interpretan 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 la página sobre control de versiones de objetos y control de simultaneidad).
  • Evita el uso de “[”, “]”, “*” o “?” en los nombres de tus 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 .

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 la sección sobre cómo cambiar 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 Platform Console, que controlan de forma automática el proceso de cambio de nombre.

Próximos pasos

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.