ipmi

Manage IPMI interfaces.

get /ipmi

Show all IPMI devices

Parameters

pagination object query
Pagination request. When supplied, the result will be filtered, sorted and limited according to this request object.

Responses

default response
default response
oneOf A response that can be either paginated or a raw list (depending on the presence of the pagination query parameter).
object
A paginated result.

Examples

No request body required
post /ipmi/add

Add an IPMI device that is not managed by croit's DHCP server

Parameters

body object
Request to add an IPMI device that is not managed by croit's DHCP server

Examples

Request Body

{
  "ip": "string",
  "access": {
    "password": "string",
    "username": "string",
    "keepAdminPassword": true
  }
}
delete /ipmi/{id}

Remove an IPMI device, it will be re-detected if it still exists

Parameters

id integer path Required

Examples

No request body required
get /ipmi/config

Get the global IPMI configuration

Responses

default response
default response
object

Examples

No request body required
patch /ipmi/config

Set the global IPMI configuration

Parameters

body object

Responses

default response
default response
object
A long-running task that goes on in the background after this task is completed. See tasks endpoints for details

Examples

Request Body

{
  "password": "string"
}
get /ipmi/poll-state

Poll the state of the given IPMI devices.

Parameters

id array query
Array of integer items

Responses

default response
default response
object

Examples

No request body required
post /ipmi/{id}/identify

Turns on the identify LED for 5 minutes.

Parameters

id integer path Required

Examples

No request body required
post /ipmi/{id}/power-on

Boots a server.

Parameters

id integer path Required

Examples

No request body required
post /ipmi/{id}/power-off

Shutdown a server.

Parameters

id integer path Required

Examples

No request body required
post /ipmi/{id}/initialize

Initialize an IPMI device to be used with croit.

Sets boot device to PXE, and turns on power and optionally configures the ADMIN password to the default croit password.

Parameters

id integer path Required
body object
Access details for an IPMI device

Responses

default response
default response
object
A long-running task that goes on in the background after this task is completed. See tasks endpoints for details

Examples

Request Body

{
  "password": "string",
  "username": "string",
  "keepAdminPassword": true
}
post /ipmi/{id}/power-cycle

Reboots a server.

Parameters

id integer path Required

Examples

No request body required
post /ipmi/{id}/reboot-to-bios

Reboots a server and opens the BIOS setup menu.

Parameters

id integer path Required

Examples

No request body required
post /ipmi/{id}/ipmi-controller-reset

Reboots the IPMI management controller itself.

Parameters

id integer path Required

Examples

No request body required