cURL
Com as APIs utilizadas no nosso portal BigFile (API S3 e API Big File) é possível desenvolver rotinas de backup por meio de chamadas via cURL.
Nesse manual será mostrado um script de exemplo que pode ser alterado conforme a aplicação.
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
Autenticação
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:
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 funcão abaixo:
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
Uso
Criar um Bucket
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:
curl -i -T objeto -X PUT -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto
Fazendo o download de um objeto:
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:
curl -i --head -H "X-Auth-Token: <token>" <url_publica>/bucket_name
Informações sobre um objeto podem ser recuperadas através de:
curl -i --head -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto
Listar os buckets de uma conta
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica>
Listar o conteúdo de um buckets
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica>/bucket_name
Excluir um bucket
curl -s -S -X DELETE -H "X-Auth-Token: <token>" <url_publica>/bucket_name
Importante: 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
curl -s -S -X DELETE -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto
Outras ferramentas client
Ainda tem dúvidas?
Você pode abrir um chamado conosco acessando nosso portal de suporte, estamos a disposição.