Researcher REST API¶
The purpose of the Researcher REST API is to provide an easy-to-use programming interface for submitting, listing and deleting Jobs.
There are other APIs that each the same functionality. Specifically:
- If your code is script-based, you may consider using the Run:AI command-line interface.
- You can communicate directly with the underlying Kubernetes infrastructure by sending YAML files or by using a variety of programming languages to send requests to Kubernetes. See Submit a Run:AI Job via Kubernetes API.
Finding the API Endpoint URL¶
The URL is composed of an IP address part and a port part (<IP-ADDRESS>:<PORT>
). To find the endpoint, run:
echo "http://$(kubectl get nodes -o=jsonpath='{.items[0].status.addresses[0].address}'):$(kubectl get services -n runai -o=jsonpath='{.items[?(@.metadata.name == "researcher-service")].spec.ports[0].nodePort}')"
Limitations¶
The Researcher REST API does not work when the system is configured to authenticate Researchers. We are working to add this functionality.
Last update: January 5, 2021