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 (.). Nomes com pontos precisam ser verificados.
  • Nomes de intervalo precisam começar e terminar com um número ou letra.
  • 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 a palavra "google" ou aproximações dela, como "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. 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 um intervalo existente, 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 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: a gsutil interpreta esses caracteres como curingas. Portanto, inclui-los em nomes de objetos pode dificultar ou impossibilitar a realização de operações curinga usando a gsutil.

Considerações sobre nomes de objeto

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 fazer parecer que paris.jpg reside no subdiretório /europe/france. No entanto, para o Cloud Storage, o objeto simplesmente existe no intervalo e tem o nome .

Assim como os intervalos, os objetos existentes não podem ser renomeados diretamente. Em vez disso, é possível copiar um objeto, dar o nome desejado à versão copiada e excluir a versão original do objeto. Consulte Como renomear um objeto para exibir um guia passo a passo, que inclui instruções sobre ferramentas como a gsutil e o Console do Google Cloud Platform, que processam o processo de renomeação automaticamente.

A seguir

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

Enviar comentários sobre…

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