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:

Metadados editáveis

É possível alterar duas categorias de metadados nos buckets:

Metadados de chave fixa

Os metadados de chave fixa são aqueles com chaves definidas, mas permitem a especificação de um valor.

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 do KMS padrão 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
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.

Metadados de chave personalizada

Os Metadados de chave personalizada são aqueles que são adicionados com a especificação de uma chave e um valor associado a ela. Para buckets, os metadados de chave personalizada são conhecidos como rótulos, que são usados para organizar seus buckets.

A seguir