bacalhau-apiclient 1.4.1

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

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/bacalhau-project/bacalhau.

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

• API version: ${VERSION}
• Package version:
• Build package: io.swagger.codegen.v3.generators.python.PythonClientCodegen For more information, please visit https://github.com/bacalhau-project/bacalhau

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.ComputeNodeApi(bacalhau_apiclient.ApiClient(configuration))

try:
    # Approves a job to be run on this compute node.
    api_response = api_instance.api_serverapprover()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ComputeNodeApi->api_serverapprover: %s\n" % e)

# create an instance of the API class
api_instance = bacalhau_apiclient.ComputeNodeApi(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 ComputeNodeApi->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
ComputeNodeApi	api_serverapprover	GET /api/v1/compute/approve	Approves a job to be run on this compute node.
ComputeNodeApi	api_serverdebug	GET /api/v1/compute/debug	Returns debug information on what the current node is doing.
MiscApi	api_serverversion	POST /api/v1/version	Returns the build version running on the server.
OpsApi	agentalive	GET /api/v1/agent/alive
OpsApi	agentdebug	GET /api/v1/agent/debug	Returns debug information on what the current node is doing.
OpsApi	agentnode	GET /api/v1/agent/node	Returns the info of the node.
OpsApi	agentversion	GET /api/v1/agent/version	Returns the build version running on the server.
OrchestratorApi	orchestratorget_job	GET /api/v1/orchestrator/jobs/{id}	Returns a job.
OrchestratorApi	orchestratorget_node	GET /api/v1/orchestrator/nodes/{id}	Get an orchestrator node
OrchestratorApi	orchestratorjob_executions	GET /api/v1/orchestrator/jobs/{id}/executions	Returns the executions of a job.
OrchestratorApi	orchestratorjob_history	GET /api/v1/orchestrator/jobs/{id}/history	Returns the history of a job.
OrchestratorApi	orchestratorjob_results	GET /api/v1/orchestrator/jobs/{id}/results	Returns the results of a job.
OrchestratorApi	orchestratorlist_jobs	GET /api/v1/orchestrator/jobs	Returns a list of jobs.
OrchestratorApi	orchestratorlist_nodes	GET /api/v1/orchestrator/nodes	Returns a list of orchestrator nodes.
OrchestratorApi	orchestratorlogs	GET /api/v1/orchestrator/jobs/{id}/logs	Displays the logs for a current job/execution
OrchestratorApi	orchestratorput_job	PUT /api/v1/orchestrator/jobs	Submits a job to the orchestrator.
OrchestratorApi	orchestratorstop_job	DELETE /api/v1/orchestrator/jobs/{id}	Stops a job.
OrchestratorApi	orchestratorupdate_node	POST /api/v1/orchestrator/nodes	Update an orchestrator node.
UtilsApi	healthz	GET /api/v1/healthz
UtilsApi	home	GET /
UtilsApi	id	GET /api/v1/id	Returns the id of the host node.
UtilsApi	livez	GET /api/v1/livez
UtilsApi	node_info	GET /api/v1/node_info	Returns the info of the node.

Documentation For Models

• AllOfExecutionAllocatedResources
• AllOfExecutionComputeState
• AllOfExecutionDesiredState
• AllOfExecutionJob
• AllOfExecutionPublishedResult
• AllOfExecutionRunOutput
• AllOfGPUVendor
• AllOfInputSourceSource
• AllOfJobState
• AllOfLabelSelectorRequirementOperator
• AllOfStateExecutionDesiredStateTypeStateType
• AllOfStateExecutionStateTypeStateType
• AllOfStateJobStateTypeStateType
• AllOfTaskResources
• AllocatedResources
• ApiGetJobResponse
• ApiGetNodeResponse
• ApiGetVersionResponse
• ApiHTTPCredential
• ApiListJobExecutionsResponse
• ApiListJobHistoryResponse
• ApiListJobResultsResponse
• ApiListJobsResponse
• ApiListNodesResponse
• ApiPutJobRequest
• ApiPutJobResponse
• ApiPutNodeRequest
• ApiPutNodeResponse
• ApiStopJobResponse
• BuildVersionInfo
• ComputeNodeInfo
• DebugInfo
• Event
• Execution
• ExecutionDesiredStateType
• ExecutionStateType
• FreeSpace
• GPU
• GPUVendor
• HealthInfo
• InputSource
• Job
• JobHistory
• JobHistoryType
• JobStateType
• LabelSelectorRequirement
• MountStatus
• Network
• NetworkConfig
• NodeConnectionState
• NodeInfo
• NodeMembershipState
• NodeState
• NodeType
• Resources
• ResourcesConfig
• ResultPath
• RunCommandResult
• SelectionOperator
• SharedVersionRequest
• SharedVersionResponse
• SpecConfig
• StateChangeExecutionStateType
• StateChangeJobStateType
• StateExecutionDesiredStateType
• StateExecutionStateType
• StateJobStateType
• Task
• TimeoutConfig

Documentation For Authorization

All endpoints do not require authorization.

Author

[e-mail]