Context Navigation

opengnsys-api.yml @ 21e2ab8

Visit:

918-git-images-111dconfigfileconfigure-oglivegit-imageslgromero-new-oglivemainmaint-cronmount-efivarfsmultivmmultivm-ogboot-installerogClonningEngineogboot-installer-jenkinsoglive-ipv6test-python-scriptsticket-301ticket-50ticket-50-oldticket-577ticket-585ticket-611ticket-612ticket-693ticket-700ubu24tplunification2use-local-agent-oglivevarios-instalacionwebconsole3

Last change on this file since 21e2ab8 was 2154cbb, checked in by irina <irinagomez@…>, 8 years ago

#708 API REST y Consola: En las propiedades de la imagen se incluye el nombre del sistema operativo

git-svn-id: https://opengnsys.es/svn/branches/version1.1@5308 a21b9725-9963-47de-94b9-378ad31fedc9

Property mode set to 100644

File size: 35.3 KB

Rev	Line
[ac8b234e]	1	swagger: '2.0'
	2
	3	info:
	4	version: "1.1.0"
[df81ab78]	5	title: OpenGnsys REST API definition
[ac8b234e]	6	description: \|
[3b5daf8]	7	Information about the OpenGnsys REST API functions (including Server and
	8	Repository Manager).
	9	contact:
	10	name: OpenGnsys Project
	11	url: http://opengnsys.es/
[ac8b234e]	12	license:
	13	name: Creative Commons 4.0 International
	14	url: http://creativecommons.org/licenses/by/4.0/
[3b5daf8]	15	basePath: /opengnsys/rest
[ac8b234e]	16	schemes:
	17	- https
	18	consumes:
	19	- application/json
	20	produces:
	21	- application/json
	22	securityDefinitions:
	23	apikey:
	24	type: apiKey
	25	name: Authorization
	26	in: header
	27	# Paths description.
	28	paths:
	29	/login:
	30	post:
	31	description: Check user login and returns his/her API key.
	32	parameters:
	33	- in: body
	34	name: authdata
	35	description: JSON authentication data
	36	required: true
	37	schema:
	38	type: object
	39	properties:
	40	username:
	41	type: string
	42	password:
	43	type: string
[3b5daf8]	44	format: password
[ac8b234e]	45	responses:
	46	"200":
	47	description: Successful login
	48	schema:
	49	type: object
	50	properties:
	51	userid:
	52	type: integer
[df81ab78]	53	description: user identificator
[3b5daf8]	54	format: int32
[ac8b234e]	55	apikey:
[df81ab78]	56	description: API key to include in ``Authorization`` header
[ac8b234e]	57	type: string
	58	"400":
	59	description: Missing parameters
[0126b05]	60	schema:
	61	type: object
	62	properties:
	63	message:
	64	type: string
[ac8b234e]	65	"500":
	66	description: Authentication error
[0126b05]	67	schema:
	68	type: object
	69	properties:
	70	message:
	71	type: string
[ac8b234e]	72	tags:
[3b5daf8]	73	- server
[ac8b234e]	74	- user
[3551804]	75	/info:
	76	get:
	77	description: Gets OpenGnsys Server information
	78	responses:
	79	"200":
	80	description: Successful response
	81	schema:
	82	type: object
	83	properties:
	84	project:
	85	description: project name (OpenGnsys)
	86	type: string
	87	version:
	88	description: project version
	89	type: string
	90	release:
	91	description: project release
	92	type: string
	93	services:
	94	description: actived services
	95	type: array
	96	items:
	97	type: string
	98	enum: [ 'server', 'repository', 'tracker' ]
[90e3284]	99	oglive:
	100	description: installed ogLive clients
	101	type: array
	102	items:
	103	type: object
	104	properties:
	105	distribution:
	106	description: base distribution
	107	type: string
	108	kernel:
	109	description: kernel version
	110	type: string
[a739060]	111	architecture:
	112	description: kernel architecture (32-bit or 64-bit)
	113	type: string
	114	enum: [ "i386", "amd64" ]
[90e3284]	115	revision:
	116	description: OpenGnsys revision
	117	type: string
	118	directory:
	119	description: installation directory
	120	type: string
	121	iso:
	122	description: ISO file
	123	type: string
[a739060]	124	required: [ distribution, kernel, architecture, revision, directory, iso ]
[3551804]	125	required: [ project, version, release, services ]
	126	tags:
	127	- server
	128	- repository
[23a72c0]	129	/status:
	130	get:
	131	description: Gets OpenGnsys Server status information
	132	responses:
	133	"200":
	134	description: Successful response
	135	schema:
	136	type: object
	137	properties:
	138	memInfo:
[146d955]	139	description: memory information
	140	properties:
	141	total:
	142	description: total amount of memory
	143	type: integer
	144	format: int64
	145	used:
	146	description: amount of used memory
	147	type: integer
	148	format: int64
	149	required: [ total, used ]
[23a72c0]	150	cpu:
	151	description: CPU information
[146d955]	152	properties:
	153	model:
	154	description: processor model
	155	type: string
	156	usage:
	157	description: average of processor load
	158	type: number
	159	format: float
	160	required: [ model, usage ]
	161	required: [ memInfo, cpu ]
[23a72c0]	162	tags:
	163	- server
[ac8b234e]	164	/ous:
	165	get:
	166	description: Gets all `OU` objects.
	167	responses:
	168	"200":
	169	description: Successful response
	170	schema:
	171	type: array
	172	items:
	173	type: object
	174	properties:
	175	id:
	176	type: integer
[df81ab78]	177	description: Organization Unit identificator
[3b5daf8]	178	format: int32
[df81ab78]	179	minimum: 1
[ac8b234e]	180	name:
	181	type: string
[df81ab78]	182	description: Organization Unit name
[146d955]	183	required: [ id, name ]
[ac8b234e]	184	tags:
[3b5daf8]	185	- server
[ac8b234e]	186	- ou
	187	/ous/{ouid}:
	188	get:
	189	description: Get an `OU` object.
	190	parameters:
[213a832]	191	- $ref: "#/parameters/ouParam"
[ac8b234e]	192	responses:
	193	"200":
	194	description: Successful response
	195	schema:
	196	type: object
	197	properties:
	198	id:
	199	type: integer
[df81ab78]	200	description: OU identificator
[ac8b234e]	201	name:
	202	type: string
[df81ab78]	203	description: OU name
[ac8b234e]	204	description:
	205	type: string
[df81ab78]	206	description: OU description
[146d955]	207	required: [ id, name, description ]
	208	security:
	209	- apikey: []
	210	tags:
	211	- server
	212	- ou
	213	/ous/{ouid}/groups:
	214	get:
	215	description: Get all group of labs defined in an `OU` object.
	216	parameters:
[213a832]	217	- $ref: "#/parameters/ouParam"
[146d955]	218	responses:
	219	"200":
	220	description: Successful response
	221	schema:
	222	type: array
	223	items:
	224	type: object
	225	properties:
	226	id:
	227	description: group identificator
	228	type: integer
	229	format: int32
	230	name:
	231	description: group name
	232	type: string
	233	type:
	234	description: group type
	235	type: integer
	236	comments:
	237	description: extra comments
	238	type: string
	239	parent:
	240	description: parent group
	241	type: object
	242	properties:
	243	id:
	244	description: parent group identificator
	245	type: integer
	246	format: int32
	247	required: [ id, name, comments ]
[ac8b234e]	248	security:
	249	- apikey: []
	250	tags:
[3b5daf8]	251	- server
[ac8b234e]	252	- ou
	253	/ous/{ouid}/labs:
	254	get:
	255	description: Get all `lab` objects defined in an `OU`.
	256	parameters:
[213a832]	257	- $ref: "#/parameters/ouParam"
[ac8b234e]	258	responses:
	259	"200":
	260	description: Successful response
	261	schema:
	262	type: array
	263	items:
	264	type: object
	265	properties:
	266	id:
	267	type: integer
[df81ab78]	268	description: laboratory identificator
[3b5daf8]	269	format: int32
[ac8b234e]	270	name:
	271	type: string
[df81ab78]	272	description: laboratory name
[ac8b234e]	273	inremotepc:
	274	type: boolean
[df81ab78]	275	description: laboratory usable in Remote PC Project flag
[146d955]	276	group:
[ac8b234e]	277	type: object
	278	properties:
	279	id:
[146d955]	280	description: group identificator
[ac8b234e]	281	type: integer
[146d955]	282	format: int32
	283	ou:
	284	type: object
	285	properties:
	286	id:
[df81ab78]	287	description: OU identificator
[146d955]	288	type: integer
[3b5daf8]	289	format: int32
[90e3284]	290	required: [ id, name, inremotepc, ou ]
[ac8b234e]	291	security:
	292	- apikey: []
	293	tags:
[3b5daf8]	294	- server
[ac8b234e]	295	- lab
	296	/ous/{ouid}/labs/{labid}:
	297	get:
	298	description: Get a `lab` object.
	299	parameters:
[213a832]	300	- $ref: "#/parameters/ouParam"
	301	- $ref: "#/parameters/labParam"
[ac8b234e]	302	responses:
	303	"200":
	304	description: Successful response
	305	schema:
	306	type: object
	307	properties:
	308	id:
	309	description: laboratory identificator
	310	type: integer
[3b5daf8]	311	format: int32
[ac8b234e]	312	name:
	313	description: laboratory name
	314	type: string
	315	location:
	316	description: laboratory location
	317	type: string
	318	description:
	319	description: laboratory description
	320	type: string
	321	inremotepc:
[df81ab78]	322	description: check if this lab can be included in Remote PC Project
[ac8b234e]	323	type: boolean
	324	capacity:
	325	description: maximum number of people in the lab
	326	type: integer
[3b5daf8]	327	format: int32
[ac8b234e]	328	defclients:
	329	description: number of defined clients in the lab
	330	type: integer
[3b5daf8]	331	format: int32
[ac8b234e]	332	projector:
	333	description: check if this lab has a projector
	334	type: boolean
	335	board:
	336	description: check if this lab has an electronic board
	337	type: boolean
	338	routerip:
	339	description: lab router IP address
	340	type: string
	341	netmask:
	342	description: network mask to use in the lab
	343	type: string
	344	ntp:
	345	description: NTP server IP address
	346	type: string
	347	dns:
	348	description: DNS server IP address
	349	type: string
	350	proxyurl:
	351	description: Proxy server URL
	352	type: string
	353	mcastmode:
[df81ab78]	354	description: Multicast protocol mode (full-duplex, half-duplex).
[ac8b234e]	355	type: string
[df81ab78]	356	enum: [ "full-duplex", "half-duplex" ]
	357	default: "full-duplex"
[ac8b234e]	358	mcastip:
	359	description: Multicast IP address
	360	type: string
	361	mcastport:
	362	description: Multicast port
	363	type: integer
[3b5daf8]	364	format: int32
[ac8b234e]	365	mcastspeed:
	366	description: Multicast speed (in Mbps)
	367	type: integer
[3b5daf8]	368	format: int32
[ac8b234e]	369	p2pmode:
	370	description: Bittorrent connection type ("peer", "leecher". "seeder").
	371	type: string
	372	p2ptime:
	373	description: Bittorrent connection extra time (in s.)
	374	type: integer
[3b5daf8]	375	format: int32
[0126b05]	376	picture:
[ac8b234e]	377	description: Lab's picture file
	378	type: string
[213a832]	379	required: [ id, name, location, description, inremotepc, capacity, defclients, projector, board, routerip, netmask, mcastmode, mcastip, mcastport, mcastspeed, p2pmode, p2ptime, picture ]
[ac8b234e]	380	security:
	381	- apikey: []
	382	tags:
[3b5daf8]	383	- server
[ac8b234e]	384	- lab
	385	/ous/{ouid}/labs/{labid}/clients:
	386	get:
	387	description: Get all `client` objects defined in an `lab`.
	388	parameters:
[213a832]	389	- $ref: "#/parameters/ouParam"
	390	- $ref: "#/parameters/labParam"
[ac8b234e]	391	responses:
	392	"200":
	393	description: Successful response
	394	schema:
	395	type: array
	396	items:
[d8b6c70]	397	$ref: "#/definitions/SelectedClientModel"
[ac8b234e]	398	security:
	399	- apikey: []
	400	tags:
[3b5daf8]	401	- server
[ac8b234e]	402	- client
[2a337db]	403	/ous/{ouid}/labs/{labid}/clients/status:
[213a832]	404	get:
	405	description: Get execution status of all clients definied in a `lab`
	406	parameters:
	407	- $ref: "#/parameters/ouParam"
	408	- $ref: "#/parameters/labParam"
	409	responses:
	410	"200":
	411	description: Successful response
	412	schema:
	413	type: array
	414	items:
	415	$ref: "#/definitions/StatusModel"
	416	security:
	417	- apikey: []
	418	tags:
	419	- server
	420	- client
[ac8b234e]	421	/ous/{ouid}/labs/{labid}/clients/{clientid}:
	422	get:
	423	description: Get a `client` object.
	424	parameters:
[213a832]	425	- $ref: "#/parameters/ouParam"
	426	- $ref: "#/parameters/labParam"
	427	- $ref: "#/parameters/clientParam"
[ac8b234e]	428	responses:
	429	"200":
	430	description: Successful response
	431	schema:
	432	type: object
	433	properties:
	434	id:
	435	description: client id
	436	type: integer
[3b5daf8]	437	format: int32
[ac8b234e]	438	name:
	439	description: client name
	440	type: string
	441	serialno:
	442	description: client serial number
	443	type: string
	444	netiface:
	445	description: main network interface
	446	type: string
	447	netdriver:
	448	description: client MAC address (kernel module)
	449	type: string
	450	mac:
	451	description: client MAC address
	452	type: string
	453	ip:
	454	description: client IP address
	455	type: string
	456	netmask:
	457	description: subnet mask address
	458	type: string
	459	routerip:
	460	description: network router IP address
	461	type: string
	462	repo:
	463	description: repository identification
	464	type: object
	465	properties:
	466	id:
	467	type: integer
[3b5daf8]	468	format: int32
[ac8b234e]	469	validation:
	470	description: boot validation flag
	471	type: boolean
	472	boottype:
	473	description: boot template type
	474	type: string
[0126b05]	475	picture:
[ac8b234e]	476	description: client's picture file
	477	type: string
[213a832]	478	required: [ id, name, serialno, netiface, netdriver, mac, ip, netmask, routerip, repo, validation, picture ]
[ac8b234e]	479	security:
	480	- apikey: []
	481	tags:
[3b5daf8]	482	- server
[ac8b234e]	483	- client
	484	/ous/{ouid}/labs/{labid}/clients/{clientid}/hardware:
	485	get:
	486	description: Get the hardware definition of a `client` object.
	487	parameters:
[213a832]	488	- $ref: "#/parameters/ouParam"
	489	- $ref: "#/parameters/labParam"
	490	- $ref: "#/parameters/clientParam"
[ac8b234e]	491	responses:
	492	"200":
	493	description: Successful response
	494	schema:
	495	type: object
	496	properties:
	497	id:
	498	description: client id
	499	type: integer
[3b5daf8]	500	format: int32
[ac8b234e]	501	name:
	502	description: client name
	503	type: string
	504	hardware:
	505	description: hardware components
	506	type: array
	507	items:
	508	type: object
	509	properties:
	510	type:
	511	description: hardware component type
	512	type: string
	513	description:
	514	description: hardware component description
	515	type: string
[146d955]	516	required: [ type, description ]
	517	required: [ id, name, hardware ]
	518	security:
	519	- apikey: []
[ac8b234e]	520	tags:
[3b5daf8]	521	- server
[ac8b234e]	522	- client
[df81ab78]	523	/ous/{ouid}/labs/{labid}/clients/{clientid}/diskcfg:
	524	get:
	525	description: Get disks configuration of a `client`
	526	parameters:
[213a832]	527	- $ref: "#/parameters/ouParam"
	528	- $ref: "#/parameters/labParam"
	529	- $ref: "#/parameters/clientParam"
[df81ab78]	530	responses:
	531	"200":
	532	description: Successful response
	533	schema:
	534	type: object
	535	properties:
	536	id:
	537	description: client id
	538	type: integer
	539	format: int32
	540	name:
	541	description: client name
	542	type: string
	543	diskcfg:
	544	description: \|
	545	array of disk configuration data, including general disk information and
	546	partition/filesystem information (if not specified in paratmeter
	547	description, it is only valid in partition configuration).
	548	type: array
	549	items:
	550	type: object
	551	properties:
	552	disk:
[2fd9054]	553	description: disk number
[df81ab78]	554	type: integer
	555	format: int32
[2fd9054]	556	minimum: 1
	557	size:
	558	description: disk or partition size
	559	type: integer
	560	format: int64
[df81ab78]	561	parttable:
[2fd9054]	562	description: partition table type (only in disk configuration)
[df81ab78]	563	type: string
	564	enum: [ "MSDOS", "GPT", "LVM", "ZVOL" ]
	565	partition:
[2fd9054]	566	description: partition number (only in partition configuration)
[df81ab78]	567	type: integer
	568	format: int32
	569	minimum: 1
	570	parttype:
[2fd9054]	571	description: partition type (only in partition configuration)
[df81ab78]	572	type: string
	573	filesystem:
[2fd9054]	574	description: filesystem type (only in partition configuration)
[df81ab78]	575	type: string
	576	usage:
[2fd9054]	577	description: percentage of data usage in a formated filesystem (only in partition configuration)
[df81ab78]	578	type: integer
	579	format: int32
	580	os:
[2fd9054]	581	description: installed operating system (only in partition configuration)
[df81ab78]	582	type: string
	583	image:
[2fd9054]	584	description: restaured image data, if needed (only in partition configuration)
[df81ab78]	585	type: object
	586	properties:
	587	id:
	588	type: integer
	589	format: int32
	590	deploydate:
[2fd9054]	591	description: image restauration/deploying date (only in partition configuration)
[df81ab78]	592	type: string
	593	format: date-time
	594	updated:
[2fd9054]	595	description: flag to check if the restaured image is updated (only in partition configuration)
[df81ab78]	596	type: boolean
[146d955]	597	required: [ id, name, diskcfg ]
	598	security:
	599	- apikey: []
[df81ab78]	600	tags:
	601	- server
	602	- client
[ac8b234e]	603	/ous/{ouid}/labs/{labid}/clients/{clientid}/status:
	604	get:
	605	description: Get execution status of a `client`
	606	parameters:
[213a832]	607	- $ref: "#/parameters/ouParam"
	608	- $ref: "#/parameters/labParam"
	609	- $ref: "#/parameters/clientParam"
[ac8b234e]	610	responses:
	611	"200":
	612	description: Successful response
	613	schema:
[213a832]	614	$ref: "#/definitions/StatusModel"
[146d955]	615	security:
	616	- apikey: []
[ac8b234e]	617	tags:
[3b5daf8]	618	- server
[ac8b234e]	619	- client
[7766e7a]	620	/ous/{ouid}/labs/{labid}/clients/{clientid}/events:
	621	post:
	622	description: Store UDS server URLs to resend some events recieved from OGAgent.
	623	parameters:
[213a832]	624	- $ref: "#/parameters/ouParam"
	625	- $ref: "#/parameters/labParam"
	626	- $ref: "#/parameters/clientParam"
[7766e7a]	627	- name: data
	628	in: body
	629	description: Operation data
	630	required: true
	631	schema:
	632	type: object
	633	properties:
	634	urlLogin:
	635	description: URL to resend a login event.
	636	type: string
	637	urlLogout:
	638	description: URL to resend a logout event.
	639	type: string
	640	required: [ urlLogin, urlLogout ]
	641	responses:
	642	"200":
	643	description: Successful response
[0126b05]	644	"400":
	645	description: Error message
	646	schema:
	647	type: object
	648	properties:
	649	message:
	650	type: string
[7766e7a]	651	security:
	652	- apikey: []
	653	tags:
	654	- server
	655	- client
[0126b05]	656	- remotepc
[7766e7a]	657	/ous/{ouid}/labs/{labid}/clients/{clientid}/session:
	658	post:
	659	description: Record session data for a client.
	660	parameters:
[213a832]	661	- $ref: "#/parameters/ouParam"
	662	- $ref: "#/parameters/labParam"
	663	- $ref: "#/parameters/clientParam"
[7766e7a]	664	- name: data
	665	in: body
	666	description: Session parameters
	667	required: true
	668	schema:
	669	type: object
	670	properties:
	671	logoutAt:
	672	description: Time to send a logout operation to the client
	673	type: string
	674	format: date-time
	675	responses:
	676	"200":
	677	description: Successful response
	678	security:
	679	- apikey: []
	680	tags:
	681	- server
	682	- client
[0126b05]	683	- remotepc
[7766e7a]	684	/ous/{ouid}/labs/{labid}/clients/{clientid}/unreserve:
[9a39c75]	685	delete:
[7766e7a]	686	description: Unreserve a client, clear its session data and send a poweroff operation.
	687	parameters:
[213a832]	688	- $ref: "#/parameters/ouParam"
	689	- $ref: "#/parameters/labParam"
	690	- $ref: "#/parameters/clientParam"
[7766e7a]	691	responses:
	692	"200":
	693	description: Successful response
	694	security:
	695	- apikey: []
	696	tags:
	697	- server
	698	- client
[0126b05]	699	- remotepc
[ac8b234e]	700	/ous/{ouid}/repos:
	701	get:
	702	description: Get all `repo` objects defined in an `OU`.
	703	parameters:
[213a832]	704	- $ref: "#/parameters/ouParam"
[ac8b234e]	705	responses:
	706	"200":
	707	description: Successful response
	708	schema:
	709	type: array
	710	items:
	711	type: object
	712	properties:
	713	id:
	714	type: integer
[3b5daf8]	715	format: int32
[ac8b234e]	716	name:
	717	type: string
	718	ou:
	719	type: object
	720	properties:
	721	id:
	722	type: integer
[3b5daf8]	723	format: int32
[de1b6b5]	724	required: [ id, name, ou ]
[ac8b234e]	725	security:
	726	- apikey: []
	727	tags:
[3b5daf8]	728	- server
[ac8b234e]	729	- repo
	730	/ous/{ouid}/repos/{repoid}:
	731	get:
	732	description: Get a `repo` object.
	733	parameters:
[213a832]	734	- $ref: "#/parameters/ouParam"
	735	- $ref: "#/parameters/repoParam"
[ac8b234e]	736	responses:
	737	"200":
	738	description: Successful response
	739	schema:
	740	type: object
	741	properties:
	742	id:
	743	description: repository id
	744	type: integer
[3b5daf8]	745	format: int32
[ac8b234e]	746	name:
	747	description: repository name
	748	type: string
	749	description:
	750	description: repository description
	751	type: string
	752	ip:
	753	description: repository IP address
	754	type: string
[de1b6b5]	755	required: [ id, name, description, ip ]
[ac8b234e]	756	security:
	757	- apikey: []
	758	tags:
[3b5daf8]	759	- server
[ac8b234e]	760	- repo
[3b5daf8]	761	/ous/{ouid}/images:
	762	get:
	763	description: Get all `image` objects defined in an `OU`.
	764	parameters:
[213a832]	765	- $ref: "#/parameters/ouParam"
[3b5daf8]	766	responses:
	767	"200":
	768	description: Successful response
	769	schema:
	770	type: array
	771	items:
	772	type: object
	773	properties:
	774	id:
	775	type: integer
	776	format: int32
	777	name:
	778	type: string
	779	inremotepc:
	780	type: boolean
	781	ou:
	782	type: object
	783	properties:
	784	id:
	785	type: integer
	786	format: int32
[de1b6b5]	787	required: [ id, name, inremotepc, ou ]
[3b5daf8]	788	security:
	789	- apikey: []
	790	tags:
	791	- server
	792	- image
	793	/ous/{ouid}/images/{imageid}:
	794	get:
	795	description: Get an `image` object.
	796	parameters:
[213a832]	797	- $ref: "#/parameters/ouParam"
	798	- $ref: "#/parameters/imageParam"
[3b5daf8]	799	responses:
	800	"200":
	801	description: Successful response
	802	schema:
	803	type: object
	804	properties:
	805	id:
	806	description: image id
	807	type: integer
	808	format: int32
	809	name:
	810	description: image name
	811	type: string
	812	description:
	813	description: image description
	814	type: string
[de1b6b5]	815	comments:
	816	description: extra comments
	817	type: string
[3b5daf8]	818	inremotepc:
[df81ab78]	819	description: image usable in Remote PC Project flag
[3b5daf8]	820	type: boolean
[de1b6b5]	821	repo:
	822	description: repository identification
	823	type: object
	824	properties:
	825	id:
	826	type: integer
	827	format: int32
[3b5daf8]	828	type:
	829	description: image type (``monolithic``, ``basic``, ``incremental``)
	830	type: string
[d57fcbc]	831	enum: [ "monolithic", "basic", "incremental" ]
	832	default: "monolithic"
[3b5daf8]	833	baseimg:
	834	description: base image for an incremental image (if ``type`` is ``incremental``)
	835	type: string
	836	client:
	837	description: model client's data
	838	type: object
	839	properties:
	840	id:
	841	description: model client's id.
	842	type: integer
	843	format: int32
	844	disk:
[df81ab78]	845	description: source disk number
[3b5daf8]	846	type: integer
	847	format: int32
	848	partition:
[df81ab78]	849	description: source partition number
[3b5daf8]	850	type: integer
	851	format: int32
[de1b6b5]	852	required: [ id, disk, partition ]
[3b5daf8]	853	creationdate:
	854	description: image creation date
	855	type: string
	856	format: date-time
	857	release:
	858	description: image creation release
	859	type: string
[2154cbb]	860	os:
	861	description: installed operating system
	862	type: string
[de1b6b5]	863	required: [ id, name, description, comments, inremotepc, repo, type ]
[3b5daf8]	864	security:
	865	- apikey: []
	866	tags:
	867	- server
	868	- image
[df81ab78]	869	/ous/{ouid}/images/{imageid}/software:
	870	get:
	871	description: Get software inventory store into an `image`
	872	parameters:
[213a832]	873	- $ref: "#/parameters/ouParam"
	874	- $ref: "#/parameters/imageParam"
[df81ab78]	875	responses:
	876	"200":
	877	description: Successful response
	878	schema:
	879	type: object
	880	properties:
	881	id:
	882	description: image id
	883	type: integer
	884	format: int32
	885	name:
	886	description: image name
	887	type: string
	888	software:
[e7d47882]	889	description: software installed
	890	type: object
	891	properties:
	892	os:
	893	description: operating system
	894	type: string
	895	applications:
	896	type: array
	897	items:
	898	description: list of applications (name and version)
[df81ab78]	899	type: string
[e7d47882]	900	required: [ id, name, software ]
[8b8e948]	901	security:
	902	- apikey: []
	903	tags:
	904	- server
	905	- image
[7766e7a]	906	/ous/{ouid}/images/{imageid}/reserve:
[9a39c75]	907	post:
[7766e7a]	908	description: \|
	909	Reserve a random client with an installed image and send a boot/reboot operation.
	910	If `labid` is specified, then choose a `client` defined in this lab.
	911	parameters:
[213a832]	912	- $ref: "#/parameters/ouParam"
	913	- $ref: "#/parameters/imageParam"
[d8b6c70]	914	- in: body
	915	name: data
	916	description: Operation data
[7766e7a]	917	schema:
	918	type: object
	919	properties:
[d8b6c70]	920	labid:
	921	description: lab id filter (optional)
[7766e7a]	922	type: integer
	923	format: int32
[d8b6c70]	924	minimum: 1
	925	maxtime:
	926	description: maximum reservation time, in h. (optional, 24 h. by default)
	927	type: integer
	928	format: int32
	929	minimum: 1
	930	default: 24
	931	responses:
	932	"200":
	933	description: Reserve a client to boot using an operating system image.
	934	schema:
	935	$ref: "#/definitions/SelectedClientModel"
[7766e7a]	936	security:
	937	- apikey: []
	938	tags:
	939	- server
	940	- image
[0126b05]	941	- remotepc
[90e3284]	942	/repository/images:
[de1b6b5]	943	get:
	944	description: Get information about images stored in a repository
	945	responses:
	946	"200":
	947	description: Successful response
	948	schema:
	949	type: object
	950	properties:
	951	disk:
	952	description: repository disk information
	953	type: object
	954	properties:
	955	total:
	956	description: total disk space
	957	type: string
	958	used:
	959	description: disk space used by files
	960	type: string
	961	free:
	962	description: amount of free disk space
	963	type: string
	964	percent:
	965	description: percentage of used space
	966	type: string
	967	required: [ total, used, free, percent ]
	968	images:
	969	description: information about stored images
	970	type: object
	971	properties:
	972	file:
	973	description: image file information
	974	type: object
	975	properties:
	976	name:
	977	description: file name
	978	type: string
	979	size:
	980	description: file size (bytes)
	981	type: integer
	982	format: int64
	983	modified:
	984	description: file modification date
	985	type: string
[90e3284]	986	format: date-time
[de1b6b5]	987	permissions:
	988	description: file permissions
	989	type: string
	990	required: [ name, size, modified, permissions ]
	991	required: [ disk, images ]
	992	security:
	993	- apikey: []
	994	tags:
	995	- repository
	996	- image
[3b5daf8]	997	#/repository/poweron
[72d3783]	998	/ogagent/started:
	999	post:
	1000	description: Process push notification when OGAgent is started
	1001	parameters:
	1002	- in: body
	1003	name: data
	1004	description: Operation data
	1005	required: true
	1006	schema:
	1007	type: object
	1008	properties:
	1009	ip:
	1010	type: string
	1011	mac:
	1012	type: string
	1013	ostype:
	1014	type: string
	1015	osversion:
	1016	type: string
	1017	secret:
	1018	type: string
	1019	responses:
	1020	"200":
	1021	description: Successful operation
	1022	"400":
	1023	description: An error has occurred
	1024	tags:
	1025	- server
	1026	- agent
	1027	/ogagent/stopped:
	1028	post:
	1029	description: Process push notification when OGAgent is stopped
	1030	parameters:
	1031	- in: body
	1032	name: data
	1033	description: Operation data
	1034	required: true
	1035	schema:
	1036	type: object
	1037	properties:
	1038	ip:
	1039	type: string
	1040	mac:
	1041	type: string
	1042	ostype:
	1043	type: string
	1044	osversion:
	1045	type: string
	1046	responses:
	1047	"200":
	1048	description: Successful operation
	1049	"400":
	1050	description: An error has occurred
	1051	tags:
	1052	- server
	1053	- agent
	1054	/ogagent/loggedin:
	1055	post:
	1056	description: Process push notification when an user logged in
	1057	parameters:
	1058	- in: body
	1059	name: data
	1060	description: Operation data
	1061	required: true
	1062	schema:
	1063	type: object
	1064	properties:
	1065	ip:
	1066	type: string
	1067	user:
	1068	type: string
	1069	responses:
	1070	"200":
	1071	description: Successful operation
	1072	"400":
	1073	description: An error has occurred
	1074	tags:
	1075	- server
	1076	- agent
	1077	/ogagent/loggedout:
	1078	post:
	1079	description: Process push notification when an user is logged in
	1080	parameters:
	1081	- in: body
	1082	name: data
	1083	description: Operation data
	1084	required: true
	1085	schema:
	1086	type: object
	1087	properties:
	1088	ip:
	1089	type: string
	1090	user:
	1091	type: string
	1092	responses:
	1093	"200":
	1094	description: Successful operation
	1095	"400":
	1096	description: An error has occurred
	1097	tags:
	1098	- server
	1099	- agent
[213a832]	1100	parameters:
	1101	ouParam:
	1102	name: ouid
	1103	in: path
	1104	description: OU identificator
	1105	required: true
	1106	type: integer
[d8b6c70]	1107	minimum: 1
[213a832]	1108	labParam:
	1109	name: labid
	1110	in: path
	1111	description: Lab identificator
	1112	required: true
	1113	type: integer
[d8b6c70]	1114	minimum: 1
[213a832]	1115	clientParam:
	1116	name: clientid
	1117	in: path
	1118	description: Client identificator
	1119	required: true
	1120	type: integer
[d8b6c70]	1121	minimum: 1
[213a832]	1122	repoParam:
	1123	name: repoid
	1124	in: path
	1125	description: repository identificator
	1126	required: true
	1127	type: integer
[d8b6c70]	1128	minimum: 1
[213a832]	1129	imageParam:
	1130	name: imageid
	1131	in: path
	1132	description: image definition identificator
	1133	required: true
	1134	type: integer
[d8b6c70]	1135	minimum: 1
[213a832]	1136	definitions:
	1137	StatusModel:
	1138	type: object
	1139	properties:
	1140	id:
	1141	description: client id
	1142	type: integer
	1143	format: int32
[d8b6c70]	1144	minimum: 1
[213a832]	1145	ip:
	1146	description: client IP address
	1147	type: string
	1148	status:
	1149	description: execution status
	1150	type: string
[d57fcbc]	1151	enum: [ "off", "oglive", "busy", "linux", "windows", "macos", "unknown" ]
[213a832]	1152	loggedin:
	1153	description: flag to check if an user is logged in
	1154	type: boolean
	1155	required: [ id, ip, status ]
[d8b6c70]	1156	SelectedClientModel:
	1157	type: object
	1158	properties:
	1159	id:
	1160	description: client id
	1161	type: integer
	1162	format: int32
	1163	minimum: 1
	1164	name:
	1165	description: client name
	1166	type: string
	1167	mac:
	1168	description: client MAC address
	1169	type: string
	1170	ip:
	1171	description: client IP address
	1172	type: string
	1173	lab:
	1174	description: client's lab
	1175	type: object
	1176	properties:
	1177	id:
	1178	description: lab id
	1179	type: integer
	1180	format: int32
	1181	minimum: 1
	1182	required: [ id ]
	1183	ou:
	1184	description: client's OU
	1185	type: object
	1186	properties:
	1187	id:
	1188	description: OU id
	1189	type: integer
	1190	format: int32
	1191	minimum: 1
	1192	required: [ id ]
	1193	required: [ id, name, mac, ip, lab, ou ]

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: admin/WebConsole/rest/opengnsys-api.yml @ 21e2ab8

Download in other formats: