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.
Pré-requisitos
Os pré-requisitos podem variar com base na ferramenta usada:
Console
Para concluir este guia usando o Console do Google Cloud, é preciso ter as permissões de IAM adequadas. Se o objeto que você quer acessar existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para o Console do Google Cloud.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
Linha de comando
Para concluir este guia usando um utilitário de linha de comando, você precisa ter as permissões de IAM adequadas. Se o objeto que você quer acessar existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para comandos gsutil.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
Exemplos de código
Para concluir este guia usando as bibliotecas de cliente do Cloud Storage, é preciso ter as permissões de IAM adequadas. Se o objeto que você quer acessar existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias. Salvo indicação em contrário, as solicitações de biblioteca de cliente são feitas por meio da API JSON.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
APIs REST
API JSON
Para concluir este guia usando a API JSON, é preciso ter as permissões do IAM adequadas. Se o objeto que você quer acessar existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.
Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.
Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.
Ver metadados do objeto
Conclua as instruções a seguir para visualizar os metadados associados a um objeto:
Console
- No Console do Cloud, acesse a página Navegador do Cloud Storage.
Na lista de buckets, clique no nome daquele que contém o objeto que você quer.
A página Detalhes do bucket será 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 menu mais ações (
) associado ao objeto.
Clique em Editar metadados.
Aparecerá uma janela de sobreposição que mostra os valores atuais dos metadados editáveis do objeto.
Para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage, consulte Solução de problemas.
Linha de comando
Use o comando gsutil stat
:
gsutil stat 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:
gs://my-awesome-bucket/cat.jpeg: Creation time: Fri, 03 Feb 2017 22:43:31 GMT Update time: Wed, 10 May 2017 18:33:07 GMT Storage class: STANDARD Content-Length: 11012 Content-Type: image/jpeg Metadata: Breed: Tabby Hash (crc32c): HQbzrB== Hash (md5): OBydg25+pPG1Cwawjsl7DA== ETag: CJCh9apA9dECAEs= Generation: 1486161811706000 Metageneration: 11
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage para C++.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.
Terraform
É possível usar um recurso do Terraform para visualizar os metadados de um objeto.
APIs REST
API JSON
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.
Use
cURL
para chamar a API JSON com uma solicitação deGET
Objeto:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Em que:
OAUTH2_TOKEN
é o token de acesso gerado na etapa 1.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
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.
Use
cURL
(em inglês) para chamar a API XML com uma solicitação de objetoHEAD
:curl -I HEAD \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Em que:
OAUTH2_TOKEN
é o token de acesso gerado na etapa 1.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 Cloud, acesse a página Navegador do Cloud Storage.
Na lista de buckets, clique no nome daquele que contém o objeto que você quer.
A página Detalhes do bucket será aberta, com a guia Objetos selecionada.
Navegue até o objeto, que pode estar localizado em uma pasta.
Clique no menu mais ações (
) associado ao objeto.
Clique em Editar metadados.
Na janela de sobreposição que aparece, faça as edições que você quiser nos metadados.
Nos campos de metadados padrão, edite o valor.
Adicione os próprios metadados personalizados clicando no botão + Adicionar item.
Edite a chave e o valor dos metadados personalizados.
Exclua os metadados personalizados clicando nos respectivos X.
Clique em Save.
Para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage, consulte Solução de problemas.
Linha de comando
Use o comando gsutil setmeta -h
:
gsutil setmeta -h "METADATA_KEY:METADATA_VALUE" gs://BUCKET_NAME/OBJECT_NAME
Em que:
METADATA_KEY
é a chave dos metadados que você quer definir. Por exemplo,Content-Type
.METADATA_VALUE
é o valor dos metadados que você quer definir. Por exemplo,image/png
.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
.
Se bem-sucedida, a resposta será parecida com esta:
Operation completed over 1 objects.
Se você estiver adicionando metadados personalizados com a gsutil, precisará incluir x-goog-meta-
como prefixo da chave de metadados para que a ferramenta reconheça que se trata de um atributo de metadados personalizados, não um cabeçalho HTTP padrão. A chave de metadados
não é armazenada com o prefixo x-goog-meta-
. Um exemplo de
"METADATA_KEY:METADATA_VALUE"
personalizado é
"x-goog-meta-dogbreed:shibainu"
.
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage para C++.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.
APIs REST
API JSON
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.
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 OAUTH2_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.OAUTH2_TOKEN
é o nome do token de acesso gerado na Etapa 1.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.
- Alterar classe de armazenamento associada a um objeto.
- Adicionar uma retenção a um objeto.