amsc-iri
A simple implementation of the IRI facility API using python and the fastApi library.
For more information, see: https://iri.science/
<img src="https://iri.science/images/doe-icon-old.png\" height=50 />
This Python package is automatically generated by the OpenAPI Generator project:
- API version: 2.0.0
- Package version: 1.0.0
- Generator version: 7.24.0
- Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://es.net/
Requirements.
Python 3.10+
Installation & Usage
pip install
If the python package is hosted on a repository, you can install directly using:
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 amsc_iri
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 amsc_iri
Tests
Execute pytest to run the tests.
Getting Started
Please follow the installation procedure and then run the following:
import amsc_iri
from amsc_iri.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://iri-dev.ppg.es.net
# See configuration.py for a list of all supported configuration parameters.
configuration = amsc_iri.Configuration(
host = "https://iri-dev.ppg.es.net"
)
# Enter a context with an instance of the API client
with amsc_iri.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = amsc_iri.AccountApi(api_client)
name = 'name_example' # str | (optional)
modified_since = '2026-02-21T12:00:00Z' # datetime | (optional)
offset = 0 # int | (optional) (default to 0)
limit = 100 # int | (optional) (default to 100)
try:
# Get the list of capabilities
api_response = api_instance.get_capabilities(name=name, modified_since=modified_since, offset=offset, limit=limit)
print("The response of AccountApi->get_capabilities:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling AccountApi->get_capabilities: %s\n" % e)
Documentation for API Endpoints
All URIs are relative to https://iri-dev.ppg.es.net
| Class | Method | HTTP request | Description |
|---|---|---|---|
| AccountApi | get_capabilities | GET /api/v1/account/capabilities | Get the list of capabilities |
| AccountApi | get_capability | GET /api/v1/account/capabilities/{capability_id} | Get a single capability |
| AccountApi | get_project | GET /api/v1/account/projects/{project_id} | Get a single project |
| AccountApi | get_project_allocation_by_project | GET /api/v1/account/projects/{project_id}/project_allocations/{project_allocation_id} | Get a single project allocation |
| AccountApi | get_project_allocations_by_project | GET /api/v1/account/projects/{project_id}/project_allocations | Get the allocations of the current user's projects |
| AccountApi | get_projects | GET /api/v1/account/projects | Get the projects of the current user |
| AccountApi | get_user_allocation_by_project_allocation | GET /api/v1/account/projects/{project_id}/project_allocations/{project_allocation_id}/user_allocations/{user_allocation_id} | Get a user allocation of the current user's projects |
| AccountApi | get_user_allocations_by_project_allocation | GET /api/v1/account/projects/{project_id}/project_allocations/{project_allocation_id}/user_allocations | Get the user allocations of the current user's projects |
| AccountApi | whoami | GET /api/v1/account/whoami | Get the authenticated user's username |
| ComputeApi | cancel_job | DELETE /api/v1/compute/cancel/{resource_id}/{job_id} | Cancel Job |
| ComputeApi | get_compute_resources | GET /api/v1/compute/resources | Get Resources |
| ComputeApi | get_job | GET /api/v1/compute/status/{resource_id}/{job_id} | Get Job Status |
| ComputeApi | get_jobs | POST /api/v1/compute/status/{resource_id} | Get Job Statuses |
| ComputeApi | launch_job | POST /api/v1/compute/job/{resource_id} | Submit Job |
| ComputeApi | update_job | PUT /api/v1/compute/job/{resource_id}/{job_id} | Update Job |
| FacilityApi | get_facility | GET /api/v1/facility | Get Facility |
| FacilityApi | get_site | GET /api/v1/facility/sites/{site_id} | Get Site |
| FacilityApi | get_sites | GET /api/v1/facility/sites | List Sites |
| FilesystemApi | checksum | POST /api/v1/filesystem/checksum/{resource_id} | Post Checksum |
| FilesystemApi | chmod | POST /api/v1/filesystem/chmod/{resource_id} | Post Chmod |
| FilesystemApi | chown | POST /api/v1/filesystem/chown/{resource_id} | Post Chown |
| FilesystemApi | compress | POST /api/v1/filesystem/compress/{resource_id} | Post Compress |
| FilesystemApi | cp | POST /api/v1/filesystem/cp/{resource_id} | Post Cp |
| FilesystemApi | download | POST /api/v1/filesystem/download/{resource_id} | Post Download |
| FilesystemApi | extract | POST /api/v1/filesystem/extract/{resource_id} | Post Extract |
| FilesystemApi | file | POST /api/v1/filesystem/file/{resource_id} | Post File |
| FilesystemApi | get_filesystem_resources | POST /api/v1/filesystem/resources | Post Resources |
| FilesystemApi | head | POST /api/v1/filesystem/head/{resource_id} | Post Head |
| FilesystemApi | ls | POST /api/v1/filesystem/ls/{resource_id} | Post Ls |
| FilesystemApi | mkdir | POST /api/v1/filesystem/mkdir/{resource_id} | Post Mkdir |
| FilesystemApi | mv | POST /api/v1/filesystem/mv/{resource_id} | Post Mv |
| FilesystemApi | rm | POST /api/v1/filesystem/rm/{resource_id} | Post Rm |
| FilesystemApi | stat | POST /api/v1/filesystem/stat/{resource_id} | Post Stat |
| FilesystemApi | symlink | POST /api/v1/filesystem/symlink/{resource_id} | Post Symlink |
| FilesystemApi | tail | POST /api/v1/filesystem/tail/{resource_id} | Post Tail |
| FilesystemApi | upload | POST /api/v1/filesystem/upload/{resource_id} | Post Upload |
| FilesystemApi | view | POST /api/v1/filesystem/view/{resource_id} | Post View |
| StatusApi | get_event_by_incident | GET /api/v1/status/events/{event_id} | Get a specific event |
| StatusApi | get_events_by_incident | GET /api/v1/status/events | Get all events |
| StatusApi | get_incident | GET /api/v1/status/incidents/{incident_id} | Get a specific incident and its events |
| StatusApi | get_incidents | GET /api/v1/status/incidents | Get all incidents without their events |
| StatusApi | get_resource | GET /api/v1/status/resources/{resource_id} | Get a specific resource |
| StatusApi | get_resources | GET /api/v1/status/resources | Get all resources |
| StorageApi | get_storage_access_endpoints | GET /api/v1/storage/access-endpoints/{resource_id} | Get data access endpoints for a storage resource |
| StorageApi | get_storage_locations | GET /api/v1/storage/locations/{resource_id} | Get resolved storage locations for a resource |
| TaskApi | delete_task | DELETE /api/v1/task/{task_id} | Delete Task |
| TaskApi | get_task | GET /api/v1/task/{task_id} | Get Task |
| TaskApi | get_tasks | GET /api/v1/task | Get Tasks |
Documentation For Models
- AccessCapability
- AccessEndpoint
- AccessPermissions
- AccessProtocol
- AllocationEntry
- Capability
- Container
- Endpoint
- Event
- Facility
- Incident
- IncidentType
- Job
- JobAttributes
- JobSpec
- JobState
- JobStatus
- LogicalName
- PostChecksumRequest
- PostCompressRequest
- PostCopyRequest
- PostDownloadRequest
- PostExtractRequest
- PostFileRequest
- PostFileSymlinkRequest
- PostHeadRequest
- PostLsRequest
- PostMakeDirRequest
- PostMoveRequest
- PostRmRequest
- PostStatRequest
- PostTailRequest
- PostViewRequest
- Problem
- Project
- ProjectAllocation
- PutFileChmodRequest
- PutFileChownRequest
- Resolution
- Resource
- ResourceSpec
- Site
- Status
- StorageInstance
- StorageIntent
- Task
- TaskCommand
- TaskStatus
- TaskSubmitResponse
- UserAllocation
- VolumeMount
- WhoAmI
Documentation For Authorization
Authentication schemes defined for the API:
HTTPBearer
- Type: Bearer authentication
Author
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file amsc_iri-2.0.0.tar.gz.
File metadata
- Download URL: amsc_iri-2.0.0.tar.gz
- Upload date:
- Size: 73.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e1c99bfbfa00ee119b0e0604f7fb5fde4cbec65d11f47e43db4c6968fe63032b
|
|
| MD5 |
559565f848edaf88ed42747b2160ef7d
|
|
| BLAKE2b-256 |
9da15e9de3584b5c8f4dd412705e5ae1124d039e68d0880780cfdca50449f9cd
|
File details
Details for the file amsc_iri-2.0.0-py3-none-any.whl.
File metadata
- Download URL: amsc_iri-2.0.0-py3-none-any.whl
- Upload date:
- Size: 133.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f4aee0c3a514e4a22fc6a3df987b28e4a9733e89a9d9a1b61c029b39e6af4b1
|
|
| MD5 |
5b69650d6aa305b0bc3c54c58b6c7451
|
|
| BLAKE2b-256 |
51f9f4037773087dddd33f2bd468576739b8ac716261b25bf391d099e4b8bb9a
|