amsc-iri-v2
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_v2
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_v2
Tests
Execute pytest to run the tests.
Getting Started
Please follow the installation procedure and then run the following:
import amsc_iri_v2
from amsc_iri_v2.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_v2.Configuration(
host = "https://iri-dev.ppg.es.net"
)
# Enter a context with an instance of the API client
with amsc_iri_v2.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = amsc_iri_v2.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/v2/account/capabilities | Get the list of capabilities |
| AccountApi | get_capability | GET /api/v2/account/capabilities/{capability_id} | Get a single capability |
| AccountApi | get_project | GET /api/v2/account/projects/{project_id} | Get a single project |
| AccountApi | get_project_allocation_by_project | GET /api/v2/account/projects/{project_id}/project_allocations/{project_allocation_id} | Get a single project allocation |
| AccountApi | get_project_allocations_by_project | GET /api/v2/account/projects/{project_id}/project_allocations | Get the allocations of the current user's projects |
| AccountApi | get_projects | GET /api/v2/account/projects | Get the projects of the current user |
| AccountApi | get_user_allocation_by_project_allocation | GET /api/v2/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/v2/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/v2/account/whoami | Get the authenticated user's username |
| ComputeApi | cancel_job | DELETE /api/v2/compute/cancel/{resource_id}/{job_id} | Cancel Job |
| ComputeApi | get_compute_resources | GET /api/v2/compute/resources | Get Resources |
| ComputeApi | get_job | GET /api/v2/compute/status/{resource_id}/{job_id} | Get Job Status |
| ComputeApi | get_jobs | POST /api/v2/compute/status/{resource_id} | Get Job Statuses |
| ComputeApi | launch_job | POST /api/v2/compute/job/{resource_id} | Submit Job |
| ComputeApi | update_job | PUT /api/v2/compute/job/{resource_id}/{job_id} | Update Job |
| FacilityApi | get_facility | GET /api/v2/facility | Get Facility |
| FacilityApi | get_site | GET /api/v2/facility/sites/{site_id} | Get Site |
| FacilityApi | get_sites | GET /api/v2/facility/sites | List Sites |
| FilesystemApi | checksum | POST /api/v2/filesystem/checksum/{resource_id} | Post Checksum |
| FilesystemApi | chmod | POST /api/v2/filesystem/chmod/{resource_id} | Post Chmod |
| FilesystemApi | chown | POST /api/v2/filesystem/chown/{resource_id} | Post Chown |
| FilesystemApi | compress | POST /api/v2/filesystem/compress/{resource_id} | Post Compress |
| FilesystemApi | cp | POST /api/v2/filesystem/cp/{resource_id} | Post Cp |
| FilesystemApi | download | POST /api/v2/filesystem/download/{resource_id} | Post Download |
| FilesystemApi | extract | POST /api/v2/filesystem/extract/{resource_id} | Post Extract |
| FilesystemApi | file | POST /api/v2/filesystem/file/{resource_id} | Post File |
| FilesystemApi | get_filesystem_resources | POST /api/v2/filesystem/resources | Post Resources |
| FilesystemApi | head | POST /api/v2/filesystem/head/{resource_id} | Post Head |
| FilesystemApi | ls | POST /api/v2/filesystem/ls/{resource_id} | Post Ls |
| FilesystemApi | mkdir | POST /api/v2/filesystem/mkdir/{resource_id} | Post Mkdir |
| FilesystemApi | mv | POST /api/v2/filesystem/mv/{resource_id} | Post Mv |
| FilesystemApi | rm | POST /api/v2/filesystem/rm/{resource_id} | Post Rm |
| FilesystemApi | stat | POST /api/v2/filesystem/stat/{resource_id} | Post Stat |
| FilesystemApi | symlink | POST /api/v2/filesystem/symlink/{resource_id} | Post Symlink |
| FilesystemApi | tail | POST /api/v2/filesystem/tail/{resource_id} | Post Tail |
| FilesystemApi | upload | POST /api/v2/filesystem/upload/{resource_id} | Post Upload |
| FilesystemApi | view | POST /api/v2/filesystem/view/{resource_id} | Post View |
| StatusApi | get_event_by_incident | GET /api/v2/status/events/{event_id} | Get a specific event |
| StatusApi | get_events_by_incident | GET /api/v2/status/events | Get all events |
| StatusApi | get_incident | GET /api/v2/status/incidents/{incident_id} | Get a specific incident and its events |
| StatusApi | get_incidents | GET /api/v2/status/incidents | Get all incidents without their events |
| StatusApi | get_resource | GET /api/v2/status/resources/{resource_id} | Get a specific resource |
| StatusApi | get_resources | GET /api/v2/status/resources | Get all resources |
| StorageApi | get_storage_access_endpoints | GET /api/v2/storage/access-endpoints/{resource_id} | Get data access endpoints for a storage resource |
| StorageApi | get_storage_locations | GET /api/v2/storage/locations/{resource_id} | Get resolved storage locations for a resource |
| TaskApi | delete_task | DELETE /api/v2/task/{task_id} | Delete Task |
| TaskApi | get_task | GET /api/v2/task/{task_id} | Get Task |
| TaskApi | get_tasks | GET /api/v2/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
Metadata
Release files for amsc-iri-v2 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| amsc_iri_v2-1.0.0.tar.gz | 73.4 kB | Without provenance | Details for amsc_iri_v2-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| amsc_iri_v2-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for amsc_iri_v2-1.0.0-py3-none-any.whl |
Total release size: 208.6 kB
Release files / amsc_iri_v2-1.0.0.tar.gz
| Download URL | amsc_iri_v2-1.0.0.tar.gz |
|---|---|
| Size | 73.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6e3e1dc20a94cf6b98c11881aab1f27c158178a69bcd295d6034602bf0ce156a
|
|
BLAKE2b-256 checksum How to use checksums |
0161cf98259a5417af153856cb691d7972c2f6dcddcc802b0e438cf7363ea7b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / amsc_iri_v2-1.0.0-py3-none-any.whl
| Download URL | amsc_iri_v2-1.0.0-py3-none-any.whl |
|---|---|
| Size | 135.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5be413fa8cfe34d46a81829d979131c4deabf59b736ef9bf26c4d9cb697d256c
|
|
BLAKE2b-256 checksum How to use checksums |
d7143b4f055dba9265652742bdec701f96f879da6e6113ce81a416273b68720e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Security for amsc-iri-v2 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.