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.
Pré-requisitos
Antes de começar, valide os seguintes processos:
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
- 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
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:
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
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
Próximos passos:
