Nesta página, descrevemos objetos, um recurso do Cloud Storage. Para uma visão geral do funcionamento do Cloud Storage, consulte a visão geral do produto do Cloud Storage.
Objetos
Objetos são os dados individuais que você armazena no Cloud Storage. Não há limite no número de objetos que você crie em um bucket.
Os objetos têm dois componentes: dados e metadados. Os dados de objeto geralmente são um arquivo que você quer armazenar no Cloud Storage e é completamente opaco no Cloud Storage. Metadados de objeto são uma coleção de pares de nome-valor que descrevem várias qualidades de objeto.
Duas partes importantes de metadados de objetos comuns a todos os objetos são o nome e o número de geração do objeto. Ao adicionar um objeto a um bucket do Cloud Storage, você especifica o nome do objeto, e o Cloud Storage atribui o número de geração. Juntos, o nome e a geração identificam exclusivamente o objeto nesse bucket.
Use listas de controle de acesso (ACLs) para controlar o acesso a objetos individuais. Também é possível usar o Identity and Access Management (IAM) para controlar o acesso a todos os objetos em um bucket ou em uma pasta gerenciada.
Considerações de nomenclatura
Ao nomear objetos no Cloud Storage, é essencial obedecer a requisitos específicos para garantir a compatibilidade e evitar erros. Esses requisitos se aplicam a buckets de namespace simples e buckets com namespace hierárquico ativado.
Requisitos gerais
- Os nomes de objetos podem conter qualquer sequência de caracteres Unicode válidos.
- Os nomes de objeto não podem conter caracteres retorno de carro ou nova linha.
- Observação: as barras invertidas enviadas por interfaces como a CLI gcloud e o console Google Cloud são escapadas nos bastidores. Por exemplo,
\ntorna-se\\n. A restrição de retorno de carro e avanço de linha se refere estritamente a caracteres de escape ANSI.
- Observação: as barras invertidas enviadas por interfaces como a CLI gcloud e o console Google Cloud são escapadas nos bastidores. Por exemplo,
- Os nomes de objeto não podem começar com
.well-known/acme-challenge/. - Objetos não podem ser nomeados como
.ou...
Limites de tamanho de objetos específicos do namespace
O tamanho máximo de um nome de objeto varia de acordo com o namespace do bucket:
- Tamanho do nome do objeto em um bucket de namespace simples: de 1 a 1.024 bytes quando codificado em UTF-8.
Tamanho do nome do objeto em buckets ativados com o namespace hierárquico: os nomes de objetos em buckets com namespace hierárquico ativado são divididos em duas partes: o segmento do nome da pasta e o segmento do nome base.
- Segmento de nome da pasta: o segmento do caminho de um objeto que define as pastas em que ele está. O tamanho máximo do segmento do nome da pasta é de 512 bytes quando codificado em UTF-8.
- Segmento de nome base: o segmento do caminho de um objeto que define o arquivo em si, separado de qualquer pasta mãe em que ele esteja. O tamanho máximo do segmento de nome base é de 512 bytes quando codificado em UTF-8.
Por exemplo, no caminho do objeto
my-folder-1/my-folder-2/my-object.txt, o segmento do nome da pasta émy-folder-1/my-folder-2/e o segmento do nome de base émy-object.txt.