Nesta página, você aprenderá como ver e editar os metadados associados a objetos armazenados no Cloud Storage.
Esta página não abrange a visualização ou edição das políticas de Gerenciamento de Identidade e Acesso (IAM, na sigla em inglês) ou das Listas de Controle de Acesso (ACLs, na sigla em inglês) ao objeto, que controlam a permissão de acesso aos seus dados. Consulte os guias Como usar permissões de IAM e Como criar e gerenciar ACLs para realizar essas tarefas.
Funções exigidas
Para receber as permissões necessárias para visualizar e editar os metadados de objetos, peça ao administrador para conceder a você o papel de Usuário do objeto do Storage (roles/storage.objectUser
) no bucket.
Esse papel contém as permissões necessárias para visualizar e editar os metadados de objetos. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.list
- Essa permissão só é necessária ao usar o console do Google Cloud para executar a tarefa nesta página.
storage.objects.get
storage.objects.getIamPolicy
- Essa permissão só será necessária se você quiser retornar as políticas do IAM de um objeto.
storage.objects.list
storage.objects.setRetention
- Essa permissão só será necessária se você quiser definir a configuração de retenção de um objeto.
storage.objects.update
Também é possível conseguir essas permissões com outros papéis predefinidos ou personalizados.
Para instruções sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Mostrar metadados do objeto
Conclua as instruções a seguir para visualizar os metadados associados a um objeto:
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome daquele que contém o objeto com os metadados que você quer visualizar.
A página Detalhes do bucket é aberta, com a guia Objetos selecionada.
Navegue até o objeto, que pode estar localizado em uma pasta.
Alguns valores de metadados do objeto, como o tamanho e a classe de armazenamento, são exibidos ao lado do nome do objeto.
Clique no nome do objeto.
A página Detalhes do objeto é aberta, mostrando outros metadados do objeto.
Clique em Editar metadados.
A janela de sobreposição que aparece mostra os valores atuais para várias outras chaves de metadados do objeto, incluindo metadados personalizados.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud, consulte Solução de problemas.
Linha de comando
Use o comando gcloud storage objects describe
:
gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto com os metadados que você quer ver. Por exemplo,my-awesome-bucket
.OBJECT_NAME
é o nome do objeto com os metadados que você quer ver. Por exemplo,cat.jpeg
.
Se a operação for bem-sucedida, a resposta será semelhante a esta:
bucket: my-awesome-bucket content_type: image/png crc32c_hash: pNKjPQ== creation_time: 2024-01-26T21:33:04+0000 custom_fields: Animal: Cat Type: Cute custom_time: 1970-01-01T00:00:00+0000 etag: CMXyydSA/IMDEAE= generation: '1706304784726341' md5_hash: KCbI3PYk1aHfekIvf/osrw== metageneration: 1 name: kitten.png size: 168276 storage_class: STANDARD storage_class_update_time: 2024-01-26T21:33:04+0000 storage_url: gs://my-awesome-bucket/kitten.png#1706304784726341 update_time: 2024-01-26T21:33:04+0000
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Terraform
É possível usar um recurso do Terraform para visualizar os metadados de um objeto.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação deGET
Objeto:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto com os metadados que você quer ver. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto com os metadados que você quer ver. Por exemplo,pets/dog.png
, codificado em URL comopets%2Fdog.png
.
API XML
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
(em inglês) para chamar a API XML com uma solicitação de objetoHEAD
:curl -I HEAD \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto com os metadados que você quer ver. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto com os metadados que você quer ver. Por exemplo,pets/dog.png
, codificado em URL comopets%2Fdog.png
.
Editar metadados do objeto
Conclua as etapas a seguir para editar os metadados associados a um objeto:
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome daquele que contém o objeto com os metadados que você quer editar.
A página Detalhes do bucket é aberta, com a guia Objetos selecionada.
Navegue até o objeto, que pode estar localizado em uma pasta.
Clique no nome do objeto.
A página Detalhes do objeto é aberta, mostrando os metadados do objeto.
Clique no ícone de lápis associado aos metadados que você quer editar, se eles aparecerem na página.
Caso contrário, clique em Editar metadados para acessar outros metadados editáveis.
Na janela de sobreposição que aparece, edite os metadados conforme necessário
Nos campos de metadados padrão, edite o valor.
Adicione os próprios metadados personalizados clicando no botão add_boxAdicionar item.
Edite a chave e o valor dos metadados personalizados.
Exclua os metadados personalizados clicando nos respectivos X.
Quando terminar de editar os metadados na janela de sobreposição, clique em Salvar.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud, consulte Solução de problemas.
Linha de comando
Use o comando gcloud storage objects update
:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME METADATA_FLAG
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto com os metadados que você quer editar. Por exemplo,my-bucket
.OBJECT_NAME
é o nome do objeto com os metadados que você quer editar. Por exemplo,pets/dog.png
.METADATA_FLAG
é a sinalização dos metadados que você quer editar. Por exemplo,--content-type=image/png
.
Se funcionar, a resposta será parecida com esta:
Patching gs://my-bucket/pets/dog.png#1560574162144861... Completed 1
Para ver uma lista completa de metadados que podem ser atualizados com este comando, consulte a página de referência do comando.
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Crie um arquivo JSON que contenha os metadados que você quer modificar.
Para adicionar ou modificar metadados de chave fixa, como
contentType
, use o seguinte formato:{ "STANDARD_METADATA_KEY": "STANDARD_METADATA_VALUE" }
Em que:
STANDARD_METADATA_KEY
é a chave para os metadados que você quer adicionar ou modificar. Por exemplo,Content-Type
.STANDARD_METADATA_VALUE
é o valor dos metadados que você quer adicionar ou modificar. Por exemplo,image/png
.
Para adicionar ou modificar metadados personalizados, use o seguinte formato:
{ "metadata": { "CUSTOM_METADATA_KEY": "CUSTOM_METADATA_VALUE" } }
Em que:
CUSTOM_METADATA_KEY
é a chave de metadados personalizados que você quer adicionar ou modificar. Por exemplo,dogbreed
.CUSTOM_METADATA_VALUE
é o valor que você quer associar à chave de metadados personalizada. Por exemplo,shibainu
.
Para excluir uma entrada de metadados personalizados, use o seguinte formato:
{ "metadata": { "CUSTOM_METADATA_KEY": null } }
Em que:
CUSTOM_METADATA_KEY
é a chave para os metadados personalizados que você quer excluir. Por exemplo,dogbreed
.
Use
cURL
para chamar a API JSON com uma solicitação dePATCH
Objeto:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Em que:
JSON_FILE_NAME
é o caminho para o arquivo criado na Etapa 2.BUCKET_NAME
é o nome do bucket que contém o objeto com os metadados que você quer editar. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto com os metadados que você quer editar. Por exemplo,pets/dog.png
, codificado em URL comopets%2Fdog.png
.
Também é possível alterar os metadados de um objeto com uma solicitação UPDATE
Object. Ao usar esse método, todos os metadados que não estiverem explicitamente especificados na solicitação serão removidos do objeto.
API XML
Ao trabalhar com a API XML, os metadados são definidos somente no momento em que o objeto é gravado, como ao fazer upload, mover ou substituir o objeto. Siga as instruções de como fazer o upload de um objeto com as seguintes orientações:
Adicione
-H "METADATA_KEY:METADATA_VALUE"
ao cabeçalho da solicitação para cada valor de metadado a ser definido. Por exemplo,-H "Content-Type:image/png"
.Inclua
x-goog-meta-
com prefixo em todos os valores de metadados personalizados. Um exemplo de"METADATA_KEY:METADATA_VALUE"
personalizado é"x-goog-meta-dogbreed:shibainu"
.
Para mais informações, consulte Upload de um objeto para XML.
A seguir
- Saiba mais sobre os metadados associados a um objeto.
- Acessar metadados do bucket.
- Alterar a classe de armazenamento de um objeto.
- Adicionar uma retenção a um objeto.
- Saiba como usar condições prévias de solicitação para garantir que os metadados do objeto não sejam alterados entre as solicitações.