/
cURL
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.
Índice
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:
, multiple selections available,
Related content
API REST Portal Big File
API REST Portal Big File
More like this
API S3
API S3
More like this
GetObject
GetObject
More like this
OPTIONS object
OPTIONS object
More like this
CopyObject
CopyObject
More like this
UploadPart
UploadPart
More like this