Objetos armazenados no Object Storage Service (OSS) são compostos por chaves, dados e metadados. Os metadados descrevem o objeto e incluem cabeçalhos HTTP padrão e metadados de usuário. Ao configurar cabeçalhos HTTP padrão, você pode crie políticas personalizadas de requisição HTTP, como políticas de cache e de download forçado de objetos. Já os metadados de usuário permitem identificar as finalidades ou os atributos de um objeto.
Observações
Este tópico utiliza o endpoint público da região China (Hangzhou). Para acessar o OSS a partir de outros serviços Alibaba Cloud na mesma região, use um endpoint interno. Para obter mais informações sobre regiões e endpoints do OSS, consulte Regions and endpoints.
Neste tópico, as credenciais de acesso são obtidas de variáveis de ambiente. Para saber como configure credenciais de acesso, consulte Configure access credentials.
Este tópico demonstra como crie uma instância OSSClient usando um endpoint do OSS. Para configurações alternativas, como usar um domínio personalizado ou autenticar com credenciais do Security Token Service (STS), consulte Configure a client (Go SDK V1).
Para configure metadados de objetos, você precisa da permissão
oss:PutObject. Para consultar metadados de objetos, é necessária a permissãooss:GetObject. Para obter detalhes, consulte Grant a custom policy.
Código de exemplo
Configure metadados de objetos ao fazer upload de um objeto
Modifique metadados de objetos
Consultar metadados de objetos
Perguntas frequentes
Ao fazer upload de um objeto para um bucket e defina metadados simultaneamente, como evitar a sobrescrita de um objeto existente com o mesmo nome?
Use um dos métodos a seguir para evitar a sobrescrita de objetos com o mesmo nome no bucket:
-
Ative o versionamento
Se você ative o versionamento 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 Enable version control.
-
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 o objeto enviado tiver 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 acessar o código de exemplo completo de consulta de metadados de objetos, visite GitHub.
Para obter mais informações sobre a operação de API usada para configure metadados de objetos durante o upload simples, consulte PutObject.
Para saber mais sobre a operação de API que permite modifique os metadados de um objeto existente, consulte CopyObject.
Para obter detalhes sobre a operação de API usada para consultar metadados de objetos, consulte GetObjectMeta e HeadObject.