Os objetos armazenados no Object Storage Service (OSS) consistem em chaves, dados e metadados. Os metadados descrevem o objeto e incluem cabeçalhos HTTP padrão e metadados de usuário. Configure cabeçalhos HTTP padrão para criar políticas personalizadas de requisição HTTP, como políticas de cache e de download forçado de objetos. Além disso, configure metadados de usuário para identificar a finalidade ou os atributos do objeto.
Observações
Este tópico usa o endpoint público da região China (Hangzhou). Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno. Para obter mais informações sobre regiões e endpoints do OSS, consulte Regiões e endpoints.
Neste tópico, as credenciais de acesso são obtidas de variáveis de ambiente. Para obter mais informações sobre como configurar credenciais de acesso, consulte Configurar credenciais de acesso.
Este tópico demonstra a criação de uma instância OSSClient com um endpoint do OSS. Para configurações alternativas, como uso de domínio personalizado ou autenticação com credenciais do Security Token Service (STS), consulte Configurar um cliente (Go SDK V1).
Para configurar metadados de objetos, você deve ter a permissão
oss:PutObject. Para consultar metadados de objetos, você deve ter a permissãooss:GetObject. Para obter mais informações, consulte Conceder uma política personalizada.
Código de exemplo
Configure metadados ao fazer upload de um objeto
Modifique metadados de objetos
Consultar metadados de objetos
Perguntas frequentes
Como impedir que um objeto existente com o mesmo nome seja substituído ao fazer upload e definir metadados simultaneamente?
Use um dos métodos a seguir para impedir a substituição de objetos com o mesmo nome no bucket:
-
Ative o controle de versão
Se você ativar o controle de versão para o bucket, o OSS manterá o objeto existente com o mesmo nome como uma versão anterior e armazenará o objeto enviado como a versão atual. É possível restaurar as versões anteriores a qualquer momento. Para obter mais informações, consulte Ativar controle de versão.
-
Incluir o cabeçalho x-oss-forbid-overwrite na requisição de upload
Inclua o cabeçalho x-oss-forbid-overwrite na requisição de upload e defina-o como true. Se você fizer upload de um objeto com o mesmo nome de um objeto existente, o upload falhará e o OSS retornará o erro FileAlreadyExists. Para obter mais informações, consulte PutObject.
Referências
Para obter o código de exemplo completo usado para consultar metadados de objetos, visite o GitHub.
Para obter mais informações sobre a operação de API que você pode chamar para configurar metadados de objetos durante um upload simples, consulte PutObject.
Para obter mais informações sobre a operação de API para modificar os metadados de um objeto existente, consulte CopyObject.
Para obter mais informações sobre as operações de API que você pode chamar para consultar metadados de objetos, consulte GetObjectMeta e HeadObject.