Esta página descreve os contentores, um recurso no Cloud Storage. Para uma vista geral de como funciona o Cloud Storage, consulte a vista geral do produto Cloud Storage.
Contentores
Os contentores são os contentores básicos que armazenam os seus dados como objetos. Tudo o que armazena no Cloud Storage tem de estar contido num contentor. Pode usar contentores para organizar os seus dados e controlar o acesso aos mesmos, mas, ao contrário dos diretórios e das pastas, não pode aninhar contentores.
Não existe limite para o número de contentores que pode ter num projeto ou numa localização.
- No entanto, existem limites para a taxa com que pode criar ou eliminar contentores.
Quando cria um contentor, atribui-lhe um nome exclusivo a nível global e uma localização geográfica onde o contentor e o respetivo conteúdo são armazenados.
- Não pode alterar o nome de um contentor existente. Em alternativa, pode criar um novo contentor com o nome pretendido e mover o conteúdo do contentor antigo para o novo. Consulte o artigo Mova e mude o nome dos contentores para aceder a um guia passo a passo.
- A determinação de preços (como as cobranças pelo armazenamento de dados, pelo processamento de dados e pela transferência de dados de saída da rede) depende de fatores como a localização do contentor e as classes de armazenamento dos objetos no mesmo. Para mais detalhes, consulte os preços do Cloud Storage.
- Pode usar a gestão de identidade e de acesso (IAM) para controlar o acesso a contentores individuais.
Nomes dos contentores
Os nomes dos contentores têm de cumprir os seguintes requisitos:
- Os nomes dos contentores só podem conter letras minúsculas, carateres numéricos, travessões (
-
), sublinhados (_
) e pontos (.
). Não são permitidos espaços. Os nomes que contêm pontos requerem validação. - Os nomes dos contentores têm de começar e terminar com um número ou uma letra.
- Os nomes dos contentores têm de ter entre 3 e 63 carateres. Os nomes que contêm pontos podem ter até 222 carateres, mas cada componente separado por um ponto não pode ter mais de 63 carateres.
- Os nomes dos contentores não podem ser representados como um endereço IP na notação decimal com pontos (por exemplo, 192.168.5.4).
- Os nomes dos contentores não podem começar com o prefixo "goog".
- Os nomes dos contentores não podem conter "google" nem erros ortográficos semelhantes, como "g00gle".
Exemplos de nomes de contentores
Seguem-se exemplos de nomes de contentores válidos:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(Requer validação da propriedade paraexample.com
)
Seguem-se alguns exemplos de nomes de contentores inválidos:
My-Travel-Maps
(contém letras maiúsculas)my_google_bucket
(contém "google")test bucket
(contém um espaço)
Considerações sobre o nome do contentor
Os nomes dos contentores residem num único espaço de nomes partilhado por todos os utilizadores do Cloud Storage. Isto significa que:
O nome de cada contentor tem de ser globalmente exclusivo.
Se tentar criar um contentor com um nome que já pertence a um contentor existente, como
example-bucket
, o Cloud Storage responde com uma mensagem de erro.Os nomes dos contentores são visíveis publicamente.
Não use IDs de utilizadores, endereços de email, nomes de projetos, números de projetos nem informações de identificação pessoal (PII) nos nomes dos contentores, porque qualquer pessoa pode procurar a existência de um contentor.
Depois de eliminar um contentor, qualquer pessoa pode reutilizar o respetivo nome para um novo contentor.
Normalmente, o nome de um contentor eliminado fica disponível novamente em segundos. No entanto, tenha em atenção o seguinte:
Se eliminar o projeto que contém o contentor, o que elimina efetivamente o contentor, o nome do contentor pode não ser libertado durante semanas ou mais tempo.
Se alguém reutilizar o nome do seu contentor, não pode restaurar o contentor eliminado, mesmo que a eliminação reversível esteja ativada.
Se for criado um novo contentor com o mesmo nome numa localização diferente e no prazo de 10 minutos após a eliminação do contentor antigo, os pedidos feitos ao novo contentor durante este período de 10 minutos podem falhar com um erro
404-Bucket Not Found
.Se os seus pedidos passarem pela API XML, as tentativas de criar um contentor que reutilize um nome numa nova localização podem falhar com um erro
404-Bucket Not Found
até 10 minutos após a eliminação do contentor antigo.
Se alguém reutilizar o nome do seu contentor, pode receber inadvertidamente dados ou pedidos destinados ao seu contentor original eliminado. Para mitigar este risco, considere as seguintes práticas recomendadas:
Ao criar contentores, use uma convenção de nomenclatura forte que não seja fácil de adivinhar ou prever.
Quando eliminar contentores, certifique-se de que remove todas as referências ao nome do contentor eliminado, como documentação externa ou repositórios de código aberto.
Se já não precisar de um contentor, considere esvaziar todos os objetos do contentor e mantê-lo em vez de o eliminar.
Pode usar um nome de contentor num registo DNS como parte de um redirecionamento
CNAME
ouA
.Para tal, o nome do contentor deve estar em conformidade com as convenções de nomenclatura DNS padrão. Isto significa que o nome do contentor não deve usar sublinhados (
_
) nem ter um ponto junto a outro ponto ou traço. Por exemplo,..
,-.
e.-
são combinações de carateres inválidas em nomes DNS.
Aceda aos dados em contentores através de pastas ou diretórios
Embora o Cloud Storage armazene dados não estruturados sob a forma de objetos, algumas funcionalidades permitem-lhe aceder e gerir os seus dados através de pastas ou diretórios.
Espaço de nomes hierárquico
Quando cria contentores, pode ativar opcionalmente o espaço de nomes hierárquico para o contentor, o que lhe permite usar pastas para armazenar os seus objetos de uma forma de sistema de ficheiros. A organização dos objetos em pastas facilita a execução de operações em grandes escalas de dados, o que melhora o desempenho, a consistência e a facilidade de gestão. A utilização de contentores com o espaço de nomes hierárquico ativado é especialmente vantajosa quando trabalha com cargas de trabalho orientadas para ficheiros e com grande volume de dados.
Para começar a usar o espaço de nomes hierárquico, consulte o artigo Crie contentores com o espaço de nomes hierárquico ativado.
Cloud Storage FUSE
O Cloud Storage FUSE é um adaptador FUSE que lhe permite montar e aceder a contentores como sistemas de ficheiros locais, para que as aplicações possam ler e escrever objetos no seu contentor usando a semântica padrão do sistema de ficheiros. O Cloud Storage FUSE permite-lhe armazenar os seus dados no Cloud Storage com todas as vantagens do serviço, mantendo a capacidade de aceder a esses dados através do código da sua aplicação sem precisar de fazer alterações.
Para saber como usar o Cloud Storage FUSE, consulte o início rápido do Cloud Storage FUSE.
O que se segue?
- Crie contentores do Cloud Storage.
- Mude o nome de um grupo existente.
- Saiba mais sobre os metadados associados a um contentor.
- Carregue um objeto.