Skip to content
Snippets Groups Projects
Commit e081e92a authored by Marek Chrastina's avatar Marek Chrastina
Browse files

test manual strict md docs.

parent fac5cd37
No related branches found
No related tags found
6 merge requests!368Update prace.md to document the change from qprace to qprod as the default...,!367Update prace.md to document the change from qprace to qprod as the default...,!366Update prace.md to document the change from qprace to qprod as the default...,!323extended-acls-storage-section,!196Master,!178Apidocs
<div class="document"> API Documentation<a href="#module-scs_api.server" class="headerlink" title="Permalink to this headline">¶</a>
=============================================================================================================
<div class="documentwrapper">
<div class="body" role="main">
<div id="module-scs_api.server" class="section">
[]{#api-documentation}
API Documentation[](#module-scs_api.server "Permalink to this headline"){.headerlink}
======================================================================================
Implements API for IT4I SCS Information System. Implements API for IT4I SCS Information System.
- api revision: `9eb0678f / 2017-12-08 11:06:12 +0100`{.docutils - api revision: `9eb0678f / 2017-12-08 11:06:12 +0100`
.literal} - api version: `0.9-11-g9eb0678`
- api version: `0.9-11-g9eb0678`{.docutils .literal} - apidoc building date: `2017-12-11 09:14:53 +0100`
- apidoc building date: `2017-12-08 16:05:36 +0100`{.docutils
.literal} Summary<a href="#summary" class="headerlink" title="Permalink to this headline">¶</a>
-------------------------------------------------------------------------------------
<div id="summary" class="section">
<table>
Summary[](#summary "Permalink to this headline"){.headerlink} <colgroup>
-------------------------------------------------------------- <col width="20%" />
<col width="40%" />
Resource Operation Description <col width="40%" />
------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ </colgroup>
account-expire [GET /api/v1/account-expire/(login)](#get--api-v1-account-expire-(login)){.reference .external} Account expiration date <thead>
accounts-to-close [GET /api/v1/accounts-to-close/(category)](#get--api-v1-accounts-to-close-(category)){.reference .external} Standard accounts close to expiration date <tr class="header">
check-access [POST /api/v1/check-access](#post--api-v1-check-access){.reference .external} Access check to queue <th>Resource</th>
dedicated-time [GET /api/v1/dedicated-time/(cluster\_type)](#get--api-v1-dedicated-time-(cluster_type)){.reference .external} HPC dedicated time <th>Operation</th>
graph\_affiliation\_stats [GET /api/v1/graph\_affiliation\_stats](#get--api-v1-graph_affiliation_stats){.reference .external} Graph affiliation statistics <th>Description</th>
graph\_research\_area\_stats [GET /api/v1/graph\_research\_area\_stats](#get--api-v1-graph_research_area_stats){.reference .external} Graph research area statistics </tr>
graph\_utilization\_stats [GET /api/v1/graph\_utilization\_stats](#get--api-v1-graph_utilization_stats){.reference .external} Graph utilization statistics </thead>
irregular-accounts-to-close [GET /api/v1/irregular-accounts-to-close](#get--api-v1-irregular-accounts-to-close){.reference .external} Special accounts close to expiration date <tbody>
it4ifree [POST /api/v1/it4ifree/(login)](#post--api-v1-it4ifree-(login)){.reference .external} Free account resources <tr class="odd">
it4ifreetoken [GET /api/v1/it4ifreetoken/(login)](#get--api-v1-it4ifreetoken-(login)){.reference .external} Free account token <td>account-expire</td>
motd [GET /api/v1/motd/(category)](#get--api-v1-motd-(category)){.reference .external} SCS messages of the day <td><a href="#get--api-v1-account-expire-(login)" class="reference external">GET /api/v1/account-expire/(login)</a></td>
ping [GET /api/v1/ping](#get--api-v1-ping){.reference .external} Connection test <td>Account expiration date</td>
quota-extra [GET /api/v1/quota-extra](#get--api-v1-quota-extra){.reference .external} User extra quota </tr>
version [GET /api/v1/version](#get--api-v1-version){.reference .external} API version <tr class="even">
<td>accounts-to-close</td>
</div> <td><a href="#get--api-v1-accounts-to-close-(category)" class="reference external">GET /api/v1/accounts-to-close/(category)</a></td>
<td>Standard accounts close to expiration date</td>
<div id="api-details" class="section"> </tr>
<tr class="odd">
API Details[](#api-details "Permalink to this headline"){.headerlink} <td>check-access</td>
---------------------------------------------------------------------- <td><a href="#post--api-v1-check-access" class="reference external">POST /api/v1/check-access</a></td>
<td>Access check to queue</td>
`GET `{.descname}`/api/v1/account-expire/`{.descname}[(]{.sig-paren}*login*[)]{.sig-paren}[](#get--api-v1-account-expire-(login) "Permalink to this definition"){.headerlink} </tr>
<tr class="even">
: Access to this service is restricted to just few source ipv4 <td>dedicated-time</td>
addresses. <td><a href="#get--api-v1-dedicated-time-(cluster_type)" class="reference external">GET /api/v1/dedicated-time/(cluster_type)</a></td>
<td>HPC dedicated time</td>
It returns the account expiration date. The account may participates </tr>
on several projects. If all projects were already finished, there <tr class="odd">
will come a time when the account expires as well. It will happen <td>graph_affiliation_stats</td>
after: <td><a href="#get--api-v1-graph_affiliation_stats" class="reference external">GET /api/v1/graph_affiliation_stats</a></td>
<td>Graph affiliation statistics</td>
> <div> </tr>
> <tr class="even">
> - 365 days - for all standard accounts <td>graph_research_area_stats</td>
> - 31 days - for special (e.g. training) accounts <td><a href="#get--api-v1-graph_research_area_stats" class="reference external">GET /api/v1/graph_research_area_stats</a></td>
> <td>Graph research area statistics</td>
> </div> </tr>
<tr class="odd">
Query Parameters: <td>graph_utilization_stats</td>
<td><a href="#get--api-v1-graph_utilization_stats" class="reference external">GET /api/v1/graph_utilization_stats</a></td>
<td>Graph utilization statistics</td>
</tr>
- **login** – account id <tr class="even">
<td>irregular-accounts-to-close</td>
Status Codes: <td><a href="#get--api-v1-irregular-accounts-to-close" class="reference external">GET /api/v1/irregular-accounts-to-close</a></td>
<td>Special accounts close to expiration date</td>
- [200 </tr>
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference <tr class="odd">
.external} – no error <td>it4ifree</td>
- [405 Method Not <td><a href="#post--api-v1-it4ifree-(login)" class="reference external">POST /api/v1/it4ifree/(login)</a></td>
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference <td>Free account resources</td>
.external} – restricted access, your ipv4 is not allowed </tr>
<tr class="even">
**Example request**: <td>it4ifreetoken</td>
<td><a href="#get--api-v1-it4ifreetoken-(login)" class="reference external">GET /api/v1/it4ifreetoken/(login)</a></td>
<div class="highlight-console"> <td>Free account token</td>
</tr>
<div class="highlight"> <tr class="odd">
<td>motd</td>
curl -i https://scs.it4i.cz/api/v1/account-expire/chr0139 <td><a href="#get--api-v1-motd-(category)" class="reference external">GET /api/v1/motd/(category)</a></td>
<td>SCS messages of the day</td>
</div> </tr>
<tr class="even">
</div> <td>ping</td>
<td><a href="#get--api-v1-ping" class="reference external">GET /api/v1/ping</a></td>
**Example response**: <td>Connection test</td>
</tr>
<div class="highlight-http"> <tr class="odd">
<td>quota-extra</td>
<div class="highlight"> <td><a href="#get--api-v1-quota-extra" class="reference external">GET /api/v1/quota-extra</a></td>
<td>User extra quota</td>
HTTP/1.1 200 OK </tr>
Content-Type: application/json <tr class="even">
<td>version</td>
[ <td><a href="#get--api-v1-version" class="reference external">GET /api/v1/version</a></td>
{ <td>API version</td>
"login": "chr0139", </tr>
"projectendtime": "2019-07-25 21:59:59" </tbody>
} </table>
]
API Details<a href="#api-details" class="headerlink" title="Permalink to this headline">¶</a>
</div> ---------------------------------------------------------------------------------------------
</div> `GET /api/v1/account-expire/`<span class="sig-paren">(</span>*login*<span class="sig-paren">)</span><a href="#get--api-v1-account-expire-(login)" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
It returns the account expiration date. The account may participates on
several projects. If all projects were already finished, there will come
a time when the account expires as well. It will happen after:
- 365 days - for all standard accounts
- 31 days - for special (e.g. training) accounts
Query Parameters:
- **login** – account id
Status Codes:
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– restricted access, your ipv4 is not allowed
**Example request**:
curl -i https://scs.it4i.cz/api/v1/account-expire/chr0139
**Example response**:
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"login": "chr0139",
"projectendtime": "2019-07-25 21:59:59"
}
]
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/accounts-to-close/`{.descname}[(]{.sig-paren}*category*[)]{.sig-paren}[](#get--api-v1-accounts-to-close-(category) "Permalink to this definition"){.headerlink} `GET /api/v1/accounts-to-close/`<span class="sig-paren">(</span>*category*<span class="sig-paren">)</span><a href="#get--api-v1-accounts-to-close-(category)" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Access to this service is restricted to just few source ipv4
addresses.
The standard account expires 365 days after the date when the last
project was finished. This service returns the list of standard
accounts which are close to the expiration date. The closeness time
interval depends on requested parameter.
Query Parameters:
- **first** – 93±2 days before expiration date The standard account expires 365 days after the date when the last
- **second** – 31±2 days before expiration date project was finished. This service returns the list of standard accounts
- **third** – 7±2 days before expiration date which are close to the expiration date. The closeness time interval
depends on requested parameter.
Response JSON Object: Query Parameters:
- **fullname** (*string*) – user full name - **first** – 93±2 days before expiration date
- **login** (*string*) – account id - **second** – 31±2 days before expiration date
- **projectendtime** (*string*) – project end date - **third** – 7±2 days before expiration date
- **userclosetime** (*string*) – project end date shifted by
272/334/358 days
Status Codes: Response JSON Object:
- [200
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 address is not allowed
**Example request**: - **fullname** (*string*) – user full name
- **login** (*string*) – account id
- **projectendtime** (*string*) – project end date
- **userclosetime** (*string*) – project end date shifted by
272/334/358 days
<div class="highlight-console"> Status Codes:
<div class="highlight"> - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– restricted access, your ipv4 address is not allowed
curl -i https://scs.it4i.cz/api/v1/accounts-to-close/second **Example request**:
</div> curl -i https://scs.it4i.cz/api/v1/accounts-to-close/second
</div> **Example response**:
**Example response**:
<div class="highlight-http">
<div class="highlight">
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"fullname": "Smith John",
"login": "johnsm",
"projectendtime": "2017-01-08 22:59:59",
"userclosetime": "2017-11-09 22:59:59"
}
]
</div> HTTP/1.1 200 OK
Content-Type: application/json
</div> [
{
"fullname": "Smith John",
"login": "johnsm",
"projectendtime": "2017-01-08 22:59:59",
"userclosetime": "2017-11-09 22:59:59"
}
]
<!-- --> <!-- -->
`POST `{.descname}`/api/v1/check-access`{.descname}[](#post--api-v1-check-access "Permalink to this definition"){.headerlink} `POST /api/v1/check-access`<a href="#post--api-v1-check-access" class="headerlink" title="Permalink to this definition"></a>
A service to check if account and/or related project has the access to
: A service to check if account and/or related project has the access specified queue.
to specified queue.
Request JSON Object:
- **login** (*string*) – account id
- **queue** (*string*) – queue id
- **pid** (*string*) – project id, not required if querying
projectless queue
Status Codes:
- [200
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
**Example request**:
<div class="highlight-console"> Request JSON Object:
<div class="highlight">
curl -i -H "Content-Type:application/json" -X POST \ - **login** (*string*) – account id
--data '{"pid":"DD-13-5","login":"johnsm","queue":"qfat"}' \ - **queue** (*string*) – queue id
https://scs.it4i.cz/api/v1/check-access - **pid** (*string*) – project id, not required if querying
projectless queue
</div> Status Codes:
</div> - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
**Example response**: **Example request**:
<div class="highlight-http"> curl -i -H "Content-Type:application/json" -X POST \
--data '{"pid":"DD-13-5","login":"johnsm","queue":"qfat"}' \
https://scs.it4i.cz/api/v1/check-access
<div class="highlight"> **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
"OK Access granted for regular queue." "OK Access granted for regular queue."
</div>
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/dedicated-time/`{.descname}[(]{.sig-paren}*cluster\_type*[)]{.sig-paren}[](#get--api-v1-dedicated-time-(cluster_type) "Permalink to this definition"){.headerlink} `GET /api/v1/dedicated-time/`<span class="sig-paren">(</span>*cluster\_type*<span class="sig-paren">)</span><a href="#get--api-v1-dedicated-time-(cluster_type)" class="headerlink" title="Permalink to this definition"></a>
Returns list of times dedicated for HPC maintainance. It is not possible
: Returns list of times dedicated for HPC maintainance. It is not to use HPC services during maintainance.
possible to use HPC services during maintainance.
Query Parameters:
- **all** – returns all dedicated times for all clusters
- **salomon** – returns all times just for salomon cluster
- **anselm** – returns all times just for anselm cluster
- **active** – returns dedicated times for all clusters which are
now active
- **planned** – returns dedicated times for all clusters which are
now active or scheduled in the future
Status Codes:
- [200 Query Parameters:
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – invalid requested query parameter
**Example request**:
<div class="highlight-console"> - **all** – returns all dedicated times for all clusters
- **salomon** – returns all times just for salomon cluster
- **anselm** – returns all times just for anselm cluster
- **active** – returns dedicated times for all clusters which are now
active
- **planned** – returns dedicated times for all clusters which are now
active or scheduled in the future
<div class="highlight"> Status Codes:
curl -i curl https://scs.it4i.cz/api/v1/dedicated-time/all - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– invalid requested query parameter
</div> **Example request**:
</div> curl -i curl https://scs.it4i.cz/api/v1/dedicated-time/all
**Example response**: **Example response**:
<div class="highlight-http"> HTTP/1.1 200 OK
Content-Type: application/json
<div class="highlight"> [
{
HTTP/1.1 200 OK "cluster_type": "salomon",
Content-Type: application/json "dateEfficiency": "2017-11-21 09:45:00",
"dateExpiration": "2017-11-21 23:59:00",
[ "updated_at": "2017-11-21 09:45:00"
{ }
"cluster_type": "salomon", ]
"dateEfficiency": "2017-11-21 09:45:00",
"dateExpiration": "2017-11-21 23:59:00",
"updated_at": "2017-11-21 09:45:00"
}
]
</div>
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/graph_affiliation_stats`{.descname}[](#get--api-v1-graph_affiliation_stats "Permalink to this definition"){.headerlink} `GET /api/v1/graph_affiliation_stats`<a href="#get--api-v1-graph_affiliation_stats" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Access to this service is restricted to just few source ipv4
addresses. It returns graph data useful to plot statistics of using HPC by some
affiliations.
It returns graph data useful to plot statistics of using HPC by some
affiliations. Query Parameters:
Query Parameters:
- **height** – optional, graph height in pixels, default 300
- **width** – optional, graph width in pixels, default 420
- **height** – optional, graph height in pixels, default 300 - **sizepct** – optional, graph size in percents, default 40
- **width** – optional, graph width in pixels, default 420
- **sizepct** – optional, graph size in percents, default 40 Status Codes:
Status Codes: - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- [200 - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference – restricted access, your ipv4 address is not allowed
.external} – no error
- [405 Method Not **Example request**:
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 address is not allowed curl -i -X GET --data height=50 -d sizepct=50 \
-G https://scs.it4i.cz/api/v1/graph_affiliation_stats
**Example request**:
**Example response**:
<div class="highlight-console">
HTTP/1.1 200 OK
<div class="highlight"> Content-Type: application/json
curl -i -X GET --data height=50 -d sizepct=50 \ "
-G https://scs.it4i.cz/api/v1/graph_affiliation_stats {
chart: {
</div> plotBackgroundColor: null,
plotBorderWidth: null,
</div> plotShadow: false,
height: 50,
**Example response**: width: 420,
},
<div class="highlight-http"> credits: {
text: 'IT4Innovations 2017-11-14 13:21'
<div class="highlight"> },
title: {
HTTP/1.1 200 OK text: ''
Content-Type: application/json },
exporting: {
" enabled: false
},
tooltip: {
pointFormat: '{point.percentage:.1f} %'
},
plotOptions: {
pie: {
allowPointSelect: true,
cursor: 'pointer',
size: '50%',
startAngle: 315,
dataLabels: {
enabled: true,
format: '{point.name}',
}
}
},
series: [
{ {
chart: { type: 'pie',
plotBackgroundColor: null, data: [
plotBorderWidth: null, ['IT4Innovations', 143320459.886 ],
plotShadow: false, ['Akademie věd ČR', 67329442.8672 ],
height: 50, ['CEITEC', 41987818.0711 ],
width: 420, ['Masarykova univerzita', 22767491.1453 ],
}, ['VUT Brno', 18184662.5402 ],
credits: { ['Univerzita Karlova', 15544836.8455 ],
text: 'IT4Innovations 2017-11-14 13:21' ['ČVUT', 12383341.426 ],
}, ['Matematicko-fyzikální fakulta', 4583152.32333 ],
title: { ['Uppsala University', 4562701.04 ],
text: '' ['Others', 36525837.5894 ],
},
exporting: {
enabled: false
},
tooltip: {
pointFormat: '{point.percentage:.1f} %'
},
plotOptions: {
pie: {
allowPointSelect: true,
cursor: 'pointer',
size: '50%',
startAngle: 315,
dataLabels: {
enabled: true,
format: '{point.name}',
}
}
},
series: [
{
type: 'pie',
data: [
['IT4Innovations', 143320459.886 ],
['Akademie věd ČR', 67329442.8672 ],
['CEITEC', 41987818.0711 ],
['Masarykova univerzita', 22767491.1453 ],
['VUT Brno', 18184662.5402 ],
['Univerzita Karlova', 15544836.8455 ],
['ČVUT', 12383341.426 ],
['Matematicko-fyzikální fakulta', 4583152.32333 ],
['Uppsala University', 4562701.04 ],
['Others', 36525837.5894 ],
]
}
] ]
} }
" ]
}
</div> "
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/graph_research_area_stats`{.descname}[](#get--api-v1-graph_research_area_stats "Permalink to this definition"){.headerlink} `GET /api/v1/graph_research_area_stats`<a href="#get--api-v1-graph_research_area_stats" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Access to this service is restricted to just few source ipv4
addresses. It returns graph data useful to plot statistics of using HPC by various
science fields.
It returns graph data useful to plot statistics of using HPC by
various science fields. Query Parameters:
Query Parameters:
- **height** – optional, graph height in pixels, default 300
- **width** – optional, graph width in pixels, default 420
- **height** – optional, graph height in pixels, default 300 - **sizepct** – optional, graph size in percents, default 40
- **width** – optional, graph width in pixels, default 420
- **sizepct** – optional, graph size in percents, default 40 Status Codes:
Status Codes: - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- [200 - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference – restricted access, your ipv4 address is not allowed
.external} – no error
- [405 Method Not **Example request**:
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 address is not allowed curl -i -X GET -G https://scs.it4i.cz/api/v1/graph_research_area_stats
**Example request**: **Example response**:
<div class="highlight-console"> HTTP/1.1 200 OK
Content-Type: application/json
<div class="highlight">
"
curl -i -X GET -G https://scs.it4i.cz/api/v1/graph_research_area_stats {
chart: {
</div> plotBackgroundColor: null,
plotBorderWidth: null,
</div> plotShadow: false,
height: 300,
**Example response**: width: 420,
},
<div class="highlight-http"> credits: {
text: 'IT4Innovations 2017-11-14 13:43'
<div class="highlight"> },
title: {
HTTP/1.1 200 OK text: ''
Content-Type: application/json },
exporting: {
" enabled: false
},
tooltip: {
pointFormat: '{point.percentage:.1f} %'
},
plotOptions: {
pie: {
allowPointSelect: true,
cursor: 'pointer',
size: '40%',
startAngle: 315,
dataLabels: {
enabled: true,
format: '{point.name}',
}
}
},
series: [
{ {
chart: { type: 'pie',
plotBackgroundColor: null, data: [
plotBorderWidth: null, ['Materials Science ', 205656805 ],
plotShadow: false, ['Bio Sciences ', 65319185 ],
height: 300, ['Plasma & Particle Physics ', 21935334 ],
width: 420, ['Service', 20537970 ],
}, ['Engineering ', 15691906 ],
credits: { ['Informatics', 12335969 ],
text: 'IT4Innovations 2017-11-14 13:43' ['Applied Mathematics', 9458711 ],
}, ['Earth Sciences ', 8804183 ],
title: { ['Astro Sciences ', 4229242 ],
text: '' ['Other Research Areas', 2493851 ],
},
exporting: {
enabled: false
},
tooltip: {
pointFormat: '{point.percentage:.1f} %'
},
plotOptions: {
pie: {
allowPointSelect: true,
cursor: 'pointer',
size: '40%',
startAngle: 315,
dataLabels: {
enabled: true,
format: '{point.name}',
}
}
},
series: [
{
type: 'pie',
data: [
['Materials Science ', 205656805 ],
['Bio Sciences ', 65319185 ],
['Plasma & Particle Physics ', 21935334 ],
['Service', 20537970 ],
['Engineering ', 15691906 ],
['Informatics', 12335969 ],
['Applied Mathematics', 9458711 ],
['Earth Sciences ', 8804183 ],
['Astro Sciences ', 4229242 ],
['Other Research Areas', 2493851 ],
]
}
] ]
} }
" ]
}
</div> "
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/graph_utilization_stats`{.descname}[](#get--api-v1-graph_utilization_stats "Permalink to this definition"){.headerlink} `GET /api/v1/graph_utilization_stats`<a href="#get--api-v1-graph_utilization_stats" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Access to this service is restricted to just few source ipv4
addresses.
It returns graph data to plot statistics of HPC week utilization
during last 100 days.
Query Parameters: It returns graph data to plot statistics of HPC week utilization during
last 100 days.
Query Parameters:
- **height** – optional, graph height in pixels, default 300
- **width** – optional, graph width in pixels, default 420
- **sizepct** – optional, graph size in percents, default 40
Status Codes: - **height** – optional, graph height in pixels, default 300
- **width** – optional, graph width in pixels, default 420
- **sizepct** – optional, graph size in percents, default 40
- [200 Status Codes:
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 address is not allowed
**Example request**: - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– restricted access, your ipv4 address is not allowed
<div class="highlight-console"> **Example request**:
<div class="highlight"> curl -i -X GET -G https://scs.it4i.cz/api/v1/graph_utilization_stats
curl -i -X GET -G https://scs.it4i.cz/api/v1/graph_utilization_stats **Example response**:
</div> HTTP/1.1 200 OK
Content-Type: application/json
</div> "
{
**Example response**: chart: {
zoomType: 'x',
<div class="highlight-http"> plotBorderWidth: 0,
borderWidth: 0,
<div class="highlight"> borderRadius: 0,
borderColor: '#DDDDDD',
HTTP/1.1 200 OK height: 300,
Content-Type: application/json width: 420
},
" series: [
{ {
chart: { name: 'Cores utilized',
zoomType: 'x', type: 'areaspline',
plotBorderWidth: 0, data: [
borderWidth: 0, [ Date.UTC(2017,7,6), 18466],
borderRadius: 0, [ Date.UTC(2017,7,7), 18606],
borderColor: '#DDDDDD', [ Date.UTC(2017,7,8), 19075],
height: 300, [ Date.UTC(2017,7,9), 19962],
width: 420 [ Date.UTC(2017,7,10), 20239],
}, [ Date.UTC(2017,7,11), 20425],
series: [ [ Date.UTC(2017,7,12), 20110],
{ [ Date.UTC(2017,7,13), 19413],
name: 'Cores utilized', [ Date.UTC(2017,7,14), 20204],
type: 'areaspline', [ Date.UTC(2017,7,15), 20058],
data: [ [ Date.UTC(2017,7,16), 19890],
[ Date.UTC(2017,7,6), 18466], [ Date.UTC(2017,7,17), 18102],
[ Date.UTC(2017,7,7), 18606], [ Date.UTC(2017,7,18), 18529],
[ Date.UTC(2017,7,8), 19075], [ Date.UTC(2017,7,19), 18871],
[ Date.UTC(2017,7,9), 19962], [ Date.UTC(2017,7,20), 18704],
[ Date.UTC(2017,7,10), 20239], [ Date.UTC(2017,7,21), 17106],
[ Date.UTC(2017,7,11), 20425], [ Date.UTC(2017,7,22), 17854],
[ Date.UTC(2017,7,12), 20110], [ Date.UTC(2017,7,23), 19541],
[ Date.UTC(2017,7,13), 19413], [ Date.UTC(2017,7,24), 19691],
[ Date.UTC(2017,7,14), 20204], [ Date.UTC(2017,7,25), 19335],
[ Date.UTC(2017,7,15), 20058], [ Date.UTC(2017,7,26), 20776],
[ Date.UTC(2017,7,16), 19890], [ Date.UTC(2017,7,27), 20856],
[ Date.UTC(2017,7,17), 18102], [ Date.UTC(2017,7,28), 21116],
[ Date.UTC(2017,7,18), 18529], [ Date.UTC(2017,7,29), 21705],
[ Date.UTC(2017,7,19), 18871], [ Date.UTC(2017,7,30), 17907],
[ Date.UTC(2017,7,20), 18704], [ Date.UTC(2017,7,31), 18085],
[ Date.UTC(2017,7,21), 17106], [ Date.UTC(2017,8,1), 18564],
[ Date.UTC(2017,7,22), 17854], [ Date.UTC(2017,8,2), 17449],
[ Date.UTC(2017,7,23), 19541], [ Date.UTC(2017,8,3), 17472],
[ Date.UTC(2017,7,24), 19691], [ Date.UTC(2017,8,4), 17173],
[ Date.UTC(2017,7,25), 19335], [ Date.UTC(2017,8,5), 14445],
[ Date.UTC(2017,7,26), 20776], [ Date.UTC(2017,8,6), 17952],
[ Date.UTC(2017,7,27), 20856], [ Date.UTC(2017,8,7), 18813],
[ Date.UTC(2017,7,28), 21116], [ Date.UTC(2017,8,8), 17847],
[ Date.UTC(2017,7,29), 21705], [ Date.UTC(2017,8,9), 16434],
[ Date.UTC(2017,7,30), 17907], [ Date.UTC(2017,8,10), 14957],
[ Date.UTC(2017,7,31), 18085], [ Date.UTC(2017,8,11), 15695],
[ Date.UTC(2017,8,1), 18564], [ Date.UTC(2017,8,12), 15495],
[ Date.UTC(2017,8,2), 17449], [ Date.UTC(2017,8,13), 11848],
[ Date.UTC(2017,8,3), 17472], [ Date.UTC(2017,8,14), 9612],
[ Date.UTC(2017,8,4), 17173], [ Date.UTC(2017,8,15), 9765],
[ Date.UTC(2017,8,5), 14445], [ Date.UTC(2017,8,16), 11730],
[ Date.UTC(2017,8,6), 17952], [ Date.UTC(2017,8,17), 12932],
[ Date.UTC(2017,8,7), 18813], [ Date.UTC(2017,8,18), 12296],
[ Date.UTC(2017,8,8), 17847], [ Date.UTC(2017,8,19), 11230],
[ Date.UTC(2017,8,9), 16434],
[ Date.UTC(2017,8,10), 14957],
[ Date.UTC(2017,8,11), 15695],
[ Date.UTC(2017,8,12), 15495],
[ Date.UTC(2017,8,13), 11848],
[ Date.UTC(2017,8,14), 9612],
[ Date.UTC(2017,8,15), 9765],
[ Date.UTC(2017,8,16), 11730],
[ Date.UTC(2017,8,17), 12932],
[ Date.UTC(2017,8,18), 12296],
[ Date.UTC(2017,8,19), 11230],
],
color: '#AA4643'
}
], ],
title: { color: '#AA4643'
text: '' }
}, ],
credits: { title: {
text: 'IT4Innovations 2017-11-14 14:14' text: ''
}, },
exporting: { credits: {
text: 'IT4Innovations 2017-11-14 14:14'
},
exporting: {
enabled: false
},
plotOptions: {
areaspline: {
fillOpacity: 0.5
},
pie: {
dataLabels: {
enabled: false enabled: false
}, },
plotOptions: { showInLegend: true
areaspline: { },
fillOpacity: 0.5 series: {
}, turboThreshold: 0
pie: { },
dataLabels: { line: {
enabled: false marker: {
}, enabled: false
showInLegend: true }
},
series: {
turboThreshold: 0
},
line: {
marker: {
enabled: false
}
}
},
xAxis: {
type: 'datetime',
title: {
text: 'Date',
style: {
color: '#000000'
}
}
},
yAxis: {
min: 0,
tickInterval: 1000,
title: {
text: 'Cores [-]',
style: {
color: '#000000'
}
}
},
} }
" },
xAxis: {
</div> type: 'datetime',
title: {
</div> text: 'Date',
style: {
color: '#000000'
}
}
},
yAxis: {
min: 0,
tickInterval: 1000,
title: {
text: 'Cores [-]',
style: {
color: '#000000'
}
}
},
}
"
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/irregular-accounts-to-close`{.descname}[](#get--api-v1-irregular-accounts-to-close "Permalink to this definition"){.headerlink} `GET /api/v1/irregular-accounts-to-close`<a href="#get--api-v1-irregular-accounts-to-close" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Access to this service is restricted to just few source ipv4
addresses.
The special (e.g. training) account expires 31 days after the date
when the last project was finished. This service returns the list of
special accounts which are already after this the expiration date.
Response JSON Object:
The special (e.g. training) account expires 31 days after the date when
the last project was finished. This service returns the list of special
accounts which are already after this the expiration date.
- **login** (*string*) – account id Response JSON Object:
- **projectendtime** (*string*) – project end date
Status Codes:
- [200 - **login** (*string*) – account id
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference - **projectendtime** (*string*) – project end date
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 address is not allowed
**Example request**: Status Codes:
<div class="highlight-console"> - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– restricted access, your ipv4 address is not allowed
<div class="highlight"> **Example request**:
curl -i https://scs.it4i.cz/api/v1/irregular-accounts-to-close curl -i https://scs.it4i.cz/api/v1/irregular-accounts-to-close
</div> **Example response**:
</div> HTTP/1.1 200 OK
Content-Type: application/json
**Example response**: [
{
<div class="highlight-http"> "login": "dd-01",
"projectendtime": "2009-09-19 23:59:59"
<div class="highlight"> }
]
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"login": "dd-01",
"projectendtime": "2009-09-19 23:59:59"
}
]
</div>
</div>
<!-- --> <!-- -->
`POST `{.descname}`/api/v1/it4ifree/`{.descname}[(]{.sig-paren}*login*[)]{.sig-paren}[](#post--api-v1-it4ifree-(login) "Permalink to this definition"){.headerlink} `POST /api/v1/it4ifree/`<span class="sig-paren">(</span>*login*<span class="sig-paren">)</span><a href="#post--api-v1-it4ifree-(login)" class="headerlink" title="Permalink to this definition"></a>
A service to check resources of the projects on which the account
: A service to check resources of the projects on which the account participate. If the calculation run on 1 cpu core during 1 hour, it
participate. If the calculation run on 1 cpu core during 1 hour, it consumes 1 core-hour from the project resources. However, some
consumes 1 core-hour from the project resources. However, some calculations (or their placement) can be cheaper. Actual consumed
calculations (or their placement) can be cheaper. Actual consumed core-hours are reduced by a cheaping factor and then deduct from the
core-hours are reduced by a cheaping factor and then deduct from the project resources. See
project resources. See <a href="https://docs.it4i.cz/salomon/resources-allocation-policy/#normalized-core-hours-nch" class="uri" class="reference external">https://docs.it4i.cz/salomon/resources-allocation-policy/#normalized-core-hours-nch</a>
<https://docs.it4i.cz/salomon/resources-allocation-policy/#normalized-core-hours-nch> for more details about so-called normalized core-hours. The json
for more details about so-called normalized core-hours. The json response contains two parts:
response contains two parts:
> <div>
>
> - `me`{.docutils .literal} – data from projects, where the
> account has access
> - `me_as_pi`{.docutils .literal} – data from projects, where the
> account is PI (primary investigator)
>
> </div>
Request JSON Object:
- **login** (*string*) – account id
- **it4ifreetoken** (*string*) – token
Response JSON Object:
- `me` – data from projects, where the account has access
- `me_as_pi` – data from projects, where the account is PI (primary
investigator)
- **login** (*string*) – account id Request JSON Object:
- **pid** (*string*) – project id
- **pi\_login** (*string*) – account id which is PI
- **days\_left** (*string*) – days to the end of project,
`---`{.docutils .literal} if project is inactive or not yet
started
- **free** (*int*) – free core-hours which can be still consumed
- **total** (*int*) – total core-hours assigned to the project
- **used** (*int*) – actual consumed core-hours
- **used\_with\_factor** (*int*) – consumed normalized core-hours
- **used\_by\_me** (*int*) – core-hours consumed by the account
- **used\_by\_me\_with\_factor** (*int*) – normalized core-hours
consumed by the account
- **corehours** (*int*) – core-hours consumed by the account
- **core\_hours\_with\_factor** (*int*) – normalized core-hours
consumed by the account
Status Codes:
- [200 - **login** (*string*) – account id
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference - **it4ifreetoken** (*string*) – token
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – token does not match
**Example request**: Response JSON Object:
<div class="highlight-console">
<div class="highlight"> - **login** (*string*) – account id
- **pid** (*string*) – project id
- **pi\_login** (*string*) – account id which is PI
- **days\_left** (*string*) – days to the end of project, `---` if
project is inactive or not yet started
- **free** (*int*) – free core-hours which can be still consumed
- **total** (*int*) – total core-hours assigned to the project
- **used** (*int*) – actual consumed core-hours
- **used\_with\_factor** (*int*) – consumed normalized core-hours
- **used\_by\_me** (*int*) – core-hours consumed by the account
- **used\_by\_me\_with\_factor** (*int*) – normalized core-hours
consumed by the account
- **corehours** (*int*) – core-hours consumed by the account
- **core\_hours\_with\_factor** (*int*) – normalized core-hours
consumed by the account
curl -i -H "Content-Type:application/json" -X POST \ Status Codes:
--data '{"login":"johnsm", "it4ifreetoken": "abc"}' \
https://scs.it4i.cz/api/v1/it4ifree/johnsm
</div> - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– token does not match
</div> **Example request**:
**Example response**: curl -i -H "Content-Type:application/json" -X POST \
--data '{"login":"johnsm", "it4ifreetoken": "abc"}' \
https://scs.it4i.cz/api/v1/it4ifree/johnsm
<div class="highlight-http"> **Example response**:
<div class="highlight"> HTTP/1.1 200 OK
Content-Type: application/json
HTTP/1.1 200 OK
Content-Type: application/json
{
"me": [
{ {
"me": [ "days_left": "---",
{ "free": 17124,
"days_left": "---", "login": "johnsm",
"free": 17124, "pid": "DD-13-6",
"login": "johnsm", "total": 100000,
"pid": "DD-13-6", "used": 82876,
"total": 100000, "used_by_me": 0,
"used": 82876, "used_by_me_with_factor": 0,
"used_by_me": 0, "used_with_factor":82876
"used_by_me_with_factor": 0, },
"used_with_factor":82876 {
}, "days_left": "---",
{ "free": 0,
"days_left": "---", "login": "johnsm",
"free": 0, "pid": "DD-14-12",
"login": "johnsm", "total": 1000,
"pid": "DD-14-12", "used": 8641,
"total": 1000, "used_by_me": 0,
"used": 8641, "used_by_me_with_factor": 0,
"used_by_me": 0, "used_with_factor": 8641
"used_by_me_with_factor": 0,
"used_with_factor": 8641
}
],
"me_as_pi": [
{
"core_hours": 82876,
"core_hours_with_factor": 82876,
"login":"abc",
"pi_login": "johnsm",
"pid": "DD-13-6"
},
{
"core_hours": 0,
"core_hours_with_factor": 0,
"login": "johnsm",
"pi_login": "johnsm",
"pid":"DD-13-6"
}
]
} }
],
</div> "me_as_pi": [
{
</div> "core_hours": 82876,
"core_hours_with_factor": 82876,
<!-- --> "login":"abc",
"pi_login": "johnsm",
`GET `{.descname}`/api/v1/it4ifreetoken/`{.descname}[(]{.sig-paren}*login*[)]{.sig-paren}[](#get--api-v1-it4ifreetoken-(login) "Permalink to this definition"){.headerlink} "pid": "DD-13-6"
},
: Access to this service is restricted to just few source ipv4
addresses.
It returns free token for the account.
Query Parameters:
- **login** – account id
Status Codes:
- [200
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 address is not allowed
**Example request**:
<div class="highlight-console">
<div class="highlight">
curl -i https://scs.it4i.cz/api/v1/it4ifreetoken/johnsm
</div>
</div>
**Example response**:
<div class="highlight-http">
<div class="highlight">
HTTP/1.1 200 OK
Content-Type: application/json
{ {
"it4ifreetoken": "abc" "core_hours": 0,
"core_hours_with_factor": 0,
"login": "johnsm",
"pi_login": "johnsm",
"pid":"DD-13-6"
} }
]
</div> }
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/motd/`{.descname}[(]{.sig-paren}*category*[)]{.sig-paren}[](#get--api-v1-motd-(category) "Permalink to this definition"){.headerlink} `GET /api/v1/it4ifreetoken/`<span class="sig-paren">(</span>*login*<span class="sig-paren">)</span><a href="#get--api-v1-it4ifreetoken-(login)" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Returns SCS messages of the day.
Query Parameters:
It returns free token for the account.
- **notice** – returns only notice messages Query Parameters:
- **important** – returns only important messages
- **all** – returns all messages
Status Codes:
- [200 - **login** – account id
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – invalid requested query parameter
**Example request**: Status Codes:
<div class="highlight-console"> - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– restricted access, your ipv4 address is not allowed
<div class="highlight"> **Example request**:
curl -i https://scs.it4i.cz/api/v1/motd/notice curl -i https://scs.it4i.cz/api/v1/it4ifreetoken/johnsm
</div> **Example response**:
</div> HTTP/1.1 200 OK
Content-Type: application/json
**Example response**: {
"it4ifreetoken": "abc"
<div class="highlight-http"> }
<div class="highlight">
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"author": "svi47",
"category": "notice",
"created_at": "2017-10-12 11:44:51",
"dateEfficiency": "2017-10-12 11:41:00",
"dateExpiration": "2017-11-28 14:30:00",
"dateModification": "2017-10-12 13:44:51",
"deleted_at": null,
"id": 169,
"messageBody": "For more information about the course,
please visit its web page: https://goo.gl/cvFsFH",
"state": null,
"title": "Invitation to the Course Productivity Tools
for High Performance Computing (2017-11-27 to 2017-11-28)",
"typeMotd": null,
"updated_at": "2017-10-12 11:44:51"
}
]
</div>
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/ping`{.descname}[](#get--api-v1-ping "Permalink to this definition"){.headerlink} `GET /api/v1/motd/`<span class="sig-paren">(</span>*category*<span class="sig-paren">)</span><a href="#get--api-v1-motd-(category)" class="headerlink" title="Permalink to this definition"></a>
Returns SCS messages of the day.
: A service for testing connection to API.
--------------- -----------------------------------------------------------------------------------------------------------------
Status Codes: - [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference .external} – no error
--------------- -----------------------------------------------------------------------------------------------------------------
**Example request**: Query Parameters:
<div class="highlight-console">
<div class="highlight"> - **notice** – returns only notice messages
- **important** – returns only important messages
- **all** – returns all messages
curl -i https://scs.it4i.cz/api/v1/ping Status Codes:
</div> - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– invalid requested query parameter
</div> **Example request**:
**Example response**: curl -i https://scs.it4i.cz/api/v1/motd/notice
<div class="highlight-http"> **Example response**:
<div class="highlight"> HTTP/1.1 200 OK
Content-Type: application/json
HTTP/1.1 200 OK [
Content-Type: application/json {
"author": "svi47",
{ "category": "notice",
"message": "pong" "created_at": "2017-10-12 11:44:51",
} "dateEfficiency": "2017-10-12 11:41:00",
"dateExpiration": "2017-11-28 14:30:00",
</div> "dateModification": "2017-10-12 13:44:51",
"deleted_at": null,
</div> "id": 169,
"messageBody": "For more information about the course,
please visit its web page: https://goo.gl/cvFsFH",
"state": null,
"title": "Invitation to the Course Productivity Tools
for High Performance Computing (2017-11-27 to 2017-11-28)",
"typeMotd": null,
"updated_at": "2017-10-12 11:44:51"
}
]
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/quota-extra`{.descname}[](#get--api-v1-quota-extra "Permalink to this definition"){.headerlink} `GET /api/v1/ping`<a href="#get--api-v1-ping" class="headerlink" title="Permalink to this definition"></a>
A service for testing connection to API.
: Access to this service is restricted to just few source ipv4
addresses.
Returns all accounts which have active filesystem quotas bigger than
standard.
Response JSON Object:
- **login** (*string*) – account id
- **system\_name** (*string*) – computer system name
- **filesystem** (*string*) – folder name
- **quota\_gb** (*int*) – disk usage quota for in GB
- **quota\_ki** (*int*) – quota for number of files in thousands
- **expiration** (*string*) – expiration date
- **description** (*string*) – reason for allocation extra quotas
Status Codes:
- [200
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference
.external} – no error
- [405 Method Not
Allowed](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6){.reference
.external} – restricted access, your ipv4 is not allowed
**Example request**:
<div class="highlight-console">
<div class="highlight">
curl -i curl https://scs.it4i.cz/api/v1/quota-extra <table>
<tbody>
<tr class="odd">
<td>Status Codes:</td>
<td><ul>
<li><a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a> – no error</li>
</ul></td>
</tr>
</tbody>
</table>
</div> **Example request**:
</div> curl -i https://scs.it4i.cz/api/v1/ping
**Example response**: **Example response**:
<div class="highlight-http"> HTTP/1.1 200 OK
Content-Type: application/json
<div class="highlight"> {
"message": "pong"
HTTP/1.1 200 OK }
Content-Type: application/json
[
{
"login": "johnsm",
"system_name": "anselm",
"filesystem": "HOME",
"quota_gb": 500,
"quota_ki": 1500,
"expiration": "2017-12-31",
"description": "build SW"
}
]
</div>
</div>
<!-- --> <!-- -->
`GET `{.descname}`/api/v1/version`{.descname}[](#get--api-v1-version "Permalink to this definition"){.headerlink} `GET /api/v1/quota-extra`<a href="#get--api-v1-quota-extra" class="headerlink" title="Permalink to this definition"></a>
Access to this service is restricted to just few source ipv4 addresses.
: Returns basic information about API. Returns all accounts which have active filesystem quotas bigger than
standard.
--------------- ----------------------------------------------------------------------------------------------------------------- Response JSON Object:
Status Codes: - [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1){.reference .external} – no error
--------------- -----------------------------------------------------------------------------------------------------------------
**Example request**:
<div class="highlight-console"> - **login** (*string*) – account id
- **system\_name** (*string*) – computer system name
- **filesystem** (*string*) – folder name
- **quota\_gb** (*int*) – disk usage quota for in GB
- **quota\_ki** (*int*) – quota for number of files in thousands
- **expiration** (*string*) – expiration date
- **description** (*string*) – reason for allocation extra quotas
<div class="highlight"> Status Codes:
curl -i https://scs.it4i.cz/api/v1/version - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a>
– no error
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6" class="reference external">405 Method Not Allowed</a>
– restricted access, your ipv4 is not allowed
</div> **Example request**:
</div> curl -i curl https://scs.it4i.cz/api/v1/quota-extra
**Example response**: **Example response**:
<div class="highlight-http"> HTTP/1.1 200 OK
Content-Type: application/json
<div class="highlight"> [
{
"login": "johnsm",
"system_name": "anselm",
"filesystem": "HOME",
"quota_gb": 500,
"quota_ki": 1500,
"expiration": "2017-12-31",
"description": "build SW"
HTTP/1.1 200 OK }
Content-Type: application/json ]
{ <!-- -->
"hostname": "scs.it4i.cz",
"revision": "ceac8aa / 2017-11-01 12:25:27 +0100",
"version": "0.8.2-34-gceac8aa"
}
</div>
</div>
</div>
</div> `GET /api/v1/version`<a href="#get--api-v1-version" class="headerlink" title="Permalink to this definition"></a>
Returns basic information about API.
</div> <table>
<tbody>
<tr class="odd">
<td>Status Codes:</td>
<td><ul>
<li><a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" class="reference external">200 OK</a> – no error</li>
</ul></td>
</tr>
</tbody>
</table>
</div> **Example request**:
<div class="clearer"> curl -i https://scs.it4i.cz/api/v1/version
</div> **Example response**:
</div> HTTP/1.1 200 OK
Content-Type: application/json
<div class="footer"> {
"hostname": "scs.it4i.cz",
"revision": "ceac8aa / 2017-11-01 12:25:27 +0100",
"version": "0.8.2-34-gceac8aa"
}
©2017, IT4Innovations. | Powered by [Sphinx ©2017, IT4Innovations. | Powered by [Sphinx
1.5.6](http://sphinx-doc.org/) & [Alabaster 1.5.6](http://sphinx-doc.org/) & [Alabaster
0.7.10](https://github.com/bitprophet/alabaster) 0.7.10](https://github.com/bitprophet/alabaster)
</div>
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment