Diretrizes para nomeação de intervalos e objetos

Nesta página, descreveremos as diretrizes de nomenclatura que você seguirá ao criar intervalos e fazer o upload de objetos no Cloud Storage. Para saber como criar um intervalo, consulte o guia Como criar intervalos de armazenamento.

Requisitos para nome de intervalo

Os nomes dos seus intervalos precisam atender aos requisitos a seguir:

  • Nomes de intervalo precisam conter apenas letras minúsculas, números, traços (-), sublinhados (_) e pontos (.). Os nomes com pontos precisam de verificação.
  • Nomes de intervalo precisam começar e terminar com uma letra ou um número.
  • Nomes de intervalo precisam conter de 3 a 63 caracteres. Os nomes com pontos podem ter até 222 caracteres, mas cada componente separado por ponto não pode ter mais do que 63 caracteres.
  • Nomes de intervalo não podem ser representados como um endereço IP na notação decimal com pontos (por exemplo, 192.168.5.4).
  • Nomes de intervalo não podem começar com o prefixo "goog".
  • Nomes de intervalo não podem conter ou se assemelhar a "google", como em "g00gle".

Além disso, para fins de conformidade e compatibilidade futura de DNS, você não deve usar sublinhados (_) ou ter um ponto adjacente a outro ponto ou traço. Por exemplo, "..", "-." ou ".-" não são nomes DNS válidos.

Considerações sobre nomes de intervalo

Os nomes de intervalo residem em um único namespace do Cloud Storage, o que significa que todo nome de intervalo precisa ser exclusivo. Se você tentar criar um intervalo com um nome que já esteja atribuído a um intervalo existente, o Cloud Storage responderá com uma mensagem de erro. No entanto, depois de excluir um intervalo, o nome dele pode ser reutilizado por você ou por outro usuário ao criar um novo intervalo.

Um nome de intervalo só pode ser atribuído durante a criação: não é possível alterar o nome de um intervalo existente. Em vez disso, crie um novo intervalo com o nome desejado e mova o conteúdo do antigo para o novo. Consulte Como mover e renomear intervalos para um guia passo a passo.

Consulte também a seção Práticas recomendadas de nomenclatura, que inclui recomendações sobre a exclusão de informações registradas dos nomes de intervalos e objetos.

Requisitos para nome de objeto

Seus nomes de objeto precisam atender aos requisitos a seguir:

  • Os nomes de objeto podem conter qualquer sequência de caracteres Unicode válidos, com o tamanho de 1 a 1024 bytes quando codificados com UTF-8.
  • Os nomes de objeto não podem conter caracteres retorno de carro ou nova linha.
  • Os nomes de objeto não podem começar com. .well-known/acme-challenge.
  • Objetos não podem ser nomeados como . ou ...

Para mais informações sobre caracteres de retorno de carro e nova linha, consulte Nova linha.

É altamente recomendável que você evite isto nos seus nomes de objeto:

  • Evite usar caracteres de controle que sejam ilegais no XML 1.0 (# x7F– # x84 e # x86– # x9F): esses caracteres causarão problemas de listagem de XML quando você tentar listar seus objetos.
  • Evite usar "#" nos seus nomes de objetos: o gsutil interpreta nomes de objetos terminados com # <string numérica> como identificadores de versão, portanto, incluir "#" em nomes de objetos pode dificultar ou impossibilitar a execução de operações em tais objetos que usam o gsutil (consulte Controle de versão de objeto e controle de simultaneidade).
  • Evite usar "[", "]", "*", ou "?"nos nomes dos objetos: o gsutil interpreta esses caracteres como curingas, portanto, incluí-los em nomes de objetos pode dificultar ou impossibilitar a realização de operações com curinga usando o gsutil.

Considerações sobre nomes de objeto

Os nomes de objeto residem em um namespace simples em um intervalo, o que significa que diferentes intervalos podem ter objetos com o mesmo nome. Isso também significa que os objetos não residem em subdiretórios em um intervalo. Por exemplo, é possível nomear um objeto /europe/france/paris.jpg para fazer parecer que paris.jpg reside no subdiretório /europe/france, mas, no Cloud Storage, o objeto realmente existe no intervalo e tem o nome /europe/france/paris.jpg.

Assim como os intervalos, os objetos existentes não podem ser renomeados. Em vez disso, a renomeação é efetivada copiando um objeto, dando o nome que você quer a ele e excluindo o antigo. Isso pode ser feito facilmente com o comando gsutil mv, que manipula o processo automaticamente. Para arquivos (mas não pastas), a renomeação também pode ser feita facilmente por meio do Console do Google Cloud Platform, clicando no menu suspenso do arquivo que você quer e clicando em mover/renomear. Esse menu aparece como três pontos verticais no canto direito da linha do arquivo. Ao usar o Google Cloud Storage por meio das APIs JSON e XML, as renomeações de objeto precisam ser feitas explicitamente copiando e excluindo o objeto.

Próximas etapas

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.