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:

  • Conter apenas letras minúsculas, números, traços (-), sublinhados (_) e pontos (.). Não é permitido usar espaços. Ser verificados caso incluam pontos.
  • Começar e terminar com um número ou uma letra.
  • Ter de 3 a 63 caracteres. Ter até 222 caracteres caso incluam pontos, 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".
  • Não podem conter a palavra "google" ou aproximações dela, como "g00gle".

Além disso, para fins de conformidade com o DNS e compatibilidade futura, não use sublinhados (_) ou um ponto ao lado de 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. Isso significa que:

  • cada nome de intervalo precisa ser exclusivo;
  • os nomes de intervalo são visíveis publicamente.

Se você tentar criar um intervalo com um nome que já pertence a outro, o Cloud Storage responderá com uma mensagem de erro. No entanto, depois de excluir um intervalo, você ou outro usuário poderá reutilizar o nome dele para 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 reservados 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 ter como nome . ou ...

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

É altamente recomendável que você siga as orientações abaixo ao nomear seus objetos:

  • Evite usar caracteres de controle (em inglês) inválidos em XML 1.0 (#x7F–#x84 e #x86–#x9F). Esses caracteres causam problemas ao tentar listar objetos em XML.
  • Evite usar "#" em nomes de objetos. A gsutil interpreta os nomes de objetos terminados em #<string numérica> como identificadores de versão. Portanto, incluir esse caractere pode dificultar ou impossibilitar a realização de operações em tais objetos com controle de versões usando a gsutil (consulte Controle de versões de objetos e de simultaneidade).
  • Evite usar "[", "]", "*" ou "?" em nomes de objetos. A gsutil interpreta esses caracteres como curingas. Portanto, incluí-los pode dificultar ou impossibilitar a realização de operações com caracteres curinga usando a gsutil.

Considerações sobre nomes de objetos

Os nomes de objeto residem em um namespace simples em um intervalo. Isso significa que:

  • intervalos diferentes podem ter objetos com o mesmo nome;
  • os objetos não residem nos subdiretórios de um intervalo.

Por exemplo, é possível nomear um objeto como /europe/france/paris.jpg para aparentar que paris.jpg reside no subdiretório /europe/france. No entanto, para o Cloud Storage, o objeto simplesmente está no intervalo e tem o nome .

Assim como os intervalos, os objetos existentes não podem ser renomeados diretamente. Em vez disso, copie um objeto, dê o nome que você quer à versão copiada e exclua a versão original. Consulte Como renomear um objeto para ver um guia passo a passo, incluindo instruções de como usar ferramentas como a gsutil e o Console do Google Cloud, que realizam o processo de renomeação automaticamente.

A seguir