Skip to main content

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

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

amsc_iri-2.0.0.tar.gz (73.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

amsc_iri-2.0.0-py3-none-any.whl (133.2 kB view details)

Uploaded Python 3

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

Hashes for amsc_iri-2.0.0.tar.gz
Algorithm Hash digest
SHA256 e1c99bfbfa00ee119b0e0604f7fb5fde4cbec65d11f47e43db4c6968fe63032b
MD5 559565f848edaf88ed42747b2160ef7d
BLAKE2b-256 9da15e9de3584b5c8f4dd412705e5ae1124d039e68d0880780cfdca50449f9cd

See more details on using hashes here.

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

Hashes for amsc_iri-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3f4aee0c3a514e4a22fc6a3df987b28e4a9733e89a9d9a1b61c029b39e6af4b1
MD5 5b69650d6aa305b0bc3c54c58b6c7451
BLAKE2b-256 51f9f4037773087dddd33f2bd468576739b8ac716261b25bf391d099e4b8bb9a

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 files

1.2.0

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page