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​

É possível copiar a URL pública de um objeto de duas formas:

  • Na lista de objetos, clique nos 3 pontinhos e em "Copiar URL".
  • Ao acessar um objeto, clique em "Ações" e em "Copiar URL".
mgc object-storage objects public-url [nome-do-bucket]/[nome-do-arquivo]
aws s3 presign s3://NOME_DO_BUCKET/NOME_DO_OBJETO

Alternativamente, pode-se utilizar:

aws s3api get-object-url --bucket [nome-do-bucket] --key [nome-do-arquivo]
rclone link NOME_DO_REMOTO:NOME_DO_BUCKET/NOME_DO_OBJETO

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.

Atualmente, não é possível configurar uma pre-signed URL de um objeto diretamente via Console. Para configurar essa URL, utilize CLI ou APIs.

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

  • expires-in: Define o tempo de validade da URL gerada. A unidade de tempo (como segundos, minutos ou horas) pode ser especificada.

  • method: Especifica o verbo HTTP para a operação a ser realizada (GET ou PUT) na URL pré-assinada.

aws s3 presign s3://NOME_DO_BUCKET NOME_DO_OBJETO --expires-in 420

Utilizando o AWS s3api:

aws s3api generate-presigned-url --bucket NOME_DO_BUCKET --key NOME_DO_OBJETO --expires-in 3600

O parâmetro expires-in é especificado em segundos.

rclone link NOME_DO_REMOTO:NOME_DO_BUCKET/NOME_DO_OBJETO

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.

Para acessar os metadados de um objeto clique sobre o seu nome na lista de objetos.

Ao fazer isso você terá acesso as suas informações básicas e também as informações de todas as suas versões.

mgc object-storage objects head NOME_DO_BUCKET/NOME_DO_OBJETO
aws s3 ls s3://NOME_DO_BUCKET/NOME_DO_OBJETO --recursive

Utilizando o AWS s3api:

aws s3api head-object --bucket NOME_DO_BUCKET --key NOME_DO_OBJETO
rclone lsjson REMOTE:BUCKET/NOME_DO_OBJETO