Enrollment Servers

List

Retrieve information about one or multiple Enrollment servers.

GET/api/EnrollmentServer

Query parameters

Response

200401404

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

servernullable string

Server name.

enabledboolean

Whether the server is enabled or not.

descriptionnullable string

Description of the server.

siteIdinteger (int32)

ID of the site.

preferredBrokerIdinteger (int32)

ID of the preferred Connection Broker.

Request

JavaScriptCurlPython

const response = await fetch('/api/EnrollmentServer', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

[
  {
    "id": 0,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2024-12-21T13:47:06.108Z",
    "timeLastMod": "2024-12-21T13:47:06.108Z",
    "server": "text",
    "enabled": false,
    "description": "text",
    "siteId": 0,
    "preferredBrokerId": 0
  }
]

Create

Create a new Enrollment server.

POST/api/EnrollmentServer

Query parameters

Body

application/json; api-version=1.0

Enrollment server settings

enabledboolean

Enable or disable the enrollment server upon creation. If the parameter is omitted, the enrollment server is initialised as disabled.

descriptionnullable string

The enrollment server description.

Response

201401409

Created

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

servernullable string

Server name.

enabledboolean

Whether the server is enabled or not.

descriptionnullable string

Description of the server.

siteIdinteger (int32)

ID of the site.

preferredBrokerIdinteger (int32)

ID of the preferred Connection Broker.

Request

JavaScriptCurlPython

const response = await fetch('/api/EnrollmentServer', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201401409

{
  "id": 0,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2024-12-21T13:47:06.108Z",
  "timeLastMod": "2024-12-21T13:47:06.108Z",
  "server": "text",
  "enabled": false,
  "description": "text",
  "siteId": 0,
  "preferredBrokerId": 0
}

Get

Retrieve information about one Enrollment server by ID.

GET/api/EnrollmentServer/{id}

Path parameters

id*integer (int32)

The ID of an Enrollment server for which to retrieve the information.

Response

200401404

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

servernullable string

Server name.

enabledboolean

Whether the server is enabled or not.

descriptionnullable string

Description of the server.

siteIdinteger (int32)

ID of the site.

preferredBrokerIdinteger (int32)

ID of the preferred Connection Broker.

Request

JavaScriptCurlPython

const response = await fetch('/api/EnrollmentServer/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "id": 0,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2024-12-21T13:47:06.108Z",
  "timeLastMod": "2024-12-21T13:47:06.108Z",
  "server": "text",
  "enabled": false,
  "description": "text",
  "siteId": 0,
  "preferredBrokerId": 0
}

Update

Modify properties of an Enrollment server.

PUT/api/EnrollmentServer/{id}

Path parameters

id*integer (int32)

The ID from which to retrieve Enrollment server information. This must be the actual server name used in the RAS farm.

Body

application/json; api-version=1.0

Enrollment server settings

servernullable string

The new server of the target enrollment server.

descriptionnullable string

The enrollment server description.

enablednullable boolean

Enable or disable the specified enrollment server in a site.

preferredBrokerIdnullable integer (int32)

ID of the preferred Connection Broker.

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/EnrollmentServer/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "status": 0,
  "detail": "text",
  "instance": "text"
}

Delete

Remove an Enrollment server from a site.

DELETE/api/EnrollmentServer/{id}

Path parameters

id*integer (int32)

The ID of an Enrollment server for which to retrieve the information.

Query parameters

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/EnrollmentServer/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "status": 0,
  "detail": "text",
  "instance": "text"
}