OpenGnsys REST API definition
Information about the OpenGnsys REST API functions (including Server and Repository Manager).
Version: 1.1.0
BasePath:/opengnsys/rest
Creative Commons 4.0 International
http://creativecommons.org/licenses/by/4.0/
Access
- APIKey KeyParamName:Authorization KeyInQuery:false KeyInHeader:true
[ Jump to Models ]
Table of Contents
get /ous
get /ous/{ouid}
get /ous/{ouid}/images
get /ous/{ouid}/images/{imageid}
get /ous/{ouid}/images/{imageid}/software
get /ous/{ouid}/labs
get /ous/{ouid}/labs/{labid}/clients/{clientid}/diskcfg
get /ous/{ouid}/labs/{labid}/clients/{clientid}
get /ous/{ouid}/labs/{labid}/clients/{clientid}/hardware
get /ous/{ouid}/labs/{labid}/clients/{clientid}/status
get /ous/{ouid}/labs/{labid}/clients
get /ous/{ouid}/labs/{labid}
get /ous/{ouid}/repos
get /ous/{ouid}/repos/{repoid}
post /login
Up
get /ous/{ouid}/labs/{labid}/clients/{clientid}/diskcfg
(ousOuidLabsLabidClientsClientidDiskcfgGet)
Get disks configuration 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
Example data
Content-Type: application/json
{
"diskcfg" : [ {
"parttable" : "aeiou",
"image" : {
"deploydate" : "2000-01-23T04:56:07.000+00:00",
"id" : 123,
"updated" : true
},
"disk" : 123,
"partition" : 123,
"size" : 123456789,
"os" : "aeiou",
"usage" : 123,
"parttype" : "aeiou",
"filesystem" : "aeiou"
} ],
"name" : "aeiou",
"id" : 123
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_10
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
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 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/{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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_11
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
Example data
Content-Type: application/json
{
"ip" : "aeiou",
"loggedin" : true,
"id" : 123,
"status" : "aeiou"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_12
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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
Up
get /ous/{ouid}/images/{imageid}/software
(ousOuidImagesImageidSoftwareGet)
Get software inventory store into an `image`
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
Example data
Content-Type: application/json
{
"os" : "aeiou",
"software" : [ {
"application" : "aeiou"
} ],
"name" : "aeiou",
"id" : 123
}
Produces
This API call produces the following media types according to the 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}/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
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 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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_4
(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
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 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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_7
(ousGet)
Gets all `OU` objects.
Consumes
This API call consumes the following media types via the
Content-Type request header:
Return type
Example data
Content-Type: application/json
[ {
"name" : "aeiou",
"id" : 123
} ]
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
(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
Example data
Content-Type: application/json
{
"name" : "aeiou",
"description" : "aeiou",
"id" : ""
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_2
(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
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 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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_14
(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
Example data
Content-Type: application/json
{
"apikey" : "aeiou",
"userid" : 123
}
Produces
This API call produces the following media types according to the 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
(ousGet)
Gets all `OU` objects.
Consumes
This API call consumes the following media types via the
Content-Type request header:
Return type
Example data
Content-Type: application/json
[ {
"name" : "aeiou",
"id" : 123
} ]
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
(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
Example data
Content-Type: application/json
{
"name" : "aeiou",
"description" : "aeiou",
"id" : ""
}
Produces
This API call produces the following media types according to the 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
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 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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_4
(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
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 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}/diskcfg
(ousOuidLabsLabidClientsClientidDiskcfgGet)
Get disks configuration 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
Example data
Content-Type: application/json
{
"diskcfg" : [ {
"parttable" : "aeiou",
"image" : {
"deploydate" : "2000-01-23T04:56:07.000+00:00",
"id" : 123,
"updated" : true
},
"disk" : 123,
"partition" : 123,
"size" : 123456789,
"os" : "aeiou",
"usage" : 123,
"parttype" : "aeiou",
"filesystem" : "aeiou"
} ],
"name" : "aeiou",
"id" : 123
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_10
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
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 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/{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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_11
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
Example data
Content-Type: application/json
{
"ip" : "aeiou",
"loggedin" : true,
"id" : 123,
"status" : "aeiou"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_12
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
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 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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_7
(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
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 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
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 request header;
the media type will be conveyed by the
Content-Type response header.
Responses
200
Successful response
inline_response_200_14
(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
Example data
Content-Type: application/json
{
"apikey" : "aeiou",
"userid" : 123
}
Produces
This API call produces the following media types according to the 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
[ Jump to Methods ]
Table of Contents
authdata
inline_response_200
inline_response_200_1
inline_response_200_10
inline_response_200_10_diskcfg
inline_response_200_10_image
inline_response_200_11
inline_response_200_11_hardware
inline_response_200_12
inline_response_200_13
inline_response_200_14
inline_response_200_2
inline_response_200_3
inline_response_200_4
inline_response_200_4_client
inline_response_200_4_repo
inline_response_200_5
inline_response_200_5_software
inline_response_200_6
inline_response_200_7
inline_response_200_8
inline_response_200_9
ousouidimages_ou
ousouidlabs_ou
username (optional)
password (optional)
userid (optional)
Integer user identificator format: int32
apikey (optional)
String API key to include in ``Authorization`` header
id (optional)
Integer Organization Unit identificator format: int32
name (optional)
id (optional)
name (optional)
diskcfg (optional)
array[inline_response_200_10_diskcfg] array of disk configuration data, including general disk information and partition/filesystem information (if not specified in paratmeter description, it is only valid in partition configuration).
disk (optional)
Integer disk number (only for disks configurations) format: int32
parttable (optional)
String partition table type (only for disks configurations)
MSDOS
GPT
LVM
ZVOL
partition (optional)
Integer partition number format: int32
parttype (optional)
size (optional)
Long disk size (used in both, disk and partition configuration) format: int64
filesystem (optional)
usage (optional)
Integer data usage percentage in a formated filesystem format: int32
os (optional)
String installed operating system
image (optional)
id (optional)
deploydate (optional)
Date image restauration/deploying date format: date-time
updated (optional)
Boolean flag to check if the restaured image is updated
id (optional)
name (optional)
hardware (optional)
type (optional)
String hardware component type
description (optional)
String hardware component description
id (optional)
ip (optional)
status (optional)
nodata
off
ogclient
busy
linux
windows
unknown
loggedin (optional)
Boolean flag to check if an user is logged in
id (optional)
name (optional)
ou (optional)
id (optional)
Integer repository id format: int32
name (optional)
description (optional)
ip (optional)
id (optional)
name (optional)
description (optional)
id (optional)
name (optional)
inremotepc (optional)
ou (optional)
id (optional)
name (optional)
description (optional)
inremotepc (optional)
Boolean image 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)
client (optional)
creationdate (optional)
Date image creation date format: date-time
release (optional)
id (optional)
Integer model client's id. format: int32
disk (optional)
Integer source disk number format: int32
partition (optional)
Integer source partition number format: int32
id (optional)
name (optional)
os (optional)
String installed operating system
software (optional)
application (optional)
String application name and version
id (optional)
Integer laboratory identificator format: int32
name (optional)
inremotepc (optional)
Boolean laboratory usable in Remote PC Project flag
ou (optional)
id (optional)
Integer laboratory identificator format: int32
name (optional)
location (optional)
description (optional)
inremotepc (optional)
Boolean check if this lab can 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)
netmask (optional)
String network mask to use in the lab
ntp (optional)
dns (optional)
proxyurl (optional)
mcastmode (optional)
String Multicast protocol mode (full-duplex, half-duplex).
full-duplex
half-duplex
mcastip (optional)
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)
id (optional)
name (optional)
ou (optional)
lab (optional)
id (optional)
name (optional)
serialno (optional)
netiface (optional)
netdriver (optional)
String client MAC address (kernel module)
mac (optional)
ip (optional)
netmask (optional)
routerip (optional)
String network router IP address
repo (optional)
validation (optional)
boottype (optional)
image (optional)
id (optional)
Integer OU identificator format: int32