Skip to content

samoz83/slurm_api_client

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
.github/workflows
.github/workflows
 
 
docs
docs
 
 
slurm_api_client
slurm_api_client
 
 
test
test
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
pyproject.toml
pyproject.toml
 
 
requirements.txt
requirements.txt
 
 
setup.cfg
setup.cfg
 
 
setup.py
setup.py
 
 
test-requirements.txt
test-requirements.txt
 
 
tox.ini
tox.ini
 
 

Repository files navigation

slurm-api-client

API to access and control Slurm

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: v0.0.40-v0.0.42
  • Package version: 1.0.0
  • Generator version: 7.13.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://www.schedmd.com/

Requirements.

Python 3.9+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/samoz83/slurm_api_client.git

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

Then import the package:

import slurm_api_client

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 slurm_api_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import slurm_api_client
from slurm_api_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost
# See configuration.py for a list of all supported configuration parameters.
configuration = slurm_api_client.Configuration(
    host = "http://localhost"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: user
configuration.api_key['user'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['user'] = 'Bearer'

# Configure Bearer authorization (JWT): bearerAuth
configuration = slurm_api_client.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)

# Configure API key authorization: token
configuration.api_key['token'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['token'] = 'Bearer'


# Enter a context with an instance of the API client
with slurm_api_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = slurm_api_client.SlurmApi(api_client)
    job_id = 'job_id_example' # str | Job ID
    signal = 'signal_example' # str | Signal to send to Job (optional)
    flags = 'flags_example' # str | Signalling flags (optional)

    try:
        # cancel or signal job
        api_response = api_instance.slurm_v0040_delete_job(job_id, signal=signal, flags=flags)
        print("The response of SlurmApi->slurm_v0040_delete_job:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling SlurmApi->slurm_v0040_delete_job: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://localhost

Class Method HTTP request Description
SlurmApi slurm_v0040_delete_job DELETE /slurm/v0.0.40/job/{job_id} cancel or signal job
SlurmApi slurm_v0040_delete_jobs DELETE /slurm/v0.0.40/jobs/ send signal to list of jobs
SlurmApi slurm_v0040_delete_node DELETE /slurm/v0.0.40/node/{node_name} delete node
SlurmApi slurm_v0040_get_diag GET /slurm/v0.0.40/diag/ get diagnostics
SlurmApi slurm_v0040_get_job GET /slurm/v0.0.40/job/{job_id} get job info
SlurmApi slurm_v0040_get_jobs GET /slurm/v0.0.40/jobs/ get list of jobs
SlurmApi slurm_v0040_get_jobs_state GET /slurm/v0.0.40/jobs/state/ get list of job states
SlurmApi slurm_v0040_get_licenses GET /slurm/v0.0.40/licenses/ get all Slurm tracked license info
SlurmApi slurm_v0040_get_node GET /slurm/v0.0.40/node/{node_name} get node info
SlurmApi slurm_v0040_get_nodes GET /slurm/v0.0.40/nodes/ get node(s) info
SlurmApi slurm_v0040_get_partition GET /slurm/v0.0.40/partition/{partition_name} get partition info
SlurmApi slurm_v0040_get_partitions GET /slurm/v0.0.40/partitions/ get all partition info
SlurmApi slurm_v0040_get_ping GET /slurm/v0.0.40/ping/ ping test
SlurmApi slurm_v0040_get_reconfigure GET /slurm/v0.0.40/reconfigure/ request slurmctld reconfigure
SlurmApi slurm_v0040_get_reservation GET /slurm/v0.0.40/reservation/{reservation_name} get reservation info
SlurmApi slurm_v0040_get_reservations GET /slurm/v0.0.40/reservations/ get all reservation info
SlurmApi slurm_v0040_get_shares GET /slurm/v0.0.40/shares get fairshare info
SlurmApi slurm_v0040_post_job POST /slurm/v0.0.40/job/{job_id} update job
SlurmApi slurm_v0040_post_job_submit POST /slurm/v0.0.40/job/submit submit new job
SlurmApi slurm_v0040_post_node POST /slurm/v0.0.40/node/{node_name} update node properties
SlurmApi slurm_v0040_post_nodes POST /slurm/v0.0.40/nodes/ batch update node(s)
SlurmApi slurm_v0041_delete_job DELETE /slurm/v0.0.41/job/{job_id} cancel or signal job
SlurmApi slurm_v0041_delete_jobs DELETE /slurm/v0.0.41/jobs/ send signal to list of jobs
SlurmApi slurm_v0041_delete_node DELETE /slurm/v0.0.41/node/{node_name} delete node
SlurmApi slurm_v0041_get_diag GET /slurm/v0.0.41/diag/ get diagnostics
SlurmApi slurm_v0041_get_job GET /slurm/v0.0.41/job/{job_id} get job info
SlurmApi slurm_v0041_get_jobs GET /slurm/v0.0.41/jobs/ get list of jobs
SlurmApi slurm_v0041_get_jobs_state GET /slurm/v0.0.41/jobs/state/ get list of job states
SlurmApi slurm_v0041_get_licenses GET /slurm/v0.0.41/licenses/ get all Slurm tracked license info
SlurmApi slurm_v0041_get_node GET /slurm/v0.0.41/node/{node_name} get node info
SlurmApi slurm_v0041_get_nodes GET /slurm/v0.0.41/nodes/ get node(s) info
SlurmApi slurm_v0041_get_partition GET /slurm/v0.0.41/partition/{partition_name} get partition info
SlurmApi slurm_v0041_get_partitions GET /slurm/v0.0.41/partitions/ get all partition info
SlurmApi slurm_v0041_get_ping GET /slurm/v0.0.41/ping/ ping test
SlurmApi slurm_v0041_get_reconfigure GET /slurm/v0.0.41/reconfigure/ request slurmctld reconfigure
SlurmApi slurm_v0041_get_reservation GET /slurm/v0.0.41/reservation/{reservation_name} get reservation info
SlurmApi slurm_v0041_get_reservations GET /slurm/v0.0.41/reservations/ get all reservation info
SlurmApi slurm_v0041_get_shares GET /slurm/v0.0.41/shares get fairshare info
SlurmApi slurm_v0041_post_job POST /slurm/v0.0.41/job/{job_id} update job
SlurmApi slurm_v0041_post_job_allocate POST /slurm/v0.0.41/job/allocate submit new job allocation without any steps that must be signaled to stop
SlurmApi slurm_v0041_post_job_submit POST /slurm/v0.0.41/job/submit submit new job
SlurmApi slurm_v0041_post_node POST /slurm/v0.0.41/node/{node_name} update node properties
SlurmApi slurm_v0041_post_nodes POST /slurm/v0.0.41/nodes/ batch update node(s)
SlurmApi slurm_v0042_delete_job DELETE /slurm/v0.0.42/job/{job_id} cancel or signal job
SlurmApi slurm_v0042_delete_jobs DELETE /slurm/v0.0.42/jobs/ send signal to list of jobs
SlurmApi slurm_v0042_delete_node DELETE /slurm/v0.0.42/node/{node_name} delete node
SlurmApi slurm_v0042_get_diag GET /slurm/v0.0.42/diag/ get diagnostics
SlurmApi slurm_v0042_get_job GET /slurm/v0.0.42/job/{job_id} get job info
SlurmApi slurm_v0042_get_jobs GET /slurm/v0.0.42/jobs/ get list of jobs
SlurmApi slurm_v0042_get_jobs_state GET /slurm/v0.0.42/jobs/state/ get list of job states
SlurmApi slurm_v0042_get_licenses GET /slurm/v0.0.42/licenses/ get all Slurm tracked license info
SlurmApi slurm_v0042_get_node GET /slurm/v0.0.42/node/{node_name} get node info
SlurmApi slurm_v0042_get_nodes GET /slurm/v0.0.42/nodes/ get node(s) info
SlurmApi slurm_v0042_get_partition GET /slurm/v0.0.42/partition/{partition_name} get partition info
SlurmApi slurm_v0042_get_partitions GET /slurm/v0.0.42/partitions/ get all partition info
SlurmApi slurm_v0042_get_ping GET /slurm/v0.0.42/ping/ ping test
SlurmApi slurm_v0042_get_reconfigure GET /slurm/v0.0.42/reconfigure/ request slurmctld reconfigure
SlurmApi slurm_v0042_get_reservation GET /slurm/v0.0.42/reservation/{reservation_name} get reservation info
SlurmApi slurm_v0042_get_reservations GET /slurm/v0.0.42/reservations/ get all reservation info
SlurmApi slurm_v0042_get_shares GET /slurm/v0.0.42/shares get fairshare info
SlurmApi slurm_v0042_post_job POST /slurm/v0.0.42/job/{job_id} update job
SlurmApi slurm_v0042_post_job_allocate POST /slurm/v0.0.42/job/allocate submit new job allocation without any steps that must be signaled to stop
SlurmApi slurm_v0042_post_job_submit POST /slurm/v0.0.42/job/submit submit new job
SlurmApi slurm_v0042_post_node POST /slurm/v0.0.42/node/{node_name} update node properties
SlurmApi slurm_v0042_post_nodes POST /slurm/v0.0.42/nodes/ batch update node(s)
SlurmdbApi slurmdb_v0040_delete_account DELETE /slurmdb/v0.0.40/account/{account_name} Delete account
SlurmdbApi slurmdb_v0040_delete_association DELETE /slurmdb/v0.0.40/association/ Delete association
SlurmdbApi slurmdb_v0040_delete_associations DELETE /slurmdb/v0.0.40/associations/ Delete associations
SlurmdbApi slurmdb_v0040_delete_cluster DELETE /slurmdb/v0.0.40/cluster/{cluster_name} Delete cluster
SlurmdbApi slurmdb_v0040_delete_single_qos DELETE /slurmdb/v0.0.40/qos/{qos} Delete QOS
SlurmdbApi slurmdb_v0040_delete_user DELETE /slurmdb/v0.0.40/user/{name} Delete user
SlurmdbApi slurmdb_v0040_delete_wckey DELETE /slurmdb/v0.0.40/wckey/{id} Delete wckey
SlurmdbApi slurmdb_v0040_get_account GET /slurmdb/v0.0.40/account/{account_name} Get account info
SlurmdbApi slurmdb_v0040_get_accounts GET /slurmdb/v0.0.40/accounts/ Get account list
SlurmdbApi slurmdb_v0040_get_association GET /slurmdb/v0.0.40/association/ Get association info
SlurmdbApi slurmdb_v0040_get_associations GET /slurmdb/v0.0.40/associations/ Get association list
SlurmdbApi slurmdb_v0040_get_cluster GET /slurmdb/v0.0.40/cluster/{cluster_name} Get cluster info
SlurmdbApi slurmdb_v0040_get_clusters GET /slurmdb/v0.0.40/clusters/ Get cluster list
SlurmdbApi slurmdb_v0040_get_config GET /slurmdb/v0.0.40/config Dump all configuration information
SlurmdbApi slurmdb_v0040_get_diag GET /slurmdb/v0.0.40/diag/ Get slurmdb diagnostics
SlurmdbApi slurmdb_v0040_get_instance GET /slurmdb/v0.0.40/instance/ Get instance info
SlurmdbApi slurmdb_v0040_get_instances GET /slurmdb/v0.0.40/instances/ Get instance list
SlurmdbApi slurmdb_v0040_get_job GET /slurmdb/v0.0.40/job/{job_id} Get job info
SlurmdbApi slurmdb_v0040_get_jobs GET /slurmdb/v0.0.40/jobs/ Get job list
SlurmdbApi slurmdb_v0040_get_qos GET /slurmdb/v0.0.40/qos/ Get QOS list
SlurmdbApi slurmdb_v0040_get_single_qos GET /slurmdb/v0.0.40/qos/{qos} Get QOS info
SlurmdbApi slurmdb_v0040_get_tres GET /slurmdb/v0.0.40/tres/ Get TRES info
SlurmdbApi slurmdb_v0040_get_user GET /slurmdb/v0.0.40/user/{name} Get user info
SlurmdbApi slurmdb_v0040_get_users GET /slurmdb/v0.0.40/users/ Get user list
SlurmdbApi slurmdb_v0040_get_wckey GET /slurmdb/v0.0.40/wckey/{id} Get wckey info
SlurmdbApi slurmdb_v0040_get_wckeys GET /slurmdb/v0.0.40/wckeys/ Get wckey list
SlurmdbApi slurmdb_v0040_post_accounts POST /slurmdb/v0.0.40/accounts/ Add/update list of accounts
SlurmdbApi slurmdb_v0040_post_accounts_association POST /slurmdb/v0.0.40/accounts_association/ Add accounts with conditional association
SlurmdbApi slurmdb_v0040_post_associations POST /slurmdb/v0.0.40/associations/ Set associations info
SlurmdbApi slurmdb_v0040_post_clusters POST /slurmdb/v0.0.40/clusters/ Get cluster list
SlurmdbApi slurmdb_v0040_post_config POST /slurmdb/v0.0.40/config Load all configuration information
SlurmdbApi slurmdb_v0040_post_qos POST /slurmdb/v0.0.40/qos/ Add or update QOSs
SlurmdbApi slurmdb_v0040_post_tres POST /slurmdb/v0.0.40/tres/ Add TRES
SlurmdbApi slurmdb_v0040_post_users POST /slurmdb/v0.0.40/users/ Update users
SlurmdbApi slurmdb_v0040_post_users_association POST /slurmdb/v0.0.40/users_association/ Add users with conditional association
SlurmdbApi slurmdb_v0040_post_wckeys POST /slurmdb/v0.0.40/wckeys/ Add or update wckeys
SlurmdbApi slurmdb_v0041_delete_account DELETE /slurmdb/v0.0.41/account/{account_name} Delete account
SlurmdbApi slurmdb_v0041_delete_association DELETE /slurmdb/v0.0.41/association/ Delete association
SlurmdbApi slurmdb_v0041_delete_associations DELETE /slurmdb/v0.0.41/associations/ Delete associations
SlurmdbApi slurmdb_v0041_delete_cluster DELETE /slurmdb/v0.0.41/cluster/{cluster_name} Delete cluster
SlurmdbApi slurmdb_v0041_delete_single_qos DELETE /slurmdb/v0.0.41/qos/{qos} Delete QOS
SlurmdbApi slurmdb_v0041_delete_user DELETE /slurmdb/v0.0.41/user/{name} Delete user
SlurmdbApi slurmdb_v0041_delete_wckey DELETE /slurmdb/v0.0.41/wckey/{id} Delete wckey
SlurmdbApi slurmdb_v0041_get_account GET /slurmdb/v0.0.41/account/{account_name} Get account info
SlurmdbApi slurmdb_v0041_get_accounts GET /slurmdb/v0.0.41/accounts/ Get account list
SlurmdbApi slurmdb_v0041_get_association GET /slurmdb/v0.0.41/association/ Get association info
SlurmdbApi slurmdb_v0041_get_associations GET /slurmdb/v0.0.41/associations/ Get association list
SlurmdbApi slurmdb_v0041_get_cluster GET /slurmdb/v0.0.41/cluster/{cluster_name} Get cluster info
SlurmdbApi slurmdb_v0041_get_clusters GET /slurmdb/v0.0.41/clusters/ Get cluster list
SlurmdbApi slurmdb_v0041_get_config GET /slurmdb/v0.0.41/config Dump all configuration information
SlurmdbApi slurmdb_v0041_get_diag GET /slurmdb/v0.0.41/diag/ Get slurmdb diagnostics
SlurmdbApi slurmdb_v0041_get_instance GET /slurmdb/v0.0.41/instance/ Get instance info
SlurmdbApi slurmdb_v0041_get_instances GET /slurmdb/v0.0.41/instances/ Get instance list
SlurmdbApi slurmdb_v0041_get_job GET /slurmdb/v0.0.41/job/{job_id} Get job info
SlurmdbApi slurmdb_v0041_get_jobs GET /slurmdb/v0.0.41/jobs/ Get job list
SlurmdbApi slurmdb_v0041_get_qos GET /slurmdb/v0.0.41/qos/ Get QOS list
SlurmdbApi slurmdb_v0041_get_single_qos GET /slurmdb/v0.0.41/qos/{qos} Get QOS info
SlurmdbApi slurmdb_v0041_get_tres GET /slurmdb/v0.0.41/tres/ Get TRES info
SlurmdbApi slurmdb_v0041_get_user GET /slurmdb/v0.0.41/user/{name} Get user info
SlurmdbApi slurmdb_v0041_get_users GET /slurmdb/v0.0.41/users/ Get user list
SlurmdbApi slurmdb_v0041_get_wckey GET /slurmdb/v0.0.41/wckey/{id} Get wckey info
SlurmdbApi slurmdb_v0041_get_wckeys GET /slurmdb/v0.0.41/wckeys/ Get wckey list
SlurmdbApi slurmdb_v0041_post_accounts POST /slurmdb/v0.0.41/accounts/ Add/update list of accounts
SlurmdbApi slurmdb_v0041_post_accounts_association POST /slurmdb/v0.0.41/accounts_association/ Add accounts with conditional association
SlurmdbApi slurmdb_v0041_post_associations POST /slurmdb/v0.0.41/associations/ Set associations info
SlurmdbApi slurmdb_v0041_post_clusters POST /slurmdb/v0.0.41/clusters/ Get cluster list
SlurmdbApi slurmdb_v0041_post_config POST /slurmdb/v0.0.41/config Load all configuration information
SlurmdbApi slurmdb_v0041_post_qos POST /slurmdb/v0.0.41/qos/ Add or update QOSs
SlurmdbApi slurmdb_v0041_post_tres POST /slurmdb/v0.0.41/tres/ Add TRES
SlurmdbApi slurmdb_v0041_post_users POST /slurmdb/v0.0.41/users/ Update users
SlurmdbApi slurmdb_v0041_post_users_association POST /slurmdb/v0.0.41/users_association/ Add users with conditional association
SlurmdbApi slurmdb_v0041_post_wckeys POST /slurmdb/v0.0.41/wckeys/ Add or update wckeys
SlurmdbApi slurmdb_v0042_delete_account DELETE /slurmdb/v0.0.42/account/{account_name} Delete account
SlurmdbApi slurmdb_v0042_delete_association DELETE /slurmdb/v0.0.42/association/ Delete association
SlurmdbApi slurmdb_v0042_delete_associations DELETE /slurmdb/v0.0.42/associations/ Delete associations
SlurmdbApi slurmdb_v0042_delete_cluster DELETE /slurmdb/v0.0.42/cluster/{cluster_name} Delete cluster
SlurmdbApi slurmdb_v0042_delete_single_qos DELETE /slurmdb/v0.0.42/qos/{qos} Delete QOS
SlurmdbApi slurmdb_v0042_delete_user DELETE /slurmdb/v0.0.42/user/{name} Delete user
SlurmdbApi slurmdb_v0042_delete_wckey DELETE /slurmdb/v0.0.42/wckey/{id} Delete wckey
SlurmdbApi slurmdb_v0042_get_account GET /slurmdb/v0.0.42/account/{account_name} Get account info
SlurmdbApi slurmdb_v0042_get_accounts GET /slurmdb/v0.0.42/accounts/ Get account list
SlurmdbApi slurmdb_v0042_get_association GET /slurmdb/v0.0.42/association/ Get association info
SlurmdbApi slurmdb_v0042_get_associations GET /slurmdb/v0.0.42/associations/ Get association list
SlurmdbApi slurmdb_v0042_get_cluster GET /slurmdb/v0.0.42/cluster/{cluster_name} Get cluster info
SlurmdbApi slurmdb_v0042_get_clusters GET /slurmdb/v0.0.42/clusters/ Get cluster list
SlurmdbApi slurmdb_v0042_get_config GET /slurmdb/v0.0.42/config Dump all configuration information
SlurmdbApi slurmdb_v0042_get_diag GET /slurmdb/v0.0.42/diag/ Get slurmdb diagnostics
SlurmdbApi slurmdb_v0042_get_instance GET /slurmdb/v0.0.42/instance/ Get instance info
SlurmdbApi slurmdb_v0042_get_instances GET /slurmdb/v0.0.42/instances/ Get instance list
SlurmdbApi slurmdb_v0042_get_job GET /slurmdb/v0.0.42/job/{job_id} Get job info
SlurmdbApi slurmdb_v0042_get_jobs GET /slurmdb/v0.0.42/jobs/ Get job list
SlurmdbApi slurmdb_v0042_get_ping GET /slurmdb/v0.0.42/ping/ ping test
SlurmdbApi slurmdb_v0042_get_qos GET /slurmdb/v0.0.42/qos/ Get QOS list
SlurmdbApi slurmdb_v0042_get_single_qos GET /slurmdb/v0.0.42/qos/{qos} Get QOS info
SlurmdbApi slurmdb_v0042_get_tres GET /slurmdb/v0.0.42/tres/ Get TRES info
SlurmdbApi slurmdb_v0042_get_user GET /slurmdb/v0.0.42/user/{name} Get user info
SlurmdbApi slurmdb_v0042_get_users GET /slurmdb/v0.0.42/users/ Get user list
SlurmdbApi slurmdb_v0042_get_wckey GET /slurmdb/v0.0.42/wckey/{id} Get wckey info
SlurmdbApi slurmdb_v0042_get_wckeys GET /slurmdb/v0.0.42/wckeys/ Get wckey list
SlurmdbApi slurmdb_v0042_post_accounts POST /slurmdb/v0.0.42/accounts/ Add/update list of accounts
SlurmdbApi slurmdb_v0042_post_accounts_association POST /slurmdb/v0.0.42/accounts_association/ Add accounts with conditional association
SlurmdbApi slurmdb_v0042_post_associations POST /slurmdb/v0.0.42/associations/ Set associations info
SlurmdbApi slurmdb_v0042_post_clusters POST /slurmdb/v0.0.42/clusters/ Get cluster list
SlurmdbApi slurmdb_v0042_post_config POST /slurmdb/v0.0.42/config Load all configuration information
SlurmdbApi slurmdb_v0042_post_qos POST /slurmdb/v0.0.42/qos/ Add or update QOSs
SlurmdbApi slurmdb_v0042_post_tres POST /slurmdb/v0.0.42/tres/ Add TRES
SlurmdbApi slurmdb_v0042_post_users POST /slurmdb/v0.0.42/users/ Update users
SlurmdbApi slurmdb_v0042_post_users_association POST /slurmdb/v0.0.42/users_association/ Add users with conditional association
SlurmdbApi slurmdb_v0042_post_wckeys POST /slurmdb/v0.0.42/wckeys/ Add or update wckeys

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

user

  • Type: API key
  • API key parameter name: X-SLURM-USER-NAME
  • Location: HTTP header

token

  • Type: API key
  • API key parameter name: X-SLURM-USER-TOKEN
  • Location: HTTP header

bearerAuth

  • Type: Bearer authentication (JWT)

Author

sales@schedmd.com

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 3

v1.0.1 Latest
Jun 12, 2025
+ 2 releases

Packages

 
 
 

Contributors

Languages