Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
S
scs-api-public
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
This is an archived project. Repository and other project resources are read-only.
Show more breadcrumbs
SCS
scs-api-public
Commits
4014eb1b
Commit
4014eb1b
authored
3 years ago
by
scs-ror
Browse files
Options
Downloads
Patches
Plain Diff
Version Thu 26 May 2022 01:03:29 PM UTC
parent
b16561d0
Branches
Branches containing commit
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
scs_api.server_public.md
+41
-69
41 additions, 69 deletions
scs_api.server_public.md
with
41 additions
and
69 deletions
scs_api.server_public.md
+
41
−
69
View file @
4014eb1b
...
...
@@ -15,11 +15,11 @@ is 6 requests per minute. Exceeding the limit will lead to your IP
address being temporarily blocked from making further requests. The
block will automatically be lifted by waiting an hour.
-
api revision:
`
6ecb1bb3
/ 2022-05-
10 13:51:59
+0200`
-
api revision:
`
cd50bb09
/ 2022-05-
26 15:01:17
+0200`
-
api version:
`1.0-3
3
-g
6ecb1
bb`
-
api version:
`1.0-3
4
-g
cd50
bb
0
`
-
apidoc building date:
`2022-05-
10 11:55:4
0 +0000`
-
apidoc building date:
`2022-05-
26 13:03:0
0 +0000`
Summary
-------------------------------------------------------------------------------------
...
...
@@ -271,14 +271,11 @@ Status Codes
**POST /api/v1/it4ifree/**
(login)
A service to check resources of the projects on which the account
participates. If the calculation runs on 1 CPU core for 1 hour, it
consumes 1 core-hour from the project’s resources. However, some
calculations (or their placement) can be cheaper. Actual consumed
core-hours are reduced by a cheapening factor and then deducted from the
project’s resources. See
<a
href=
"https://docs.it4i.cz/general/resources-allocation-policy/#normalized-core-hours-nch"
class=
"reference external"
>
link
</a>
for more details about so-called normalized core-hours. The JSON
response contains two parts:
participates. If the calculation runs on 1 node core for 1 hour, it
consumes 1 node-hour from the project’s resources. See
<a
href=
"https://docs.it4i.cz/general/resources-allocation-policy/"
class=
"reference external"
>
link
</a>
for more details about so-called node-hours. The JSON response contains
two parts:
-
`me`
– data from projects, where the account has access
>
...
...
@@ -302,29 +299,21 @@ Response JSON Object
-
**pid**
(
*string*
) – project id
-
**type**
(
*string*
) – project
type, S for standard, M-1, M-2, M-3
,
M-4 for multiyear
project in particular period
-
**type**
(
*string*
) – project
resource type, eg.: Karolina CPU
,
Barbora GPU, DGX-2,…
project in particular period
-
**days\_left**
(
*string*
) – days to the end of project, or inactive,
expired, forthcoming, upcoming, unlimited
-
**free**
(
*int*
) – free
cor
e-hours which can still be consumed
-
**free**
(
*int*
) – free
nod
e-hours which can still be consumed
-
**total**
(
*int*
) – total
cor
e-hours assigned to the project
-
**total**
(
*int*
) – total
nod
e-hours assigned to the project
-
**used**
(
*int*
) – actual consumed
cor
e-hours
-
**used**
(
*int*
) – actual consumed
nod
e-hours
-
**used\_
with\_factor**
(
*int*
) – consumed normalized core-hours
-
**used\_
by\_me**
(
*int*
) – node-hours consumed by the account
-
**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
-
**nodehours**
(
*int*
) – core-hours consumed by the account
Status Codes
...
...
@@ -348,55 +337,38 @@ Status Codes
{
"me": [
{
"days_left": "---",
"free": 17124,
"login": "johnsm",
"pid": "DD-13-6",
"total": 100000,
"type": "S",
"used": 82876,
"used_by_me": 0,
"used_by_me_with_factor": 0,
"used_with_factor":82876
"by_me":0.0,
"days_left":"244",
"free":7434148.1,
"pid":"DD-13-6",
"resource_type":"Legacy Normalized Core Hours",
"total":7470000.0,
"used":35851.9
},
{
"days_left": "---",
"free": 0,
"login": "johnsm",
"pid": "DD-14-12",
"total": 1000,
"used": 8641,
"type": "S",
"used_by_me": 0,
"used_by_me_with_factor": 0,
"used_with_factor": 8641
}
"by_me":32.4,
"days_left":"220",
"free":67.6,
"pid":"DD-1-1",
"resource_type":"Barbora CPU",
"total":100.0,
"used":32.4
},
],
"me_as_pi": [
{
"core_hours": 82876,
"core_hours_with_factor": 82876,
"login":"abc",
"pi_login": "johnsm",
"pid": "DD-13-6",
"type": "S"
{"login":"johnsm",
"pid":"DD-13-6",
"resource_type":"Legacy Normalized Core Hours",
"total":7470000.0,
"usage":35851.9
},
{
"core_hours": 0,
"core_hours_with_factor": 0,
"login": "johnsm",
"pi_login": "johnsm",
"pid":"DD-13-6",
"type": "S"
{"login":"johnsm",
"pid":"DD-1-1",
"resource_type":"Barbora CPU",
"total":100.0,
"usage":32.4
},
{
"core_hours": 0,
"core_hours_with_factor": 0,
"login": "johnsm",
"pi_login": "johnsm",
"pid":"DD-1-1",
"type": "M-1"
}
]
}
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment