Metadados do contentor

Obtenha metadados

Get bucket size

Esta página aborda os campos de metadados que são armazenados juntamente com os contentores no Cloud Storage.

Introdução

Os contentores do Cloud Storage têm metadados associados. Os metadados identificam as propriedades do contentor e especificam como o contentor deve ser processado quando é acedido.

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

A capacidade de alteração dos metadados varia:

  • Alguns só podem ser vistos.

  • Algumas só podem ser definidas quando o depósito é criado pela primeira vez e não podem ser editadas nem removidas.

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

  • Pode adicionar, editar e remover alguns em qualquer altura.

Metadados não editáveis

Os seguintes metadados são definidos durante a criação do contentor e não podem ser editados nem removidos:

  • Nome do contentor

  • O projeto do qual o contentor faz parte

  • Número de geração

    • O número de geração de um contentor identifica de forma exclusiva a versão do contentor, mesmo que mais do que uma versão de um contentor partilhe o mesmo nome.

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

    • Não existe 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 único.

    • Não existe relação entre os números de geração de grupos não relacionados.

  • Número de metageração

    • O número de metageração de um contentor identifica de forma exclusiva o estado dos metadados do contentor. O número de metageração é 1 no momento da criação do contentor e aumenta sempre que modifica os metadados do contentor.

Metadados editáveis

Os metadados de contentores editáveis são metadados cujos valores pode normalmente modificar em qualquer altura. Em alguns casos, como o bucket estar sujeito a uma restrição de política da organização, existem restrições à modificação de determinados valores de metadados.

Vista geral dos metadados Link para o guia Notas
Listas de controlo de acesso (LCAs) Criar e gerir ACLs Recomendado apenas para utilizadores de XML.
ACLs predefinidas Defina ACLs de objetos predefinidas
Políticas de gestão de identidade e de acesso (IAM)1 Use autorizações de IAM
Faturação (o requerente paga) Use a funcionalidade Requester Pays
Configuração da partilha de recursos de origem cruzada (CORS) Configure e veja as configurações de CORS
Classe de armazenamento predefinida Altere a classe de armazenamento predefinida Definido durante a criação do contentor e pode ser editado, mas não removido.
Chave de encriptação do Cloud KMS predefinida Use chaves do Cloud KMS predefinidas
Retenções predefinidas com base em eventos1 Trabalhe com a propriedade de retenção predefinida baseada em eventos
Prevenção de acesso público1 Use a prevenção de acesso público
Acesso uniforme ao nível do contentor1 Use o acesso uniforme ao nível do contentor Só é editável durante os primeiros 90 dias após ativar o acesso uniforme ao nível do contentor num contentor.
Política de configuração do ciclo de vida Faça a gestão dos ciclos de vida dos objetos
Autoclass Use o Autoclass
Replicação turbo1 Faça a gestão da replicação turbo
Registos de utilização e registos de armazenamento Configuração dos registos de utilização
Bloqueio de segmentos2 Use e bloqueie políticas de retenção Só é editável se não bloquear a política de retenção.
Bloqueio de retenção de objetos Ative e use configurações de retenção de objetos Uma vez ativada para um contentor, não é possível desativá-la.
Configuração do controlo de versões de objetos Use o controlo de versões de objetos
Etiquetas de contentores Use etiquetas de contentores
Duração da retenção de eliminação recuperável Use a eliminação recuperável
Configuração do Website Atribua páginas especiais para Websites estáticos
Localização do contentor Mude a localização dos contentores Antes de mudar um contentor, reveja a página Vista geral da mudança de contentores.

1 Não é possível ver nem gerir estes metadados através da API XML.

2 Pode usar a API XML para definir estes metadados durante a criação do contentor, mas não para ver nem gerir estes metadados.

O que se segue?