FilesΒΆ

Files operations on the HPC systems are performed through the /files endpoint.


All the requests reported below must be appended to the service endpoint:

https://bspsa.cineca.it

The allowed HPC string values are:

  • pizdaint
  • nsg

The allowed Project string values are:

  • bsp_pizdaint_01
  • bsp_nsg_01

The APIs allow to get a list of files related to a specific job and to download them individually.

URL: /files/(string: hpc)/(string: project_name)/(string: job_id)/(optional string: file_id)/

Required Headers:

  • Authorization:

    Authorization: Bearer <token>
    

Example:

  • Get the file list of a completed job on NSG system

    Example Request

    GET /files/nsg/bsp_nsg_01/NGBW-JOB-NEURON75_TG-018095E597064F9FBEC486ED29BD2138/    HTTP/1.1
    Authorization:              Bearer Token
    

    Example Response

    HTTP/1.1                    200 OK
    Content-Type:               application/json
    
    [
        {
            u'fileid':          u'29057',
            u'filename':        u'STDOUT',
            u'length':          u'244144'
        },
        {
            u'fileid':          u'29059',
            u'filename':        u'STDERR',
            u'length':          u'372'
        }
    ]
    
  • Download a file of a completed job on NSG system

    Example Request

    GET /files/nsg/bsp_nsg_01/NGBW-JOB-NEURON75_TG-018095E597064F9FBEC486ED29BD2138/29057/      HTTP/1.1
    Authorization:              Bearer Token
    

    Example Response

    HTTP/1.1                    200 OK
    Content-Type:               application/unknown
    
  • Get the file list of a completed job on CSCS-Pizdaint system

    Example Request

    GET /files/pizdaint/bsp_pizdaint_01/DBC6A573-9D99-4376-983C-9A3536CDD753/    HTTP/1.1
    Authorization:              Bearer Token
    

    Example Response

    HTTP/1.1                    200 OK
    Content-Type:               application/json
    
    [
        u'/UNICORE_Job_1552071365450',
        u'/stderr',
        u'/UNICORE_SCRIPT_EXIT_CODE',
        u'/stdout',
        u'/bss_submit_1552071365450'
    ]
    
  • Download a file of a completed job on CSCS-Pizdaint system

    Example Request

    GET /files/pizdaint/bsp_pizdaint_01/DBC6A573-9D99-4376-983C-9A3536CDD753/stdout/      HTTP/1.1
    Authorization:              Bearer Token
    

    Example Response

    HTTP/1.1                    200 OK
    Content-Type:               text/plain