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