Skip to main content

A Python client for the Bacalhau public API - https://github.com/filecoin-project/bacalhau/tree/main/clients/python

Project description

bacalhau_apiclient

This page is the reference of the Bacalhau REST API. Project docs are available at https://docs.bacalhau.org/. Find more information about Bacalhau at https://github.com/filecoin-project/bacalhau.

This Python package is automatically generated by the Swagger Codegen project:

Requirements.

Python 3.6+

Installation & Usage

pip install

If the python package is hosted on Github, you can install directly from Github

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import bacalhau_apiclient 

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import bacalhau_apiclient

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import bacalhau_apiclient
from bacalhau_apiclient.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = bacalhau_apiclient.HealthApi(bacalhau_apiclient.ApiClient(configuration))

try:
    # Returns debug information on what the current node is doing.
    api_response = api_instance.api_serverdebug()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling HealthApi->api_serverdebug: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://bootstrap.production.bacalhau.org:1234

Class Method HTTP request Description
HealthApi api_serverdebug GET /debug Returns debug information on what the current node is doing.
HealthApi pkgrequesterdebug GET /requester/debug Returns debug information on what the current node is doing.
JobApi pkgrequesterevents POST /requester/events Returns the events related to the job-id passed in the body payload. Useful for troubleshooting.
JobApi pkgrequesterlist POST /requester/list Simply lists jobs.
JobApi pkgrequesterlocal_events POST /requester/local_events Returns the node's local events related to the job-id passed in the body payload. Useful for troubleshooting.
JobApi pkgrequesterresults POST /requester/results Returns the results of the job-id specified in the body payload.
JobApi pkgrequesterstates POST /requester/states Returns the state of the job-id specified in the body payload.
JobApi pkgrequestersubmit POST /requester/submit Submits a new job to the network.
MiscApi api_serverversion POST /version Returns the build version running on the server.
UtilsApi healthz GET /healthz
UtilsApi id GET /id Returns the id of the host node.
UtilsApi livez GET /livez
UtilsApi logz GET /logz
UtilsApi node_info GET /node_info Returns the info of the node.
UtilsApi peers GET /peers Returns the peers connected to the host via the transport layer.
UtilsApi readyz GET /readyz
UtilsApi varz GET /varz

Documentation For Models

Documentation For Authorization

All endpoints do not require authorization.

Author

team@bacalhau.org

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bacalhau_apiclient-0.3.18.post3.tar.gz (57.7 kB view hashes)

Uploaded Source

Built Distribution

bacalhau_apiclient-0.3.18.post3-py3-none-any.whl (136.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page