Metadados do bucket

Os metadados de um bucket do Cloud Storage identificam as propriedades dele e permitem controlar o comportamento do bucket. Os metadados de um bucket incluem campos não editáveis, como o nome do bucket e o número do projeto, além de configurações ajustáveis, como a classe de armazenamento padrão, as regras de ciclo de vida e os papéis do IAM.

Visão geral dos metadados de buckets

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 metadados são somente leitura.

  • Alguns metadados podem ser definidos quando o bucket é criado, mas não podem ser editados ou removidos.

  • Alguns metadados podem ser adicionados e editados, mas não removidos.

  • Alguns metadados podem ser adicionados, editados e removidos 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

  • 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 tenha 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.

  • Se o namespace hierárquico está ativado para o 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.
Criptografia de dados Configurar quais métodos de criptografia são permitidos ou restritos A atualização dessa configuração não afeta o tipo de criptografia dos objetos que já estão no bucket.
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
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 ativada para um bucket, não pode ser desativada.
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
Local do bucket Realocar buckets Antes de realocar um bucket, consulte a página Visão geral da realocação de bucket.

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