OpenGnsys REST API

Information about the OpenGnsys REST API functions (including Server and Repository Manager).
More information: http://opengnsys.es/
Contact Info: opengnsys-devel@listas.unizar.es
Version: 1.1.0
BasePath:/opengnsys/rest
Creative Commons 4.0 International
http://creativecommons.org/licenses/by/4.0/

Access

  1. APIKey KeyParamName:Authorization KeyInQuery:false KeyInHeader:true

Methods

[ Jump to Models ]

Table of Contents

  1. get /ous/{ouid}/labs/{labid}/clients/{clientid}
  2. get /ous/{ouid}/labs/{labid}/clients/{clientid}/hardware
  3. get /ous/{ouid}/labs/{labid}/clients/{clientid}/status
  4. get /ous/{ouid}/labs/{labid}/clients
  5. get /ous/{ouid}/images
  6. get /ous/{ouid}/images/{imageid}
  7. get /ous/{ouid}/labs
  8. get /ous/{ouid}/labs/{labid}
  9. get /ous
  10. get /ous/{ouid}
  11. get /ous/{ouid}/repos
  12. get /ous/{ouid}/repos/{repoid}
  13. post /login
  14. get /ous
  15. get /ous/{ouid}
  16. get /ous/{ouid}/images
  17. get /ous/{ouid}/images/{imageid}
  18. get /ous/{ouid}/labs
  19. get /ous/{ouid}/labs/{labid}/clients/{clientid}
  20. get /ous/{ouid}/labs/{labid}/clients/{clientid}/hardware
  21. get /ous/{ouid}/labs/{labid}/clients/{clientid}/status
  22. get /ous/{ouid}/labs/{labid}/clients
  23. get /ous/{ouid}/labs/{labid}
  24. get /ous/{ouid}/repos
  25. get /ous/{ouid}/repos/{repoid}
  26. post /login
Up 
get /ous/{ouid}/labs/{labid}/clients/{clientid}
(ousOuidLabsLabidClientsClientidGet)
Get a `client` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator
clientid (required)
Path Parameter — Client identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_7

Example data

Content-Type: application/json
{
  "image" : "aeiou",
  "routerip" : "aeiou",
  "boottype" : "aeiou",
  "ip" : "aeiou",
  "repo" : {
    "id" : 123
  },
  "netdriver" : "aeiou",
  "netiface" : "aeiou",
  "mac" : "aeiou",
  "serialno" : "aeiou",
  "netmask" : "aeiou",
  "name" : "aeiou",
  "id" : 123,
  "validation" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_7
Up 
get /ous/{ouid}/labs/{labid}/clients/{clientid}/hardware
(ousOuidLabsLabidClientsClientidHardwareGet)
Get the hardware definition of a `client` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator
clientid (required)
Path Parameter — Client identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_8

Example data

Content-Type: application/json
{
  "name" : "aeiou",
  "id" : 123,
  "hardware" : [ {
    "description" : "aeiou",
    "type" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_8
Up 
get /ous/{ouid}/labs/{labid}/clients/{clientid}/status
(ousOuidLabsLabidClientsClientidStatusGet)
Get execution status of a `client`

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator
clientid (required)
Path Parameter — Client identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_9

Example data

Content-Type: application/json
{
  "ip" : "aeiou",
  "id" : 123,
  "status" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_9
Up 
get /ous/{ouid}/labs/{labid}/clients
(ousOuidLabsLabidClientsGet)
Get all `client` objects defined in an `lab`.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_6]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123,
  "lab" : ""
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/images
(ousOuidImagesGet)
Get all `image` objects defined in an `OU`.

Path parameters

ouid (required)
Path Parameter — OU identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_3]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123,
  "inremotepc" : true
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/images/{imageid}
(ousOuidImagesImageidGet)
Get an `image` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
imageid (required)
Path Parameter — image definition identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_4

Example data

Content-Type: application/json
{
  "path" : "aeiou",
  "creationdate" : "2000-01-23T04:56:07.000+00:00",
  "release" : "aeiou",
  "repo" : {
    "id" : 123
  },
  "name" : "aeiou",
  "description" : "aeiou",
  "client" : {
    "disk" : 123,
    "partition" : 123,
    "id" : 123
  },
  "id" : 123,
  "inremotepc" : true,
  "type" : "aeiou",
  "baseimg" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_4
Up 
get /ous/{ouid}/labs
(ousOuidLabsGet)
Get all `lab` objects defined in an `OU`.

Path parameters

ouid (required)
Path Parameter — OU identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_3]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123,
  "inremotepc" : true
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/labs/{labid}
(ousOuidLabsLabidGet)
Get a `lab` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — laboratory identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_5

Example data

Content-Type: application/json
{
  "image" : "aeiou",
  "routerip" : "aeiou",
  "mcastport" : 123,
  "proxyurl" : "aeiou",
  "dns" : "aeiou",
  "mcastmode" : "aeiou",
  "description" : "aeiou",
  "inremotepc" : true,
  "ntp" : "aeiou",
  "mcastspeed" : 123,
  "capacity" : 123,
  "defclients" : 123,
  "mcastip" : "aeiou",
  "projector" : true,
  "netmask" : "aeiou",
  "p2ptime" : 123,
  "name" : "aeiou",
  "p2pmode" : "aeiou",
  "location" : "aeiou",
  "id" : 123,
  "board" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_5
Up 
get /ous
(ousGet)
Gets all `OU` objects.

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_1]

Example data

Content-Type: application/json
[ {
  "name" : "aeiou",
  "id" : 123
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}
(ousOuidGet)
Get an `OU` object.

Path parameters

ouid (required)
Path Parameter — Organization Unit identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_2

Example data

Content-Type: application/json
{
  "name" : "aeiou",
  "description" : "aeiou",
  "id" : ""
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_2
Up 
get /ous/{ouid}/repos
(ousOuidReposGet)
Get all `repo` objects defined in an `OU`.

Path parameters

ouid (required)
Path Parameter — OU identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_10]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/repos/{repoid}
(ousOuidReposRepoidGet)
Get a `repo` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
repoid (required)
Path Parameter — repository identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_11

Example data

Content-Type: application/json
{
  "ip" : "aeiou",
  "name" : "aeiou",
  "description" : "aeiou",
  "id" : 123
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_11
Up 
post /login
(loginPost)
Check user login and returns his/her API key.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

authdata (required)
Body Parameter — JSON authentication data

Return type

inline_response_200

Example data

Content-Type: application/json
{
  "apikey" : "aeiou",
  "userid" : 123
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful login inline_response_200

400

Missing parameters

500

Authentication error
Up 
get /ous
(ousGet)
Gets all `OU` objects.

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_1]

Example data

Content-Type: application/json
[ {
  "name" : "aeiou",
  "id" : 123
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}
(ousOuidGet)
Get an `OU` object.

Path parameters

ouid (required)
Path Parameter — Organization Unit identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_2

Example data

Content-Type: application/json
{
  "name" : "aeiou",
  "description" : "aeiou",
  "id" : ""
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_2
Up 
get /ous/{ouid}/images
(ousOuidImagesGet)
Get all `image` objects defined in an `OU`.

Path parameters

ouid (required)
Path Parameter — OU identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_3]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123,
  "inremotepc" : true
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/images/{imageid}
(ousOuidImagesImageidGet)
Get an `image` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
imageid (required)
Path Parameter — image definition identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_4

Example data

Content-Type: application/json
{
  "path" : "aeiou",
  "creationdate" : "2000-01-23T04:56:07.000+00:00",
  "release" : "aeiou",
  "repo" : {
    "id" : 123
  },
  "name" : "aeiou",
  "description" : "aeiou",
  "client" : {
    "disk" : 123,
    "partition" : 123,
    "id" : 123
  },
  "id" : 123,
  "inremotepc" : true,
  "type" : "aeiou",
  "baseimg" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_4
Up 
get /ous/{ouid}/labs
(ousOuidLabsGet)
Get all `lab` objects defined in an `OU`.

Path parameters

ouid (required)
Path Parameter — OU identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_3]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123,
  "inremotepc" : true
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/labs/{labid}/clients/{clientid}
(ousOuidLabsLabidClientsClientidGet)
Get a `client` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator
clientid (required)
Path Parameter — Client identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_7

Example data

Content-Type: application/json
{
  "image" : "aeiou",
  "routerip" : "aeiou",
  "boottype" : "aeiou",
  "ip" : "aeiou",
  "repo" : {
    "id" : 123
  },
  "netdriver" : "aeiou",
  "netiface" : "aeiou",
  "mac" : "aeiou",
  "serialno" : "aeiou",
  "netmask" : "aeiou",
  "name" : "aeiou",
  "id" : 123,
  "validation" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_7
Up 
get /ous/{ouid}/labs/{labid}/clients/{clientid}/hardware
(ousOuidLabsLabidClientsClientidHardwareGet)
Get the hardware definition of a `client` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator
clientid (required)
Path Parameter — Client identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_8

Example data

Content-Type: application/json
{
  "name" : "aeiou",
  "id" : 123,
  "hardware" : [ {
    "description" : "aeiou",
    "type" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_8
Up 
get /ous/{ouid}/labs/{labid}/clients/{clientid}/status
(ousOuidLabsLabidClientsClientidStatusGet)
Get execution status of a `client`

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator
clientid (required)
Path Parameter — Client identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_9

Example data

Content-Type: application/json
{
  "ip" : "aeiou",
  "id" : 123,
  "status" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_9
Up 
get /ous/{ouid}/labs/{labid}/clients
(ousOuidLabsLabidClientsGet)
Get all `client` objects defined in an `lab`.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — Lab identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_6]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123,
  "lab" : ""
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/labs/{labid}
(ousOuidLabsLabidGet)
Get a `lab` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
labid (required)
Path Parameter — laboratory identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_5

Example data

Content-Type: application/json
{
  "image" : "aeiou",
  "routerip" : "aeiou",
  "mcastport" : 123,
  "proxyurl" : "aeiou",
  "dns" : "aeiou",
  "mcastmode" : "aeiou",
  "description" : "aeiou",
  "inremotepc" : true,
  "ntp" : "aeiou",
  "mcastspeed" : 123,
  "capacity" : 123,
  "defclients" : 123,
  "mcastip" : "aeiou",
  "projector" : true,
  "netmask" : "aeiou",
  "p2ptime" : 123,
  "name" : "aeiou",
  "p2pmode" : "aeiou",
  "location" : "aeiou",
  "id" : 123,
  "board" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_5
Up 
get /ous/{ouid}/repos
(ousOuidReposGet)
Get all `repo` objects defined in an `OU`.

Path parameters

ouid (required)
Path Parameter — OU identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

array[inline_response_200_10]

Example data

Content-Type: application/json
[ {
  "ou" : {
    "id" : 123
  },
  "name" : "aeiou",
  "id" : 123
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response
Up 
get /ous/{ouid}/repos/{repoid}
(ousOuidReposRepoidGet)
Get a `repo` object.

Path parameters

ouid (required)
Path Parameter — OU identificator
repoid (required)
Path Parameter — repository identificator

Consumes

This API call consumes the following media types via the Content-Type request header:

Return type

inline_response_200_11

Example data

Content-Type: application/json
{
  "ip" : "aeiou",
  "name" : "aeiou",
  "description" : "aeiou",
  "id" : 123
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response inline_response_200_11
Up 
post /login
(loginPost)
Check user login and returns his/her API key.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

authdata (required)
Body Parameter — JSON authentication data

Return type

inline_response_200

Example data

Content-Type: application/json
{
  "apikey" : "aeiou",
  "userid" : 123
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful login inline_response_200

400

Missing parameters

500

Authentication error
Up

Models

[ Jump to Methods ]

Table of Contents

  1. authdata
  2. inline_response_200
  3. inline_response_200_1
  4. inline_response_200_10
  5. inline_response_200_11
  6. inline_response_200_2
  7. inline_response_200_3
  8. inline_response_200_4
  9. inline_response_200_4_client
  10. inline_response_200_4_repo
  11. inline_response_200_5
  12. inline_response_200_6
  13. inline_response_200_7
  14. inline_response_200_8
  15. inline_response_200_8_hardware
  16. inline_response_200_9
  17. ousouidimages_ou

authdata Up

username (optional)
String
password (optional)
String format: password

inline_response_200 Up

userid (optional)
Integer format: int32
apikey (optional)
String

inline_response_200_1 Up

id (optional)
Integer format: int32
name (optional)
String

inline_response_200_10 Up

id (optional)
Integer format: int32
name (optional)
String
ou (optional)
ousouidimages_ou

inline_response_200_11 Up

id (optional)
Integer repository id format: int32
name (optional)
String repository name
description (optional)
String repository description
ip (optional)
String repository IP address

inline_response_200_2 Up

id (optional)
Integer
name (optional)
String
description (optional)
String

inline_response_200_3 Up

id (optional)
Integer format: int32
name (optional)
String
inremotepc (optional)
Boolean
ou (optional)
ousouidimages_ou

inline_response_200_4 Up

id (optional)
Integer image id format: int32
name (optional)
String image name
description (optional)
String image description
inremotepc (optional)
Boolean usable in Remote PC Project flag
type (optional)
String image type (``monolithic``, ``basic``, ``incremental``)
baseimg (optional)
String base image for an incremental image (if ``type`` is ``incremental``)
path (optional)
String image path (if ``type`` is ``incremental``)
repo (optional)
inline_response_200_4_repo
client (optional)
inline_response_200_4_client
creationdate (optional)
Date image creation date format: date-time
release (optional)
String image creation release

inline_response_200_4_client Up

id (optional)
Integer model client's id. format: int32
disk (optional)
Integer model client's id. format: int32
partition (optional)
Integer model client's id. format: int32

inline_response_200_4_repo Up

id (optional)
Integer format: int32

inline_response_200_5 Up

id (optional)
Integer laboratory identificator format: int32
name (optional)
String laboratory name
location (optional)
String laboratory location
description (optional)
String laboratory description
inremotepc (optional)
Boolean check if this lab will be included in Remote PC Project
capacity (optional)
Integer maximum number of people in the lab format: int32
defclients (optional)
Integer number of defined clients in the lab format: int32
projector (optional)
Boolean check if this lab has a projector
board (optional)
Boolean check if this lab has an electronic board
routerip (optional)
String lab router IP address
netmask (optional)
String network mask to use in the lab
ntp (optional)
String NTP server IP address
dns (optional)
String DNS server IP address
proxyurl (optional)
String Proxy server URL
mcastmode (optional)
String Multicast protocol mode (``full-duplex``, ``half-duplex``).
mcastip (optional)
String Multicast IP address
mcastport (optional)
Integer Multicast port format: int32
mcastspeed (optional)
Integer Multicast speed (in Mbps) format: int32
p2pmode (optional)
String Bittorrent connection type (\"peer\", \"leecher\". \"seeder\").
p2ptime (optional)
Integer Bittorrent connection extra time (in s.) format: int32
image (optional)
String Lab's picture file

inline_response_200_6 Up

id (optional)
Integer format: int32
name (optional)
String
ou (optional)
ousouidimages_ou
lab (optional)
ousouidimages_ou

inline_response_200_7 Up

id (optional)
Integer client id format: int32
name (optional)
String client name
serialno (optional)
String client serial number
netiface (optional)
String main network interface
netdriver (optional)
String client MAC address (kernel module)
mac (optional)
String client MAC address
ip (optional)
String client IP address
netmask (optional)
String subnet mask address
routerip (optional)
String network router IP address
repo (optional)
inline_response_200_4_repo
validation (optional)
Boolean boot validation flag
boottype (optional)
String boot template type
image (optional)
String client's picture file

inline_response_200_8 Up

id (optional)
Integer client id format: int32
name (optional)
String client name
hardware (optional)
array[inline_response_200_8_hardware] hardware components

inline_response_200_8_hardware Up

type (optional)
String hardware component type
description (optional)
String hardware component description

inline_response_200_9 Up

id (optional)
Integer client id format: int32
ip (optional)
String client IP address
status (optional)
String execution status

ousouidimages_ou Up

id (optional)
Integer format: int32