Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Com as APIs utilizadas no nosso portal BigFile  (API S3API Big File) é possível desenvolver rotinas de backup por meio de chamadas via cURL.

Índice

Table of Contents

Pré-requisitos


Antes de começar, valide os seguintes processos:



Warning

Antes de começar é necessário que você tenha acesso aos parâmetros de uso da API. 

Esse manual mostra como acessá-los: API Big File


Etapa 1: Autenticação


  1. Primeiro, você precisa obter um token para isso entre em Informações de Usuário obtenha a URL Pública e o Token da API.


Info
titleInfo

O Token da API tem uma validade e pode ser expirado ou renovado ,recomenda-se que seja utilizado um chamado através da API Big File usando a função abaixo:

Code Block
themeMidnight
curl -X POST -H "Content-Type: application/json" -d '{"account":"sua_account","user":"seu_usuário","password":"sua_senha"}' 'https://bigfile.brascloud.com.br:8443/api/users/authenticate.json' | jq '.response.user.zios_data.zios_user.token



Etapa 2: Uso


Criar um Bucket 


Code Block
languagebash
themeMidnight
curl -i -X PUT -H "X-Auth-Token: "X-Auth-Token: <token>" <url_publica>/novo_bucket

Upload/Download um objeto para o Bucket 


  • Fazendo upload de um objeto:
Code Block
languagebash
themeMidnight
curl -i -T objeto -X PUT -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto
  • Fazendo o download de um objeto:
Code Block
languagebash
themeMidnight
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto -O

Obtendo metadados


  • Informações sobre buckets podem ser obtidas por:
Code Block
languagebash
themeMidnight
curl -i --head -H "X-Auth-Token: <token>" <url_publica>/bucket_name
  • Informações sobre um objeto podem ser recuperadas através de:
Code Block
languagebash
themeMidnight
curl -i --head -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto

Listar os buckets de uma conta


Code Block
languagebash
themeMidnight
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica>

Listar o conteúdo de um buckets 


Code Block
languagebash
themeMidnight
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica>/bucket_name

Excluir um bucket


Code Block
languagebash
themeMidnight
curl -s -S -X DELETE -H "X-Auth-Token: <token>" <url_publica>/bucket_name


Notewarning
titleImportante

Você pode excluir apenas um bucket vazio. Se você tentar excluir um bucket não vazio, você receberá a mensagem de erro: "Houve um conflito ao tentar concluir sua solicitação".

Excluir um objeto 


Code Block
languagebash
themeMidnight
curl -s -S -X DELETE -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto


Próximos passos:

Page Tree
rootBig File Object Storage