Status

List

get

Retrieves a list of AVD Host Pools status information.

Query parameters

SiteIdinteger · int32Optional

The site ID for which to retrieve all the AVD Host Pool status information (optional)

NamestringOptional

Filter the result by host pool name (optional)

Responses

200

Success

application/json; api-version=1.0

AVD Host Pool Status

idstring · nullableOptional

ID of RAS Agent.

siteIdinteger · int32Optional

ID of Site.

serverTypestring · enumOptional

RAS Status Type

Possible values:

namestring · nullableOptional

AVD Host Pool name.

agentStatestring · enumOptional

Agent State

Possible values:

brokenReasonstring · enumOptional

AVD Broken Reason

Possible values:

400

Bad Request

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

get

/api/AVD/HostPool/status

HTTPcURLJavaScriptPython

GET /api/AVD/HostPool/status HTTP/1.1
Accept: */*

[
  {
    "id": "text",
    "siteId": 1,
    "serverType": [
      "1 = RDSHost",
      "2 = Provider",
      "3 = Gateway",
      "4 = Guest",
      "7 = Broker",
      "9 = Site",
      "10 = VDIHostPool",
      "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"
    ],
    "name": "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",
      "65 = RestrictedAddress",
      "66 = JoiningToHostPool",
      "67 = AutoUpgradeInProgress",
      "68 = AutoUpgradeInitiated",
      "69 = ReplicaMigrationInProgress",
      "70 = InvalidRegistrationCertificate",
      "1006 = AzureStateInstallGuestAgent",
      "-8 = AutoUpgradeLimitReached",
      "-7 = AutoUpgradeFailed",
      "-6 = Unknown",
      "-5 = NeedsUpdate",
      "-4 = NotVerified",
      "-3 = ServerDeleted",
      "-2 = DisabledFromSettings",
      "-1 = Disconnected"
    ],
    "brokenReason": [
      "0 = MissingObj",
      "1 = InvalidTags",
      "2 = MissingDAGObj",
      "3 = InvalidDAGTags",
      "4 = MissingDAGRoles",
      "5 = MissingDAGWorkspaceLink",
      "6 = HostpoolAutomaticAssignment",
      "7 = MissingRAGObj",
      "8 = InvalidRAGTags",
      "9 = MissingRAGRoles",
      "10 = MissingRAGWorkspaceLink",
      "11 = MissingRAGRemoteApp",
      "12 = MissingObjectID",
      "-1 = Ignore"
    ]
  }
]

Get

get

Retrieve the AVD Host Pool status information.

Path parameters

idinteger · int32Required

AVD Host Pool ID

Responses

200

Success

application/json; api-version=1.0

AVD Host Pool Status

idstring · nullableOptional

ID of RAS Agent.

siteIdinteger · int32Optional

ID of Site.

serverTypestring · enumOptional

RAS Status Type

Possible values:

namestring · nullableOptional

AVD Host Pool name.

agentStatestring · enumOptional

Agent State

Possible values:

brokenReasonstring · enumOptional

AVD Broken Reason

Possible values:

400

Bad Request

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

get

/api/AVD/HostPool/{id}/status

HTTPcURLJavaScriptPython

GET /api/AVD/HostPool/{id}/status HTTP/1.1
Accept: */*

{
  "id": "text",
  "siteId": 1,
  "serverType": [
    "1 = RDSHost",
    "2 = Provider",
    "3 = Gateway",
    "4 = Guest",
    "7 = Broker",
    "9 = Site",
    "10 = VDIHostPool",
    "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"
  ],
  "name": "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",
    "65 = RestrictedAddress",
    "66 = JoiningToHostPool",
    "67 = AutoUpgradeInProgress",
    "68 = AutoUpgradeInitiated",
    "69 = ReplicaMigrationInProgress",
    "70 = InvalidRegistrationCertificate",
    "1006 = AzureStateInstallGuestAgent",
    "-8 = AutoUpgradeLimitReached",
    "-7 = AutoUpgradeFailed",
    "-6 = Unknown",
    "-5 = NeedsUpdate",
    "-4 = NotVerified",
    "-3 = ServerDeleted",
    "-2 = DisabledFromSettings",
    "-1 = Disconnected"
  ],
  "brokenReason": [
    "0 = MissingObj",
    "1 = InvalidTags",
    "2 = MissingDAGObj",
    "3 = InvalidDAGTags",
    "4 = MissingDAGRoles",
    "5 = MissingDAGWorkspaceLink",
    "6 = HostpoolAutomaticAssignment",
    "7 = MissingRAGObj",
    "8 = InvalidRAGTags",
    "9 = MissingRAGRoles",
    "10 = MissingRAGWorkspaceLink",
    "11 = MissingRAGRemoteApp",
    "12 = MissingObjectID",
    "-1 = Ignore"
  ]
}