Status

List

Retrieve status of one or multiple Enrollment servers.

GET/api/EnrollmentServer/Status

Query parameters

SiteIdinteger (int32)

Site ID from which to retrieve the Enrollment server (optional).

Serverstring

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

Response

Success

Body

idnullable string

ID of RAS Agent.

siteIdinteger (int32)

ID of Site.

agentStateAgentState (enum)

Agent State

0 = OK,1 = EnumSessionsFailed,2 = RDSRoleDisabled,3 = MaxNonCompletedSessions,4 = RASScheduleInProgress,5 = ConnectionFailed,6 = InvalidCredentials,7 = NeedsSysprep,8 = SysPrepInProgress,9 = CloningFailed,10 = Synchronising,13 = LogonDrainUntilRestart,14 = LogonDrain,15 = LogonDisabled,16 = ForcedDisconnect,17 = CloningCanceled,18 = RASprepInProgress,20 = InstallingRDSRole,21 = RebootPending,22 = PortMismatch,23 = NeedsDowngrade,24 = NotApplied,25 = CloningInProgress,26 = MarkedForDeletion,27 = StandBy,28 = UnsupportedVDIType,29 = FreeESXLicenseNotSupported,30 = ManagedESXNotSupported,32 = InvalidHostVersion,33 = NotJoined,35 = LicenseExpired,36 = JoinBroken,37 = InUse,38 = NotInUse,39 = Unsupported,40 = NoAvailableGateways,41 = EnrollServerNotInitialized,42 = EnrollmentUnavailable,43 = InvalidCAConfig,44 = InvalidEAUserCredentials,45 = InvalidESSettings,46 = FSLogixNotAvail,47 = NoDevices,48 = NeedsAttention,49 = ImageOptimizationPending,50 = ImageOptimization,51 = Unavailable,52 = UnderConstruction,53 = Broken,54 = NonRAS,55 = Provisioning,56 = Invalid,57 = FSLogixNeedsUpdate,58 = NoMembersAvailable,59 = MembersNeedUpdate,60 = FailedPerfCounters,61 = PendingRecreation,62 = RemovingMembers,63 = AddingMembers,64 = DeleteInProgress,66 = JoiningToHostPool,67 = AutoUpgradeInProgress,68 = AutoUpgradeInitiated,-8 = AutoUpgradeLimitReached,-7 = AutoUpgradeFailed,-6 = Unknown,-5 = NeedsUpdate,-4 = NotVerified,-3 = ServerDeleted,-2 = DisabledFromSettings,-1 = Disconnected

serverTypeRASServerType (enum)

RAS Status Type

1 = RDSHost,2 = Provider,3 = Gateway,4 = Guest,7 = PA,9 = Site,16 = RDSGroup,25 = HALBDevice,45 = TenantBroker,46 = Enrollment,51 = HALB,64 = AVDWorkspace,65 = AVDHostPool,66 = AVDTemplate,67 = AVDHost,95 = VDITemplateVersion,96 = AVDTemplateVersion,97 = RDSTemplateVersion,107 = RDSTemplate,108 = VDITemplate,2013 = VDIHost,-1 = All

agentVernullable string

Agent Version.

servernullable string

Server name.

serverOSnullable string

Server Operating System.

serviceStartTimenullable string

Service start time.

systemBootTimenullable string

System boot time.

unhandledExceptionsinteger (int32)

Number of unhandled exceptions.

machineIdnullable string

Id of the machine

logLevelRASLogLevel (enum)

RAS Log Level

0 = Critical,1 = Error,2 = Warning,3 = Standard,4 = Extended,5 = Verbose,-1 = None

cpuLoadinteger (int32)

CPU load percentage.

memLoadinteger (int32)

Memory load percentage.

diskReadinteger (int32)

Disk Read.

diskWriteinteger (int32)

Disk Write.

enabledboolean

Whether the object is enabled or not.

Request

Response

Get

Retrieve status of an Enrollment server by ID.

GET/api/EnrollmentServer/{id}/Status

Path parameters

id*integer (int32)

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

Response

Success

Body

idnullable string

ID of RAS Agent.

siteIdinteger (int32)

ID of Site.

agentStateAgentState (enum)

Agent State

serverTypeRASServerType (enum)

RAS Status Type

agentVernullable string

Agent Version.

servernullable string

Server name.

serverOSnullable string

Server Operating System.

serviceStartTimenullable string

Service start time.

systemBootTimenullable string

System boot time.

unhandledExceptionsinteger (int32)

Number of unhandled exceptions.

machineIdnullable string

Id of the machine

logLevelRASLogLevel (enum)

RAS Log Level

0 = Critical,1 = Error,2 = Warning,3 = Standard,4 = Extended,5 = Verbose,-1 = None

cpuLoadinteger (int32)

CPU load percentage.

memLoadinteger (int32)

Memory load percentage.

diskReadinteger (int32)

Disk Read.

diskWriteinteger (int32)

Disk Write.

enabledboolean

Whether the object is enabled or not.

Request

Response

Enrollment Servers

List

Retrieve information about one or multiple Enrollment servers.

GET/api/EnrollmentServer

Query parameters

SiteIdinteger (int32)

Site ID from which to retrieve the Enrollment server (optional).

Serverstring

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

Response

Success

Body

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

Response

Create

Create a new Enrollment server.

POST/api/EnrollmentServer

Query parameters

noInstallboolean

Set it to true if Enrollment server should be initialized after being added. (optional)

usernamestring

An administrator account for push installing the Enrollment server. If this parameter is omitted, your RAS admin username (and password) will be used.

passwordstring

The password of the account specified in the Username parameter.

noFireWallRulesboolean

Specifies not to add firewall rules to allow the Enrollment server to communicate. If this parameter is omitted, the firewall rules will not be added.

Body

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

Created

Body

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

Response

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

Success

Body

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

Response

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

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

No Content

Request

Response

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

noUninstallboolean

If this parameter is included, the Enrollment server agent will not be uninstalled from the server. To uninstall the agent, omit this parameter. When uninstalling the agent, your RAS admin credentials will be used by default. You can specify different credentials if needed using the Username and Password parameters.

usernamestring

An administrator account to remotely uninstall the Enrollment server agent from the server. If this parameter is omitted, your RAS admin username (and password) will be used by default.

passwordstring

The password of the account specified in the Username parameter.

Response

No Content

Request

Response

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

noUninstallboolean

usernamestring

An administrator account to remotely uninstall the Enrollment server agent from the server. If this parameter is omitted, your RAS admin username (and password) will be used by default.

passwordstring

The password of the account specified in the Username parameter.

Response

No Content

Request

Response

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

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

No Content

Request

Response

List

Retrieve information about one or multiple Enrollment servers.

GET/api/EnrollmentServer

Query parameters

SiteIdinteger (int32)

Site ID from which to retrieve the Enrollment server (optional).

Serverstring

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

Response

Success

Body

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

Response

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

Success

Body

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

Response

Create

Create a new Enrollment server.

POST/api/EnrollmentServer

Query parameters

noInstallboolean

Set it to true if Enrollment server should be initialized after being added. (optional)

usernamestring

An administrator account for push installing the Enrollment server. If this parameter is omitted, your RAS admin username (and password) will be used.

passwordstring

The password of the account specified in the Username parameter.

noFireWallRulesboolean

Specifies not to add firewall rules to allow the Enrollment server to communicate. If this parameter is omitted, the firewall rules will not be added.

Body

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

Created

Body

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

Response

List

Retrieve status of one or multiple Enrollment servers.

GET/api/EnrollmentServer/Status

Query parameters

SiteIdinteger (int32)

Site ID from which to retrieve the Enrollment server (optional).

Serverstring

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

Response

Success

Body

idnullable string

ID of RAS Agent.

siteIdinteger (int32)

ID of Site.

agentStateAgentState (enum)

Agent State

serverTypeRASServerType (enum)

RAS Status Type

agentVernullable string

Agent Version.

servernullable string

Server name.

serverOSnullable string

Server Operating System.

serviceStartTimenullable string

Service start time.

systemBootTimenullable string

System boot time.

unhandledExceptionsinteger (int32)

Number of unhandled exceptions.

machineIdnullable string

Id of the machine

logLevelRASLogLevel (enum)

RAS Log Level

0 = Critical,1 = Error,2 = Warning,3 = Standard,4 = Extended,5 = Verbose,-1 = None

cpuLoadinteger (int32)

CPU load percentage.

memLoadinteger (int32)

Memory load percentage.

diskReadinteger (int32)

Disk Read.

diskWriteinteger (int32)

Disk Write.

enabledboolean

Whether the object is enabled or not.

Request

Response

Get

Retrieve status of an Enrollment server by ID.

GET/api/EnrollmentServer/{id}/Status

Path parameters

id*integer (int32)

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

Response

Success

Body

idnullable string

ID of RAS Agent.

siteIdinteger (int32)

ID of Site.

agentStateAgentState (enum)

Agent State

serverTypeRASServerType (enum)

RAS Status Type

agentVernullable string

Agent Version.

servernullable string

Server name.

serverOSnullable string

Server Operating System.

serviceStartTimenullable string

Service start time.

systemBootTimenullable string

System boot time.

unhandledExceptionsinteger (int32)

Number of unhandled exceptions.

machineIdnullable string

Id of the machine

logLevelRASLogLevel (enum)

RAS Log Level

0 = Critical,1 = Error,2 = Warning,3 = Standard,4 = Extended,5 = Verbose,-1 = None

cpuLoadinteger (int32)

CPU load percentage.

memLoadinteger (int32)

Memory load percentage.

diskReadinteger (int32)

Disk Read.

diskWriteinteger (int32)

Disk Write.

enabledboolean

Whether the object is enabled or not.

Request

Response

[
  {
    "id": "text",
    "agentState": [
      "0 = OK",
      "1 = EnumSessionsFailed",
      "2 = RDSRoleDisabled",
      "3 = MaxNonCompletedSessions",
      "4 = RASScheduleInProgress",
      "5 = ConnectionFailed",
      "6 = InvalidCredentials",
      "7 = NeedsSysprep",
      "8 = SysPrepInProgress",
      "9 = CloningFailed",
      "10 = Synchronising",
      "13 = LogonDrainUntilRestart",
      "14 = LogonDrain",
      "15 = LogonDisabled",
      "16 = ForcedDisconnect",
      "17 = CloningCanceled",
      "18 = RASprepInProgress",
      "20 = InstallingRDSRole",
      "21 = RebootPending",
      "22 = PortMismatch",
      "23 = NeedsDowngrade",
      "24 = NotApplied",
      "25 = CloningInProgress",
      "26 = MarkedForDeletion",
      "27 = StandBy",
      "28 = UnsupportedVDIType",
      "29 = FreeESXLicenseNotSupported",
      "30 = ManagedESXNotSupported",
      "32 = InvalidHostVersion",
      "33 = NotJoined",
      "35 = LicenseExpired",
      "36 = JoinBroken",
      "37 = InUse",
      "38 = NotInUse",
      "39 = Unsupported",
      "40 = NoAvailableGateways",
      "41 = EnrollServerNotInitialized",
      "42 = EnrollmentUnavailable",
      "43 = InvalidCAConfig",
      "44 = InvalidEAUserCredentials",
      "45 = InvalidESSettings",
      "46 = FSLogixNotAvail",
      "47 = NoDevices",
      "48 = NeedsAttention",
      "49 = ImageOptimizationPending",
      "50 = ImageOptimization",
      "51 = Unavailable",
      "52 = UnderConstruction",
      "53 = Broken",
      "54 = NonRAS",
      "55 = Provisioning",
      "56 = Invalid",
      "57 = FSLogixNeedsUpdate",
      "58 = NoMembersAvailable",
      "59 = MembersNeedUpdate",
      "60 = FailedPerfCounters",
      "61 = PendingRecreation",
      "62 = RemovingMembers",
      "63 = AddingMembers",
      "64 = DeleteInProgress",
      "66 = JoiningToHostPool",
      "67 = AutoUpgradeInProgress",
      "68 = AutoUpgradeInitiated",
      "-8 = AutoUpgradeLimitReached",
      "-7 = AutoUpgradeFailed",
      "-6 = Unknown",
      "-5 = NeedsUpdate",
      "-4 = NotVerified",
      "-3 = ServerDeleted",
      "-2 = DisabledFromSettings",
      "-1 = Disconnected"
    ],
    "serverType": [
      "1 = RDSHost",
      "2 = Provider",
      "3 = Gateway",
      "4 = Guest",
      "7 = PA",
      "9 = Site",
      "16 = RDSGroup",
      "25 = HALBDevice",
      "45 = TenantBroker",
      "46 = Enrollment",
      "51 = HALB",
      "64 = AVDWorkspace",
      "65 = AVDHostPool",
      "66 = AVDTemplate",
      "67 = AVDHost",
      "95 = VDITemplateVersion",
      "96 = AVDTemplateVersion",
      "97 = RDSTemplateVersion",
      "107 = RDSTemplate",
      "108 = VDITemplate",
      "2013 = VDIHost",
      "-1 = All"
    ],
    "agentVer": "text",
    "server": "text",
    "serverOS": "text",
    "serviceStartTime": "text",
    "systemBootTime": "text",
    "machineId": "text",
    "logLevel": [
      "0 = Critical",
      "1 = Error",
      "2 = Warning",
      "3 = Standard",
      "4 = Extended",
      "5 = Verbose",
      "-1 = None"
    ],
    "enabled": false
  }
]

{
  "id": "text",
  "agentState": [
    "0 = OK",
    "1 = EnumSessionsFailed",
    "2 = RDSRoleDisabled",
    "3 = MaxNonCompletedSessions",
    "4 = RASScheduleInProgress",
    "5 = ConnectionFailed",
    "6 = InvalidCredentials",
    "7 = NeedsSysprep",
    "8 = SysPrepInProgress",
    "9 = CloningFailed",
    "10 = Synchronising",
    "13 = LogonDrainUntilRestart",
    "14 = LogonDrain",
    "15 = LogonDisabled",
    "16 = ForcedDisconnect",
    "17 = CloningCanceled",
    "18 = RASprepInProgress",
    "20 = InstallingRDSRole",
    "21 = RebootPending",
    "22 = PortMismatch",
    "23 = NeedsDowngrade",
    "24 = NotApplied",
    "25 = CloningInProgress",
    "26 = MarkedForDeletion",
    "27 = StandBy",
    "28 = UnsupportedVDIType",
    "29 = FreeESXLicenseNotSupported",
    "30 = ManagedESXNotSupported",
    "32 = InvalidHostVersion",
    "33 = NotJoined",
    "35 = LicenseExpired",
    "36 = JoinBroken",
    "37 = InUse",
    "38 = NotInUse",
    "39 = Unsupported",
    "40 = NoAvailableGateways",
    "41 = EnrollServerNotInitialized",
    "42 = EnrollmentUnavailable",
    "43 = InvalidCAConfig",
    "44 = InvalidEAUserCredentials",
    "45 = InvalidESSettings",
    "46 = FSLogixNotAvail",
    "47 = NoDevices",
    "48 = NeedsAttention",
    "49 = ImageOptimizationPending",
    "50 = ImageOptimization",
    "51 = Unavailable",
    "52 = UnderConstruction",
    "53 = Broken",
    "54 = NonRAS",
    "55 = Provisioning",
    "56 = Invalid",
    "57 = FSLogixNeedsUpdate",
    "58 = NoMembersAvailable",
    "59 = MembersNeedUpdate",
    "60 = FailedPerfCounters",
    "61 = PendingRecreation",
    "62 = RemovingMembers",
    "63 = AddingMembers",
    "64 = DeleteInProgress",
    "66 = JoiningToHostPool",
    "67 = AutoUpgradeInProgress",
    "68 = AutoUpgradeInitiated",
    "-8 = AutoUpgradeLimitReached",
    "-7 = AutoUpgradeFailed",
    "-6 = Unknown",
    "-5 = NeedsUpdate",
    "-4 = NotVerified",
    "-3 = ServerDeleted",
    "-2 = DisabledFromSettings",
    "-1 = Disconnected"
  ],
  "serverType": [
    "1 = RDSHost",
    "2 = Provider",
    "3 = Gateway",
    "4 = Guest",
    "7 = PA",
    "9 = Site",
    "16 = RDSGroup",
    "25 = HALBDevice",
    "45 = TenantBroker",
    "46 = Enrollment",
    "51 = HALB",
    "64 = AVDWorkspace",
    "65 = AVDHostPool",
    "66 = AVDTemplate",
    "67 = AVDHost",
    "95 = VDITemplateVersion",
    "96 = AVDTemplateVersion",
    "97 = RDSTemplateVersion",
    "107 = RDSTemplate",
    "108 = VDITemplate",
    "2013 = VDIHost",
    "-1 = All"
  ],
  "agentVer": "text",
  "server": "text",
  "serverOS": "text",
  "serviceStartTime": "text",
  "systemBootTime": "text",
  "machineId": "text",
  "logLevel": [
    "0 = Critical",
    "1 = Error",
    "2 = Warning",
    "3 = Standard",
    "4 = Extended",
    "5 = Verbose",
    "-1 = None"
  ],
  "enabled": false
}