Metadados do bucket

Acessar metadados

Acessar tamanho do bucket

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

Introdução

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

Os metadados são armazenados como pares de key: value, em que value pode assumir várias formas, incluindo strings, matrizes ou até mesmo pares de key:value aninhados. Por exemplo, o nome do bucket é uma string, enquanto uma configuração do Gerenciamento do ciclo de vida de objetos do bucket é uma matriz de regras em que cada regra contém vários pares de key: value filhos.

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 geração

    • O número de geração de um bucket identifica exclusivamente a versão do bucket, mesmo que mais de uma versão de um bucket compartilhe o mesmo nome.

    • O valor de geração de um bucket nunca muda.

    • Não há garantia de que os números de geração aumentem para versões sucessivas, apenas que cada nova versão tem um número de geração exclusivo.

    • Não há relação entre os números de geração de buckets não relacionados.

  • 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) Criar e gerenciar ACLs Recomendado apenas para usuários XML.
ACLs padrão Definir ACLs padrão de objetos
Políticas de gerenciamento de identidade e acesso (IAM, na sigla em inglês)1 Usar permissões do IAM
Faturamento (pagamentos do solicitante) Usar pagamentos do solicitante
Configuração de compartilhamento de recursos entre origens (CORS, na sigla em inglês) Definir e consultar as configurações do CORS
Classe de armazenamento padrão 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 Usar chaves padrão do Cloud KMS
Retenções baseadas em eventos padrão1 Trabalhar com a propriedade de retenção baseada em evento padrão
Prevenção de acesso público1 Usar a prevenção do acesso público
Acesso uniforme no nível do bucket1 Usar o acesso uniforme no 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 Gerenciar os ciclos de vida dos objetos
Classe automática Usar a classe automática
Replicação turbo1 Gerenciar a replicação turbo
Registros de uso e registros de armazenamento Configuração dos registros de uso
Bloqueio de buckets2 Usar e bloquear políticas de retenção Só é possível editar se a política de retenção não estiver bloqueada.
Bloqueio de retenção de objetos Ativar e usar configurações de retenção de objetos Depois de ativado para um bucket, não pode ser desativado.
Configuração do controle de versão de objetos Usar o Controle de versões de objetos
Rótulos de intervalos Usar identificadores de buckets
Duração da retenção da exclusão reversível Usar a exclusão reversível
Configuração do site 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.

A seguir