Skip to main content

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

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)

Source distribution for amsc-iri-v2 1.0.0
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)

Table of built distributions (wheels) for amsc-iri-v2 1.0.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

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