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 los depósitos deben contener solo letras minúsculas, números, guiones (-), guiones bajos (_) y puntos (.). Los nombres que contienen puntos se deben verificar.
  • 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 residen en un espacio de nombres único de Cloud Storage, lo que significa que cada nombre de depósito debe ser exclusivo. Si intentas crear un depósito con un nombre que ya está asignado a un depósito existente, Cloud Storage responde con un mensaje de error. Sin embargo, una vez que borras un depósito, otro usuario o tú pueden volver a usar su nombre cuando creen un depósito nuevo.

Solo se puede asignar un nombre de depósito durante su creación. 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 Traslada y renombra 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 desde los nombres de depósitos y 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 objetos no pueden comenzar con .well-known/acme-challenge.
  • Los objetos no se pueden nombrar . 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 Control de versiones de objetos y control de simultaneidad).
  • Evita el uso de "[", "]", "*", o "?" en los nombres de tus objetos. Con gsutil, estos caracteres se interpretan como comodines, por lo que incluirlos en los nombres de objetos pueden dificultar o imposibilitar la realización de operaciones de comodines con gsutil.

Consideraciones de los nombres de objeto

Los nombres de objetos residen en un espacio de nombres fijo dentro de un depósito, lo que significa que depósitos diferentes pueden tener objetos con el mismo nombre. También significa que los objetos no residen dentro de los subdirectorios en un depósito. Por ejemplo, puedes nombrar /europe/france/paris.jpg a un objeto para que parezca que paris.jpg reside en el subdirectorio /europe/france, pero en el caso de Cloud Storage, el objeto simplemente existe en el depósito y tiene el nombre /europe/france/paris.jpg.

Como en el caso de los depósitos, los objetos existentes no se pueden renombrar. En su lugar, puedes lograr renombrar de manera eficaz si copias un objeto, otorgas el nombre deseado al objeto nuevo y borras el objeto anterior. Esto se puede realizar con facilidad mediante el comando gsutil mv con el que se administra el proceso de forma automática. En el caso de los archivos (pero no las carpetas), renombrar también se puede lograr mediante Google Cloud Platform Console si haces clic en el menú desplegable del archivo deseado (que aparece en forma de tres puntos verticales en el extremo derecho de la línea del archivo) y si haces clic en mover/renombrar. Cuando uses Google Cloud Storage mediante las API de JSON y XML, debes renombrar los objetos de manera explícita. Para ello, copia y borra el objeto.

¿Qué sigue?

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

Enviar comentarios sobre...

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