Skip to main content

Recuperar Informações do Objeto

Para acesso aos objetos é necessário obter um caminho, no caso uma URL pública ou uma pre-signed URL. Além disso, é possível acessar os metadados dos objetos para obter informações a eles relacionadas, como tamanho, tipo de conteúdo, data de última modificação entre outros.

Copiar a URL Pública do Objeto​

mgc object-storage objects public-url [nome-do-bucket]/[nome-do-arquivo]

A URL dos objetos segue o modelo de Virtual Hosting para Buckets (vHost). O padrão para formar a URL é o seguinte:

https://[regiao].magaluobjects.com/[nome-do-bucket]/[nome-do-arquivo]

  • [regiao]: Substitua pelo código da região apropriada, como br-ne1. Este código indica a região do data center onde o bucket está localizado.

  • [nome-do-bucket]: Substitua pelo identificador único do bucket, como mgc-bucket-1.

  • [nome-do-arquivo]: Substitua pelo nome do objeto específico dentro do bucket, como my-file.


note

Antes você precisará definir uma ACL para o Objeto


Configurar Pre-signed URL do Objeto​

Pre-signed URL é usada para acessar objetos de forma temporária e segura. Esses URLs possuem uma validade limitada e podem ser compartilhados com terceiros, facilitando o acesso aos objetos sem a necessidade de autenticação adicional.

Para gerar uma pre-signed URL para um objeto via CLI, execute o comando apropriado abaixo. O parâmetro expires-in define o tempo durante o qual a URL gerada poderá ser usada para acessar o objeto.

mgc object-storage objects presign s3://NOME_DO_BUCKET/NOME_DO_OBJETO --expires-in 72h

Você pode especificar a unidade de tempo desejada para o parâmetro expires-in.


Acessar Metadados dos Objetos​

Você pode usar o head para obter informações sobre o objeto, como o tamanho, tipo de conteúdo, data de última modificação e outros metadados associados ao objeto. Isso pode ser útil para entender as características do objeto sem precisar baixá-lo.

mgc object-storage objects head NOME_DO_BUCKET/NOME_DO_OBJETO