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
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
- 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:
|
Etapa 2: Uso
Criar um Bucket
Code Block | ||||
---|---|---|---|---|
| ||||
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 | ||||
---|---|---|---|---|
| ||||
curl -i -T objeto -X PUT -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto |
- Fazendo o download de um objeto:
Code Block | ||||
---|---|---|---|---|
| ||||
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 | ||||
---|---|---|---|---|
| ||||
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 | ||||
---|---|---|---|---|
| ||||
curl -i --head -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto |
Listar os buckets de uma conta
Code Block | ||||
---|---|---|---|---|
| ||||
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica> |
Listar o conteúdo de um buckets
Code Block | ||||
---|---|---|---|---|
| ||||
curl -s -S -X GET -H "X-Auth-Token: <token>" <url_publica>/bucket_name |
Excluir um bucket
Code Block | ||||
---|---|---|---|---|
| ||||
curl -s -S -X DELETE -H "X-Auth-Token: <token>" <url_publica>/bucket_name |
Note |
---|
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
Code Block | ||||
---|---|---|---|---|
| ||||
curl -s -S -X DELETE -H "X-Auth-Token: <token>" <url_publica>/bucket_name/objeto |
Próximos passos:
Page Tree | ||
---|---|---|
|