Metadados do bucket

Acessar exemplos

Nesta página, você encontrará informações sobre os campos de metadados que são armazenados junto com buckets no Cloud Storage.

Introdução

Os buckets criados no Cloud Storage têm metadados associados a eles. Os metadados identificam propriedades do bucket e especificam como ele será processado quando for acessado.

Alguns metadados existem como pares key: value. Por exemplo, o nome de um bucket é representado pela entrada de metadados name: my-bucket-name para a API JSON. A API XML apresenta esses metadados como <elements></elements>, como <LocationConstraint>US</LocationConstraint> para o local do bucket.

Outros metadados podem ter uma matriz de dados associados à chave. Por exemplo, os metadados do gerenciamento do ciclo de vida podem conter um conjunto de regras que se aplicam a objetos atuais e futuros em um bucket.

A mutabilidade dos metadados varia:

  • Alguns só podem ser visualizados.

  • Alguns deles só podem ser definidos quando o bucket for criado pela primeira vez e não podem ser editados ou removidos.

  • Algumas pessoas podem adicionar e editar, mas não remover.

  • Algumas podem ser adicionadas, editadas e removidas a qualquer momento.

Metadados não editáveis

Os metadados a seguir são definidos durante a criação do bucket e não podem ser editados ou removidos:

  • Nome do bucket

  • Local do bucket

  • O projeto a qual o bucket faz parte.

  • Número de metageneration

    • O número de metageneration de um bucket identifica exclusivamente o estado de metadados do bucket. O número de metageneration é 1 no momento da criação do bucket e aumenta sempre que você modifica os metadados do bucket.

Metadados editáveis

Os metadados de bucket editáveis são metadados com valores que geralmente podem ser modificados a qualquer momento. Em alguns casos, como o bucket sujeito a uma restrição da política da organização, há restrições de modificação de determinados valores de metadados.

Visão geral de metadados Link para o guia Observações
Access Control Lists (ACLs) Como criar e gerenciar ACLs Recomendado apenas para usuários XML.
ACLs padrão Como definir ACLs padrão de objetos
Políticas de gerenciamento de identidade e acesso (IAM, na sigla em inglês)1 Como utilizar permissões do IAM
Faturamento (pagamentos do solicitante) Como usar pagamentos do solicitante
Configuração de compartilhamento de recursos entre origens (CORS, na sigla em inglês) Como configurar o CORS
Classe de armazenamento padrão Como alterar a classe de armazenamento padrão Definida durante a criação do bucket e pode ser editada, mas não removida.
Chave de criptografia padrão do Cloud KMS Como usar chaves padrão do Cloud KMS
Retenções baseadas em eventos padrão1 Como trabalhar com a propriedade de retenção baseada em evento padrão
Acesso uniforme no nível do bucket1 Como usar o acesso uniforme no nível do bucket Editável nos primeiros 90 dias após a ativação do acesso uniforme no nível do bucket.
Política de configuração do ciclo de vida Como gerenciar ciclos de vida de objetos
Registros de uso e registros de armazenamento Configuração dos registros de uso
Política de retenção2 Como usar e bloquear políticas de retenção Só é possível editar se a política de retenção não estiver bloqueada.
Configuração do controle de versão de objetos Como usar o controle de versão de objeto
Rótulos de intervalos Como usar rótulos em intervalos
Configuração do site Como atribuir páginas especiais para sites estáticos

1 Estes metadados não podem ser visualizados ou gerenciados usando a API XML.

2 É possível usar a API XML para definir esses metadados durante a criação do bucket, mas não é possível ver ou gerenciar esses metadados.

Rótulos de intervalos

Os rótulos do bucket permitem criar pares de chave-valor arbitrários que são armazenados como parte dos metadados do bucket. É possível usar rótulos para organizar os buckets com outros recursos do Google Cloud, como instâncias de máquina virtual e discos permanentes. Por exemplo, digamos que você queira uma chave chamada team que tenha os valores alpha, beta e delta, que será usada para indicar a qual equipe está associada. determinados recursos do Google Cloud. É possível aplicar os rótulos team:alpha, team:beta e team:delta aos recursos desejados para fazer isso.

Ao trabalhar com rótulos de bucket, tenha em mente que:

  • Chaves e valores não podem ter mais de 63 caracteres.
  • Chaves e valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e travessões. Caracteres internacionais são permitidos.
  • As chaves dos rótulos precisam começar com uma letra minúscula. É permitido usar caracteres internacionais.
  • As chaves do rótulo não podem estar vazias.
  • Cada bucket pode ter no máximo 64 rótulos ativamente aplicados a ele.
  • Como geralmente acontece com metadados de bucket, os rótulos do bucket não são associados a objetos individuais ou metadados de objetos.

Para um exemplo geral de uso de rótulos para organizar seus recursos no faturamento, consulte Exemplos de consulta de exportação de faturamento para o BigQuery.

A seguir