FabInfra-Mirror/api.fabaccess-api
1
0
Fork 0
mirror of https://gitlab.com/fabinfra/fabaccess/fabaccess-api.git synced 2025-03-12 14:51:42 +01:00
Code Issues Packages Projects Releases Wiki Activity

Clarify check

Browse Source
This commit is contained in:
Gregor Reitzenstein 2020-04-23 14:44:44 +02:00
parent 86698c260b
commit ef66302e8f
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
api.capnp
View File

@ -92,11 +92,16 @@ interface Machine {
# Try to use a machine. Fails if the user doesn't have enough permissions # Try to use a machine. Fails if the user doesn't have enough permissions
interface Check { interface Check {
ok @0 () -> (); ok @0 () -> (); # The machine was clean & ok. -> free
not_ok @1 () -> (); not_ok @1 () -> ();
# The machine was left in an unacceptable state.
# Most likely marks the machine as `blocked` and somehow informs the previous user.
} }
check @2 () -> ( chk :Maybe(Check) ); check @2 () -> ( chk :Maybe(Check) );
# After a machine has been used by an user with low enough permissions it's
# in the 'toCheck' state. This call then allows more priviledged users to
# "check" the machine and move it to the `free` state.
reserve @3 () -> ( rsrv :Maybe(AnyPointer) ); reserve @3 () -> ( rsrv :Maybe(AnyPointer) );
} }
@ -104,6 +109,9 @@ interface Machine {
interface Machines { interface Machines {
lookup @0 ( uuid :UUID ) -> ( machine :Maybe(Machine) ); lookup @0 ( uuid :UUID ) -> ( machine :Maybe(Machine) );
# Get a machine interface. Returns `none` if there is no Machine with the given uuid. # Get a machine interface. Returns `none` if there is no Machine with the given uuid.
list @1 () -> ( machines :List(Machine) );
# List all machines
} }
interface Permissions { interface Permissions {